Zenovayは2つの異なるエクスポートパスを提供します。これらを区別することが重要です。

あなた自身の個人データ (アカウント所有者): Zenovayがあなた、Zenovayユーザーについて保持するデータのGDPR第20条/第15条に基づいた無料エクスポート。
あなたの分析データ (あなたが追跡しているサイトの訪問者): Zenovayで収集するビジネスデータを、あなたの記録用またはあなた自身のユーザーからのリクエストに応えるためにCSVまたはJSONとしてエクスポート。

この記事は両者をカバーしています。

データポータビリティの理解

GDPR第20条

個人は以下の権利を有します:

個人データを受け取る権利
構造化された、一般的に使用されるフォーマットで
機械読み取り可能なもの (例: JSON)
別のコントローラーに送信する権利

いつ適用されるか

データポータビリティは以下の場合に適用されます:

処理が同意または契約に基づいている
処理が自動化されている
リクエストがデータ主体からのもの

あなた自身の個人データをエクスポート (無料、全プラン)

これはZenovayユーザーとしてあなた自身について保持するデータの第20条ポータビリティ権と第15条アクセス権です (プロフィール、ウェブサイトメタデータ、チームメンバーシップ、あなた自身の監査証跡など)。すべてのプランで無料です。

アカウント設定を開く
アプリで設定 → アカウントに移動します (app.zenovay.com/settings/account)。
エクスポートをリクエスト
データエクスポートセクションで、マイデータをダウンロードをクリックします。
ファイルを保存
Zenovayは個人データを含む構造化JSON ファイルを生成し、ブラウザにダウンロードします。待機キューなし、メール手順なし。

エクスポートは意図的に認証情報 (パスワードハッシュ、MFAシークレット、APIキーハッシュ、OAuthトークン) と他の人のデータを除外しながら、関連する場合はそれらの事実を含みます (例: MFAが有効であるか、特定の日付にGitHubがリンクされている)。また、追跡しているウェブサイトの分析データも除外しており、これは次のセクションで説明するウェブサイトオペレーターのビジネスデータです。

情報

個人データをエクスポートする代わりに修正または削除するには、[email protected]に連絡するか、設定 → アカウント → アカウントを削除を使用してください。

あなたの分析データをエクスポート (Pro以上)

分析エクスポートは、個人のアカウントデータとは別に、収集する訪問者とイベントデータをカバーしています。これはPro、Scale、Enterpriseプランで利用できるデータエクスポート機能の一部です。

APIを使用

外部APIを使用してプログラムで分析データを取得します。APIアクセスには有料プラン (Pro以上) が必要で、キーはzv_で始まります:

# ウェブサイトの訪問者分析データを取得
curl -X GET "https://api.zenovay.com/api/external/v1/analytics/{websiteId}/visitors" \
  -H "X-API-Key: zv_YOUR_API_KEY"

# ページ分析データを取得
curl -X GET "https://api.zenovay.com/api/external/v1/analytics/{websiteId}/pages" \
  -H "X-API-Key: zv_YOUR_API_KEY"

Authorization: Bearer zv_YOUR_API_KEYで認証することもできます。設定 → セキュリティ → APIキーでキーを作成および管理します。

メールでのCSVおよびJSONエクスポート

ウェブサイトの分析をパッケージ化してエクスポートするには、APIを通じてCSVまたはJSONジョブをリクエストします。Zenovayはファイルを生成し、準備ができたらチームオーナーのメールに送信します:

# 1つのウェブサイトのCSVエクスポートをリクエスト
curl -X POST "https://api.zenovay.com/api/team/{teamId}/export/{websiteId}/csv" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "date_from": "2024-01-01", "date_to": "2024-12-31", "aggregation_level": "daily" }'

# 代わりにJSONエクスポートをリクエスト
curl -X POST "https://api.zenovay.com/api/team/{teamId}/export/{websiteId}/json" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "date_from": "2024-01-01", "date_to": "2024-12-31", "aggregation_level": "daily" }'

aggregation_levelはraw、daily、またはmonthlyです。エクスポートはチームオーナーのメールアドレスに配信されます。

エクスポートデータフォーマット

分析エクスポートはJSONまたはCSVで利用可能です。

JSONフォーマット

{
  "website_id": "wb_abc123",
  "date_from": "2024-01-01",
  "date_to": "2024-12-31",
  "pageviews": [
    {
      "timestamp": "2025-01-14T15:30:00Z",
      "url": "/products/widget",
      "title": "Widget Product Page",
      "referrer": "https://google.com",
      "device": "desktop",
      "browser": "Chrome",
      "country": "US"
    }
  ],
  "events": [
    {
      "timestamp": "2025-01-14T15:35:00Z",
      "name": "add_to_cart",
      "properties": {
        "product_id": "SKU-001",
        "price": 99.99
      }
    }
  ]
}

CSVフォーマット

