セグメントデータをCSVにエクスポート
このページでは、セグメントからユーザーデータのCSVエクスポートをリクエストする方法と、エクスポートに含まれるデータについて説明します。
セグメントデータをCSVにエクスポートするには、セグメントの編集中にUser Dataドロップダウンを選択し、そのセグメントのユーザーデータまたはメールアドレスのいずれかをエクスポートするように選択します。
メインのセグメントページから、セグメントの Settingsドロップダウンを選択して、CSVエクスポートをリクエストすることもできます。
すべてのユーザープロファイルからデータをエクスポートするには、フィルターなしでセグメントを作成し、CSVエクスポートをリクエストしてください。
CSV出力には、エクスポート時にセグメントに含まれる各ユーザープロファイルのデータが含まれます。歯車アイコンを選択してCSVエクスポートを選択することで、任意のセグメントをエクスポートできます。Brazeはバックグラウンドでレポートを生成し、現在ログインしているユーザーにメールで送信します。
セグメントCSVエクスポートの詳細
ダッシュボードユーザーがCSVエクスポートオプションを使用するには、ユーザーデータのエクスポート権限が必要です。この権限がない場合、CSVエクスポートオプションは表示されません。
メールアドレスのCSVエクスポートには、セグメント内でメールアドレスを持つユーザーの行のみが含まれます。たとえば、セグメントに100,000人のユーザーがいても、メールアドレスを持つのが50,000人のみの場合、メールアドレスのCSVエクスポートでは約50,000行が生成されます。ユーザーデータのCSVエクスポートでは、セグメントのすべてのユーザーデータがエクスポートされます。
ファイルサイズの制限により、セグメントの推定サイズが500,000ユーザーを超える場合、エクスポートが失敗することがあります。この制限はセグメントの推定サイズを使用しており、正確な計算ではないことに注意してください。詳細については、大規模セグメントのエクスポートを参照してください。
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 |
| Custom events | エクスポート時の選択に基づく |
| カスタム属性 | エクスポート時の選択に基づく |
キャンバスステップからユーザーデータをエクスポートする場合、CSVにはそのキャンバスステップの全期間にわたってそのステップに含まれたすべてのユーザーが含まれます。日付範囲やその他の時間枠でエクスポートを制限することはできません。これらのエクスポートの実行方法については、キャンバスデータのエクスポートを参照してください。
CSV エクスポートのメールアドレス
| フィールド名 | 説明 |
|---|---|
| user_id | ユーザーのexternal ID |
| first_name | 名 |
| last_name | 姓 |
| メール | |
| unsubscribed_from_emails_at | メールの購読解除日 |
| opted_in_to_emails_at | メールのオプトイン日 |
| user_aliases | ユーザーエイリアス（ある場合） |
購読グループのデータはセグメントのエクスポートでは取得できません。購読ステータスでユーザーを特定するには、購読グループのメンバーシップに基づいて別のセグメントを作成し、そのセグメントをエクスポートしてください。
大規模セグメントのエクスポート
500,000人を超えるユーザーを含む大規模なユーザーセグメントをエクスポートするには、いくつかの方法があります。
大規模なセグメントを小さなセグメントに分割し、それぞれの小さなセグメントをBrazeからエクスポートできます。
ランダムバケット番号を使用してユーザー群を複数のセグメントに分割し、エクスポート後にそれらを結合することもできます。たとえば、セグメントを2つの異なるセグメントに分割する必要がある場合、次のフィルターを使用できます。
- セグメント1: ランダムバケット番号が5000未満（0〜4999を含む）
- セグメント2: ランダムバケット番号が4999より大きい（5000〜9999を含む）
以下のエンドポイントを活用して、特定のセグメントのユーザーデータをエクスポートすることもできます。これらのエンドポイントにはデータ制限とレート制限が適用されることに注意してください。
Amazon S3の認証情報を接続している場合、セグメントCSVエクスポートの詳細に記載されているように、メールのダウンロードリンクに加えて、大規模なエクスポートをバケットに配信できます。