概要:計測データソースの作成方法と、アトリビューションジョブが処理できる形式でそれらにアクセスする方法を学びます。
概要
計測プロセスを設定する最初のステップは、コンバージョン、エンゲージメント、キャンペーンマッピングという、測定プロセスに必要な3つの入力データを準備することです。これらの入力データは、データ提供モード(アプリ内イベントまたはカスタムソースファイル)に応じて、事前に定義されたスキーマまたはイベント構造に基づいて準備する必要があります。
プロビジョニングモードがカスタムソースファイルの場合、必要なコンバージョンとエンゲージメントレコードのフォルダがクラウドにアップロードされると、アトリビューションジョブが自動的にトリガーされます。アプリ内のイベントモードでは、関連するアプリ内イベントが選択されたときにジョブがトリガーされます。
アプリ内イベントを準備する
アプリに統合されたAppsFlyer SDKによって送信されるアプリ内イベントを介して、コンバージョンとエンゲージメントデータを送信できます。
注意
既にAppsFlyerのアプリ内イベントをSDK経由またはサーバー間リクエスト経由で送信している場合は、カスタムソースファイルオプションよりもこのオプションの方が実装が容易かもしれません。
アプリ内イベントコンバージョンイベントを準備する
アプリ内のコンバージョンイベントには、ネストされたSKU情報を含める必要があります。af_order_info鍵。
"event_value": {
"event_id": "<event_id>",
"af_content": "retail",
"af_order_id": "637f7c400f0e3fddd9e5bcbc",
"af_order_info": [
{
"sku": "a",
"revenue": 1.1,
"qty": 2
},
{
"sku": "b",
"revenue": 100.5,
"qty": 1
}
]
}
アプリ内イベントの準備方法については、下記の「アプリ内イベントの作成」セクションをご覧ください。
リエンゲージメントアプリ内イベント
オンサイトキャンペーンは、アプリ内イベントを通じてエンゲージメントを獲得できます。エンゲージメントアプリ内のイベントには、アトリビューションデータを含める必要があります。event_value鍵。例えば、以下をご覧ください。event_value JSON構造:
"event_value": {
"ad_name": "Spring_Sale_Ad_01",
"ad_id": "ad_123456",
"ad_type": "video",
"adset_name": "Spring_Sale_Set_A",
"adset_id": "adset_7890",
"campaign_name": "Spring_2025_Promo",
"campaign_id": "camp_456123",
"channel": "facebook",
"media_source": "meta_ads",
"engagement_type": "click",
"event_id": "evt_20250410_001"
}
以下のフィールドをご使用いただけますevant_valueJSONキー:
| フィールド | 説明 | 必須 | アプリ内のイベントスキーマ内で利用可能 | タイプ |
|---|---|---|---|---|
campaign_id |
Campaign ID | はい | いいえ | string |
campaign_name |
キャンペーン名 | いいえ | いいえ | string |
engagement_type |
クリック数とインプレッション数を区別する | はい | いいえ | string |
media_source |
イベントに帰属または制限されたメディアソース | はい | いいえ | string |
ad_id |
Ad ID | いいえ | いいえ | string |
ad_name |
広告名 | いいえ | いいえ | string |
ad_type |
例: バナー、フッター | いいえ | いいえ | string |
adset_id |
広告セットIDは、1つ以上の広告を含むグループを識別します。 | いいえ | いいえ | string |
adset_name |
広告セット名。1つ以上の広告を含むグループを識別します。 | いいえ | いいえ | string |
channel |
メディアソースチャネル。例:Googleの例ではYouTube、Meta広告の例ではInstagram。 | いいえ | いいえ | string |
アプリ内イベントの準備方法の詳細については、以下の「アプリ内イベントの作成」セクションをご覧ください。
アプリ内イベントを作成する
アプリ内イベントを通じてコンバージョンとエンゲージメントデータを取得するには、アプリに統合されたAppsFlyer SDKを設定してください。アプリ内イベントの作成に関する詳細については、以下を参照してください。
カスタムソースファイルを準備する
オンサイトキャンペーンを実行中いる場合は、以下の表に示されているスキーマに従って、カスタムソースファイルをコンバージョンとエンゲージメントのソースとして使用できます。
コンバージョンカスタムソースを準備する
コンバージョンのカスタムソースファイルを作成するには、以下の表のスキームを使用する。
コンバージョンスキームは、オフサイトキャンペーンとオンサイトキャンペーンの種類、および異なるメディアパートナーに対して統一されています。
メディアパートナー:
GGoogle
百万Meta
背景色
こちらは必須項目です。
推奨項目
選択されたフィールドのいずれかが必須です
フィールドはSRNで規定されたルールに従ってハッシュ化されます。
| カテゴリ | パラメータ | 説明 | データの型 | CMN | メディアパートナー | |||
|---|---|---|---|---|---|---|---|---|
| App | Web | |||||||
| G | 百万 | G | 百万 | |||||
| Event | event_id | イベントの一意の識別子。 | string | ✓ | ✓ | ✓ | ✓ | ✓ |
| event_name | イベントの名前または種類(例:「購入」、「クリック」)。 | string | ✓ | ✓ | ✓ | ✓ | ✓ | |
| event_time | イベントが発生した時刻のタイムスタンプ。 | 日時 | ✓ | ✓ | ✓ | ✓ | ✓ | |
| アプリ情報 | app_id | アプリケーションの一意の識別子。 | string | ✓ | ✓ | ✓ | ||
| app_name | アプリの名前 | string | ✓ | ✓ | ||||
| app_version | アプリケーションのバージョン番号。 | string | ✓ | ✓ | ||||
| アトリビューションデータ | facebook_browser_id | Facebookブラウザトラッキング用の固有識別子。 | string | ✓ | ✓ | |||
| facebook_cookie | Facebook広告のアトリビューションのためのクリック識別子。 | string | ✓ | ✓ | ||||
| gbraid | Google広告アトリビューション識別子。 | string | ✓ | |||||
| google_click_id | Google広告のクリックトラッキング用の固有ID 。 | string | ✓ | ✓ | ||||
| wbraid | Googleの Web ベースのアトリビューション識別子。 | string | ✓ | |||||
| tiktok_id | TikTokトラッキング用の固有識別子。 | string | ||||||
| キャンペーンデータ | campaign_id | マーケティングキャンペーンの固有識別子。 | string | ✓ | ||||
| install_id | アプリインストールイベントの識別子。 | string | ✓ | |||||
| Conversion Data | SKU | コンバージョンに関係する製品のSKU。 | string | ✓ | ||||
| sku_quantity | 製品の固有識別子(SKU)。 | 整数 | ✓ | |||||
| sku_revenue | 購入または関連するSKUの数量。 | Decimal(少数) | ✓ | |||||
| event_revenue | イベントによって生み出された収益。 | Decimal(少数) | ✓ | ✓ | ✓ | ✓ | ✓ | |
| event_revenue_currency | 収益金額の通貨。 | Decimal(少数) | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Device info | client_ip | ユーザーまたはデバイスのIPアドレス。 | string | ✓ | ✓ | |||
| client_user_agent | ユーザーのデバイス/ブラウザから取得したユーザーエージェント文字列。 | string | ✓ | ✓ | ✓ | |||
| device_category | ユーザーのデバイスのカテゴリ(例:モバイル、デスクトップ)。 | string | ✓ | |||||
| プラットフォーム(OS?) | ユーザーのデバイスのオペレーティングシステム(例: iOS、 Android)。 | string | ✓ | ✓ | ||||
| os_version | デバイスのオペレーティングシステムのバージョン。 | string | ✓ | |||||
| ユーザーID | advertising_id | 広告目的で使用される固有識別子(例:IDFA)。 | string | ✓ | ||||
| appsflyer_id | Appsflyer経由でトラッキングための固有ID 。 | string | ✓ | |||||
| android_id | Android端末固有の識別子。 | string | ✓ | ✓ | ||||
| idfa | IDFA(広告用識別子) | string | ✓ | ✓ | ||||
| idfv | ベンダー識別子(iOS)。 | string | ✓ | ✓ | ||||
| client_id | 固有のクライアント識別子(システムによって生成されるものなど)。 | string | ✓ | ✓ | ✓ | |||
| facebook_hashed_client_id | ルールは指定されていません | string | ✓ | ✓ | ||||
| tiktok_hashed_client_id | トリム、小文字 | string | ||||||
| Cookie | ユーザー/セッショントラッキングのためのブラウザクッキーデータ。 | string | ||||||
| first_name | ユーザーのファーストネーム。 | string | ✓ | ✓ | ✓ | |||
| last_name | ユーザーの姓。 | string | ✓ | ✓ | ✓ | |||
| phone_number | ユーザーの電話番号。 | 整数 | ✓ | ✓ | ✓ | ✓ | ||
| date_of_birth | ユーザーの生年月日。 | 日時 | ✓ | ✓ | ||||
| 性別: | ユーザーの性別。 | string | ✓ | ✓ | ||||
| language | ユーザーが希望する言語または地域。 | string | ✓ | |||||
| メール | ユーザーのメールアドレス。 | string | ✓ | ✓ | ✓ | ✓ | ||
| tiktok_hashed_email | Googleメールアドレスの文字をトリミング、小文字化、ドット削除する | string | ||||||
| tiktok_hashed_phone | E164 | string | ||||||
| google_hashed_email | Googleメールアドレスの文字をトリミング、小文字化、ドット削除する | string | ✓ | ✓ | ||||
| google_hashed_phone | E164 | string | ✓ | ✓ | ||||
| google_hashed_first_name | トリム、小文字 | string | ✓ | |||||
| google_hashed_last_name | トリム、小文字 | string | ✓ | |||||
| facebook_hashed_email | トリム、小文字 | string | ✓ | ✓ | ||||
| facebook_hashed_phone | カスタムフォーマット(+?なし) | string | ✓ | ✓ | ||||
| facebook_hashed_first_name | 小文字、句読点なし | string | ✓ | ✓ | ||||
| facebook_hashed_last_name | 小文字、句読点なし | string | ✓ | ✓ | ||||
| facebook_hashed_date_of_birth | YYYYMMDD | string | ✓ | ✓ | ||||
| facebook_hashed_gender | f/m が推奨されますが、ハッシュ値であればどれでも構いません。 | string | ✓ | ✓ | ||||
| ユーザー属性 | att_status | ユーザーの同意に関するApp Tracking Transparency (ATT)ステータス。 | string | ✓ | ✓ | |||
| Device location | region | ユーザーの地理的地域。 | string | ✓ | ||||
| city | ユーザーに関連付けられている都市。 | string | ✓ | ✓ | ✓ | ✓ | ||
| 州 | ユーザーの州または県。 | string | ✓ | ✓ | ✓ | ✓ | ||
| country_code | ユーザーの国のISOコード。 | string | ✓ | ✓ | ✓ | ✓ | ||
| zip_code | ユーザーの郵便番号。 | string | ✓ | ✓ | ✓ | |||
| 通り | 利用者の住所(利用可能な場合)。 | string | ✓ | |||||
| google_hashed_street | トリム、小文字 | string | ✓ | |||||
| facebook_hashed_city | 小文字、句読点なし、スペースなし | string | ✓ | ✓ | ||||
| facebook_hashed_state | 米国規格ANSI、小文字、句読点なし、スペースなし | string | ✓ | ✓ | ||||
| facebook_hashed_zip_code | 米国/英国向けの特別なルール:小文字、句読点なし、スペースなし | string | ✓ | ✓ | ||||
| facebook_hashed_country_code | ISO 3166-1 alpha-2 の 2 文字国コード(小文字) | string | ✓ | ✓ | ||||
| 紹介/トラフィックデータ | referrer_url | ユーザーを現在のページに誘導したサイトのURL 。 | string | ✓ | ||||
| source_url | ユーザーが最初にキャンペーンに接触した際のソースURL 。 | string | ✓ | |||||
エンゲージメントのカスタムソースを準備します
以下のスキーマを使用する、エンゲージメントデータソースを作成します。
注意
エンゲージメントソーススキームにマッピングされた個人識別情報(PII)フィールドは、上記のコンバージョンソーススキームにマッピングされたPIIと重複しない共通部分を持つ必要があります。
| フィールド | 説明 | 必須 | 期待値タイプ |
|---|---|---|---|
appsflyer_id |
アプリがデバイスにインストールされたときにSDKによって生成される一意のID。 | 個人情報(PII)の入力欄(任意)。個人情報欄のうち、いずれか1つは必須項目です。 | string |
cuid |
アプリ所有者によって設定される一意のアプリユーザーID。 | 個人情報(PII)の入力欄(任意)。個人情報欄のうち、いずれか1つは必須項目です。 | string |
idfa |
iOSデバイス向け、ユーザーがリセット可能な広告ID 。利用できない場合は、ゼロが入力されます。 | 個人情報(PII)の入力欄(任意)。個人情報欄のうち、いずれか1つは必須項目です。 | string |
idfv |
iOSが提供するベンダーID | 個人情報(PII)の入力欄(任意)。個人情報欄のうち、いずれか1つは必須項目です。 | string |
app_id |
AppsFlyer内の一意のアプリ識別子。例: iOS:id123456789 、 Android: com.appsflyer.referrersender
|
オプション | string |
campaign_id |
Campaign ID | 必須 | string |
campaign_name |
キャンペーン名 | オプション | string |
media_source |
イベントに帰属または制限されたメディアソース | 必須 | string |
engagement_type |
クリック数とインプレッション数を区別する | 必須 | string |
event_name |
広告主が設定 | 必須 | string |
event_time |
イベント時間は最も近い時間に切り捨てられます | 必須 | datetime |
app_name |
広告主が設定 | オプション | string |
app_version |
広告主が設定 | オプション | string |
ad_id |
Ad ID | オプション | string |
ad_name |
広告名 | オプション | string |
ad_type |
例: バナー、フッター | オプション | string |
adset_id |
広告セットIDは、1つ以上の広告を含むグループを識別します。 | オプション | string |
adset_name |
広告セット名。1つ以上の広告を含むグループを識別します。 | オプション | string |
channel |
メディアソースチャネル。例:Googleの例ではYouTube、Meta広告の例ではInstagram。 | オプション | string |
platform |
デバイスプラットフォーム:iOS、Android、またはWindows Mobile | オプション | string |
データソースの準備方法やクラウドサービスへのアップロード方法の詳細については、このドキュメントの「カスタムデータソースの作成と接続」セクションを参照してください。
キャンペーンマッピングソースを準備する
キャンペーンマッピングデータのソースは、以下の表に示すスキーマを持つカスタムデータソースファイルです。
注意
メンテナンスや更新が容易になるため、すべてのコラボレーションに単一のマッピングファイルを使用することをお勧めします。
キャンペーンマッピング計画
以下のスキーマを使用する、キャンペーンマッピングソースを作成します。
| フィールドタイプ | (必須) | 期待値 | 説明 |
|---|---|---|---|
| collaborator_name | はい | string | 一緒に作業する共同作業者の名前。 |
| collaborator_id | はい | string | 共同作業者固有の識別子。 |
| campaign_id | はい | string | キャンペーンの固有識別子。 |
| conversion_targets | はい | 文字列配列 | キャンペーン対象のSKUをカンマ区切りで指定したいパラメータです(例:sku1、sku2など)。 |
| campaign_name | いいえ | string | キャンペーン名 |
ソースファイルの作成方法とクラウドサービスへのアップロード方法の詳細については、このドキュメントの「カスタムデータソースの作成と接続」セクションを参照してください。
アトリビューションジョブの取り込みフロー
各アトリビューションジョブは1日専用で、その日の終了後に実行されます。このプロセスの開始時に、ジョブはクラウドサービスまたはアプリ内イベントから関連するコンバージョン、エンゲージメント、およびキャンペーンマッピングデータを取り込みます。
キャンペーンマッピングソースの取り込み
各アトリビューション実行するの前に、DCPはカスタムソースからキャンペーンマッピングレコードを読み込みます。これらのレコードを読み込むには、次の2つのモードから選択できます。
-
最新戦略:DCPは、記録のアップロード日を基準に、最新の記録を取得します。
例えば、ソースに1月18日、1月17日、または12月29日のアップロード日を持つレコードが含まれている場合、システムは1月18日の日付を持つレコードを選択します。
- 日々の戦略:DCPは、アップロード日が帰属実行する日と一致するレコードのみを取り扱います。例えば、実行するが1月19日の午前0時に行われた場合、システムは1月19日にアップロードされたキャンペーン記録のみを選択します。
変換ソースの取り込み
DCP は、その日の終了時に、その日専用のフォルダとその中のコンバージョンレコードにアクセスできる場合にのみ、その日のアトリビューション ジョブを実行します。ただし、特定の日付のフォルダは後日アップロードすることも可能です。例えば、1月17日のフォルダを1月22日にアップロードすることができます。
- DCPは毎日終業時に、その日のアトリビューション処理を実行します。DCPがその日のフォルダを見つけることができた場合にのみ、ジョブが実行するます。フォルダ名は日付名と同じです。
- 日別フォルダには、フォルダ作成日から遡って30日間のイベント記録を含めることができます。例えば、1月17日のフォルダでは、ジョブは12月18日から1月17日までのレコードを処理します。
- 特定の日付にフォルダのアップロードをスキップした場合、30日以内にアップロードする必要があります。例えば、1月17日のフォルダのアップロードをスキップした場合、2月17日までアップロードすることができます。ただし、フォルダ作成日にできるだけ近い時期にアップロードすることをお勧めします。
- DCPが当日のフォルダを見つけられない場合、次の7日間は10分ごとにフォルダの検索を続けます。
エンゲージメントソースの取り込み
DCPは、各コンバージョンレコードについて、そのレコードをトリガーしたエンゲージメントイベントを検索します。
- エンゲージメント記録は日付入りのファイルに保管されています。ただし、毎日エンゲージメントフォルダをアップロードする必要はありません。例えば、1月14日のフォルダをアップロードせずに、1月13日と1月15日のフォルダをアップロードすることができます。この例では、1月15日のフォルダから1月14日の記録が取得されます。
- 特定のコンバージョンフォルダに対するアトリビューションジョブは、そのコンバージョンフォルダと同じ日付、またはそれ以降の日付のエンゲージメントフォルダが存在する場合にのみ開始されます。例えば、1月17日のコンバージョンフォルダのアトリビューションジョブは、1月17日のエンゲージメントフォルダ、または1月18日などのそれ以降の日付のフォルダが存在する場合にのみ開始されます。
- アトリビューションジョブは、エンゲージメントルックバック期間内に該当するすべてのエンゲージメントイベントを収集します。
アプリ内データ取り込み
コンバージョンデータとエンゲージメントデータは、アプリ内イベント、カスタムソース、またはその両方の組み合わせから取得できます。DCPでは、単一のモードを使用するか、複数のモードを組み合わせるかを選択できます。これにより、コンバージョンはアプリ内イベントから発生させ、エンゲージメントはカスタムファイルから取得する、あるいはその逆も可能です。
コンバージョン、エンゲージメント、またはその両方に関するアプリ内イベントを設定する際には、アプリIDとコンバージョンまたはエンゲージメントイベント名を指定する必要があります。最終的に、アトリビューションジョブは、指定された名前とアプリIDを持ち、かつコンバージョン日と同じイベント日付を持つすべてのイベントを選択します。
カスタムデータソースを作成して接続する
カスタムソースを介してデータを接続するには、まず以下のDCPナレッジベース記事の手順に従う必要があります。