データタイプごとに分離されたファイル:

pageviews.csv:

timestamp,url,title,referrer,device,browser,country
2025-01-14T15:30:00Z,/products/widget,Widget Product Page,https://google.com,desktop,Chrome,US
2025-01-14T15:32:00Z,/checkout,Checkout,/products/widget,desktop,Chrome,US

events.csv:

timestamp,name,property_product_id,property_price,property_quantity
2025-01-14T15:35:00Z,add_to_cart,SKU-001,99.99,1
2025-01-14T15:40:00Z,purchase,SKU-001,99.99,1

スケジュール済みエクスポート

Pro以上では、定期的な分析エクスポートをスケジュールできます。スケジュール済みエクスポートは日次、週次、または月次の周期で実行され、各実行が完了したときにチームオーナーのメールに配信されます。スケジュール済みエクスポートはチームオーナーのみが作成できます。

クラウドストレージへのウェアハウスエクスポート (Scale以上)

ScaleとEnterpriseでは、日次の分析集計をあなた自身のクラウドストレージにルーティングできます。現在のバージョンはAmazon S3 (およびCloudflare R2、Backblaze B2、Wababiなどのs3互換サービス) をサポートしています。BigQueryおよびSnowflakeの宛先は計画中です。

チーム設定または warehouse-export APIで宛先を設定します:

# チーム用のS3宛先を作成
curl -X POST "https://api.zenovay.com/api/team/{teamId}/warehouse-exports" \
  -H "Authorization: Bearer zv_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_type": "s3",
    "destination_config": { "bucket": "your-bucket", "region": "us-east-1", "path": "zenovay-exports/" },
    "credentials": { "access_key_id": "AKIA...", "secret_access_key": "..." }
  }'

提供される認証情報は保存時点で暗号化され、保存後はAPIから返されることはありません。

警告

宛先エンドポイントは公開アクセス可能である必要があります。Cloudflare Workersはlocalhostにアクセスできないため、ローカルS3互換サービスをテストするには、トンネルを介して公開し、公開URLを使用してください。

データ主体リクエストの処理

あなた自身のユーザーの1人があなたにデータをリクエストした場合、ワークフローは:

1. リクエストを受け取る
   └── 身元を確認する

2. エクスポートを生成する
   └── API: GET /api/external/v1/analytics/{websiteId}/visitors
   └── またはウェブサイト用のCSV/JSONジョブをリクエスト

3. データを準備する
   └── リクエストしている個人のレコードをフィルタ

4. データを配信する
   └── あなた自身のチャネルを通じてリクエスターに送信

5. 完了を確認する
   └── あなた自身のコンプライアンス記録に記録

Zenovayはあなたのプロセッサーです: あなたは訪問者データのコントローラーであるため、身元確認とデータ主体への配信はあなたの責任です。

セキュリティ上の考慮事項

配信

個人データエクスポートはあなたの認証されたブラウザセッションに直接ダウンロードされます。
分析CSV/JSONエクスポートはチームオーナーの確認済みメールに配信されます。
ウェアハウスエクスポートはあなたが所有・管理する宛先に書き込まれます。
すべてのAPIトラフィックはHTTPSのみで、有効なAPIキーが必要です。

保存中の暗号化

提供するウェアハウスエクスポート認証情報 (例: S3アクセスキー) は保存時点で暗号化され、保存後はAPIから返されることはありません。
アカウントに関連するIPアドレスは単方向で日次ソルト付きSHA-256ハッシュとして保存され、逆転できません。ハッシュ自体は個人データエクスポートに含まれていません。

ベストプラクティス

エクスポート前の確認

あなた自身のユーザーの1人からのリクエストを満たすときは、常に身元を確認してください:

確認メールを送信
既知の連絡方法で確認
確認を文書化

すべてを文書化

以下の記録を保持してください:

リクエスト受け取り日
実施した確認
生成されたエクスポート
配信されたデータ
ユーザーが受け取りを確認

タイムリーな回答

GDPRは30日以内の対応を要求します:

内部トラッキングを設定
近づいている期限をエスカレート
必要に応じて延長 (リクエスターに通知)

トラブルシューティング

個人エクスポートがダウンロードされませんでした

サインインしており、設定 → アカウントにアクセスしていることを確認してください。
エクスポートはユーザーあたり1時間あたり数個のリクエストに制限されています。数分待ってからもう一度試してください。

分析エクスポートメールが到着しませんでした

スケジュール済みおよびオンデマンド分析エクスポートはチームオーナーのメールに送信されます。そのアドレスが正しいことを確認し、スパムをチェックしてください。
非常に大きなエクスポートの生成には時間がかかります。より狭い日付範囲を試してください。

データの欠落

分析エクスポートが不完全な場合:

日付範囲を確認
データがまだ削除されていないことを確認
プランのデータ保持ウィンドウを確認

ユーザー向けデータエクスポート