Segmentデータを CSV にエクスポート
このページでは、Segmentからユーザーデータの CSV エクスポートをリクエストする方法と、エクスポートに含まれるデータについて説明します。
Segmentデータを CSV にエクスポートするには、Segmentの編集中にUser Dataドロップダウンを選択し、そのSegmentのユーザーデータまたはメールアドレスのいずれかをエクスポートするように選択します。
メインのSegmentsページから、SegmentのSettingsドロップダウンを選択して、CSV エクスポートをリクエストすることもできます。
すべてのユーザープロファイルからデータをエクスポートするには、フィルターなしでSegmentを作成し、CSV エクスポートをリクエストしてください。
CSV 出力には、エクスポート時にSegmentに含まれる各ユーザープロファイルのデータが含まれます。歯車アイコンを選択して CSV エクスポートを選択することで、任意のSegmentをエクスポートできます。Brazeはバックグラウンドでレポートを生成し、現在ログインしているユーザーにメールで送信します。
ファイルサイズの制限により、Segmentの推定サイズがユーザー数500,000人を超える場合、エクスポートに失敗する可能性があります。この制限は、Segmentの正確な計算ではなく推定サイズを使用することに注意してください。詳しくは、大きなSegmentのエクスポートを参照してください。
Amazon S3 の認証情報をBrazeにリンクしている場合、CSV は代わりに S3 バケットのキーsegment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zipの下にアップロードされます。メールで届くダウンロードリンクにアクセスするには、ダッシュボードにログインしている必要があります。
S3バケットに保存されたエクスポートファイルは、ダウンロードリンクの有効期限が切れた後（特に記載がない限り、エクスポートメール送信から4時間後）、自動的に削除されます。
エクスポートに含まれるデータ
以下のデータが、選択に応じてエクスポートに含まれます。
ユーザーデータを CSV 形式でエクスポート
| フィールド名 | 説明 |
|---|---|
| Appboy ID | 内部 ID（変更不可） |
| country | 国 |
| created_at | ユーザープロファイルが作成された日時 |
| created_from | ユーザープロファイルの作成に使用された方法（例：REST API、SDK、CSV インポート） |
| devices | デバイス情報 |
| date_of_birth | 生年月日 |
| メールアドレス | |
| unsubscribed_from_emails_at | メールの配信停止日 |
| user_id | external ID |
| first_name | 名 |
| first_session | 初回セッションの日時 |
| gender | 性別 |
| google_ad_ids | ユーザーに関連付けられた Google 広告 ID |
| city | 市区町村 |
| IDFAs | 広告用識別子（IDFA）の値 |
| IDFVs | ベンダー識別子（IDFV）の値 |
| language | ISO-639-1 規格の言語 |
| last_app_version_used | 最後に使用したアプリのバージョン |
| last_name | 姓 |
| last_session | 最終セッションの日時 |
| number_of_google_ad_ids | 関連する Google 広告 ID の数 |
| number_of_IDFAs | 関連する IDFA の数 |
| number_of_IDFVs | 関連する IDFV の数 |
| number_of_push_tokens | 関連するプッシュ通知トークンの数 |
| number_of_roku_ad_ids | 関連する Roku 広告 ID の数 |
| number_of_windows_ad_ids | 関連する Windows 広告 ID の数 |
| phone_number | 電話番号 |
| opted_into_push_at | プッシュ通知にオプトインした日付 |
| unsubscribed_from_push_at | プッシュ通知の配信停止日 |
| random_bucket | ランダムバケット番号 |
| roku_ad_ids | Roku 広告 ID |
| session_count | セッションの総数 |
| timezone | IANA タイムゾーンデータベースと同じフォーマットによるユーザーのタイムゾーン |
| in_app_purchase_total | アプリ内購入の支出総額 |
| user_aliases | ユーザーエイリアスがある場合 |
| windows_ad_ids | Windows 広告 ID |
| カスタムイベント | エクスポート時の選択に基づく |
| カスタム属性 | エクスポート時の選択に基づく |
キャンバスステップからユーザーデータをエクスポートすると、CSV にはそのキャンバスステップの全期間にわたってそのステップに含まれたすべてのユーザーが含まれます。エクスポートを日付範囲やその他の時間枠に制限することはできません。これらのエクスポートの実行方法については、Canvasデータのエクスポートを参照してください。
メールアドレスを CSV 形式でエクスポート
| フィールド名 | 説明 |
|---|---|
| user_id | ユーザーの external ID |
| first_name | 名 |
| last_name | 姓 |
| メール | |
| unsubscribed_from_emails_at | メール配信停止日 |
| opted_in_to_emails_at | メールオプトイン日 |
| user_aliases | ユーザーエイリアスがある場合 |
大きなSegmentのエクスポート
500,000人を超えるユーザーを含む大規模なユーザーSegmentをエクスポートするには、いくつかの方法があります。
大きなSegmentを小さなSegmentに分割し、それぞれの小さなSegmentをBrazeからエクスポートできます。
また、ランダムバケット番号を使用して、ユーザー群を複数のSegmentに分割し、エクスポート後にそれらを組み合わせることもできます。例えば、Segmentを2つの異なるSegmentに分割する必要がある場合は、次のフィルターを使用できます。
- Segment 1：ランダムバケット番号が5000未満（0～4999を含む）
- Segment 2：ランダムバケット番号が4999より大きい（5000～9999を含む）
また、次のエンドポイントを利用して、特定のSegmentのユーザーデータをエクスポートすることもできます。これらのエンドポイントはデータ制限の対象となりますのでご注意ください。