イベント
データ抽出
データ抽出は、収集されたイベントをもとに広告対象者（オーディエンス）の広告識別子（ADID）を CSV でエクスポートする画面です。左側メニューの イベント > データ抽出 からアクセスし、抽出条件を設定して母集団を事前に確認（プレビューカウント）したうえで CSV をダウンロード（CSV ダウンロード）する順序で進めます。抽出した CSV は、Meta・Google・TikTok などの広告プラットフォームのカスタムオーディエンス（Custom Audience）のアップロードに使用できます。
1. 抽出の流れ
- 左側の
フィルターパネルで、母集団プリセット・期間設定・プラットフォーム・CSV プリセット・ハッシュ形式を設定します。 [プレビューカウント]ボタンを押して、抽出される母集団（プラットフォーム別のユニーク ADID 数）を確認します。- 右側の結果表で、合計・Android・iOS の数値を確認します。
[CSV ダウンロード]ボタンを押してファイルをダウンロードします。
母集団が 0 件の場合、[CSV ダウンロード] ボタンは無効になります。期間やプリセットを調整してから、もう一度プレビューを実行してください。
2. フィルター項目
| 項目 | 説明 |
|---|---|
オーディエンスプリセット | 抽出するユーザー集団の種類です（下表を参照）。 |
期間 | イベントの集計期間です。デフォルトは直近 90 日です。 |
プラットフォーム | すべて / Android / iOS から選択します。 |
休眠期間（非アクティブ） | 休眠ユーザー プリセットを選択した場合にのみ表示されます。アクティビティがないと判定する日数で、デフォルトは 30 日（最小 7 日、最大 365 日）です。 |
広告プラットフォーム CSV プリセット | ダウンロードする CSV のカラム形式です（下表を参照）。 |
ハッシュ形式 | ADID を SHA256 でハッシュ化するか、原文（Plain）のままエクスポートするかを選択します。 |
母集団プリセット
| プリセット | 抽出対象 |
|---|---|
| インストールユーザー（Installers） | 選択期間中にインストール（install/first_open）イベントが発生したデバイスです。 |
| 購入ユーザー（Purchasers） | 選択期間中に購入（purchase/first_purchase）イベントが発生したデバイスです。 |
| インストール後未購入ユーザー（Installed Non-Purchasers） | 選択期間中にインストールしたものの購入していないデバイスです（インストールユーザーから購入ユーザーを除外）。 |
| 休眠ユーザー（Dormant Users） | インストール後、直近の 休眠期間 の間にイベントが一度も発生していないデバイスです。 |
広告プラットフォーム CSV プリセット
選択したプリセットによって CSV のカラム構成が変わります。
| プリセット | CSV カラム | 備考 |
|---|---|---|
| Meta (Facebook/Instagram) | madid | IDFA（iOS）と GAID（Android）を 1 つのカラムに統合します。 |
| Google Ads | Mobile Device ID | 単一のカラムです。 |
| TikTok Ads | IDFA, GAID | iOS の値は IDFA カラム、Android の値は GAID カラムに分けて入力します。 |
| Custom (raw columns) | advertising_id, platform | 広告識別子とプラットフォームをそのままエクスポートします。 |
3. ハッシュ形式（SHA256 推奨）
| 形式 | 説明 |
|---|---|
| SHA256（広告プラットフォーム推奨） | ADID を小文字に正規化したあと、SHA256 でハッシュ化してエクスポートします。 |
| Plain text | ADID の原文をそのままエクスポートします。 |
広告プラットフォームのカスタムオーディエンスのアップロードでは一般的にハッシュ化された識別子が求められるため、外部の広告プラットフォームにアップロードする目的であれば SHA256 を推奨します。
4. プレビュー結果表
[プレビューカウント] の実行後に右側に表示される結果表は、次のカラムで構成されます。
| カラム | 説明 |
|---|---|
| プラットフォーム | 合計（Total）、Android、iOS の行に分かれます。 |
| 広告 ID の種類 | 合計は ADID、Android は GAID、iOS は IDFA と表示されます。 |
| ユニーク ADID | 重複を除いたユニークな広告識別子の数です。 |
| 比率 | 合計に対して各プラットフォームが占める割合です。 |
5. 自動除外ルール
抽出時、広告識別子が有効でないデバイスは母集団から自動的に除外されます。
| 除外対象 | 説明 |
|---|---|
| 広告識別子なし | advertisingId が空（null/空値）のデバイスです。 |
| 0 値の IDFA | iOS でトラッキングの同意が得られず、0 で埋められた IDFA（00000000-0000-0000-0000-000000000000）です。 |
| Android・iOS 以外のプラットフォーム | 広告識別子ベースの抽出という特性上、Android・iOS のデバイスのみが集計されます。 |
このような自動除外があるため、リアルタイムログに表示される全イベント数より抽出される母集団が少なくなるのは正常です。