セグメントデータをCSVにエクスポート
このページでは、セグメントからユーザーデータのCSVエクスポートをリクエストする方法と、エクスポートに含まれるデータについて説明します。
前提条件
セグメントデータを CSV にエクスポートするには、ワークスペースの「ユーザーデータのエクスポート」権限が必要です。
CSVエクスポートをリクエストする
セグメントデータをCSVにエクスポートするには、セグメントの編集中にユーザーデータドロップダウンを選択し、セグメントのユーザーデータまたはメールアドレスのいずれかをエクスポートするよう選択します。
メインのセグメントページで、セグメントの 設定ドロップダウンを選択して、CSVエクスポートをリクエストすることもできます。
すべてのユーザープロファイルからデータをエクスポートするには、フィルターなしでセグメントを作成し、CSVエクスポートをリクエストします。
CSV出力には、エクスポート時にセグメントで取得された各ユーザープロファイルのデータが含まれます。歯車アイコンとCSVエクスポートを選択すると、任意のセグメントをエクスポートできます。Brazeはバックグラウンドでレポートを生成し、現在ログインしているユーザーにメールで送信します。
セグメントの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 |
| カスタムイベント | エクスポート時の選択に基づく |
| カスタム属性 | エクスポート時の選択に基づく |
キャンバスステップからユーザーデータをエクスポートすると、CSV にはそのキャンバスステップの存続期間中にそのステップに入ったすべてのユーザーが含まれます。エクスポートを日付範囲やその他の期間に限定することはできません。これらのエクスポートの実行方法については、キャンバスデータのエクスポートを参照してください。
CSV エクスポートのメールアドレス
| フィールド名 | 説明 |
|---|---|
| user_id | ユーザーの external ID |
| first_name | 名 |
| last_name | 姓 |
| メール | |
| unsubscribed_from_emails_at | メールの購読解除日 |
| opted_in_to_emails_at | メールのオプトイン日 |
| user_aliases | ユーザーエイリアス (存在する場合) |
購読グループのデータは、セグメントのエクスポートでは利用できません。購読ステータスでユーザーを特定するには、購読グループのメンバーシップに基づいて別のセグメントを作成し、そのセグメントをエクスポートしてください。
大規模なセグメントのエクスポート
50万人を超えるユーザーを含む大規模なユーザーセグメントをエクスポートするには、いくつかの方法があります。
大規模なセグメントを小さなセグメントに分割し、それぞれの小さなセグメントをBrazeからエクスポートできます。
ランダムバケット番号を使用してユーザー群を複数のセグメントに分割し、エクスポート後に結合することもできます。たとえば、セグメントを2つの異なるセグメントに分割する必要がある場合は、次のフィルターを使用します。
- セグメント1: ランダムバケット番号が5000未満 (0～4999を含む)
- セグメント2: ランダムバケット番号が4999より大きい (5000～9999を含む)
次のエンドポイントを活用して、特定のセグメントのユーザーデータをエクスポートすることもできます。これらのエンドポイントには、データ制限とレート制限が適用されることに注意してください。
Amazon S3の認証情報を接続している場合、セグメントCSVエクスポートの詳細で説明されているように、大規模なエクスポートはメールで送信されるダウンロードリンクに加えて、お使いのバケットにも配信されます。