どのようにお手伝いできますか?

データコラボレーションプラットフォーム(DCP) - コラボレーション計測の準備

  • 更新

概要:計測データソースの作成方法と、アトリビューションジョブが処理できる形式でそれらにアクセスする方法を学びます。

概要

計測プロセスを設定する最初のステップは、コンバージョン、エンゲージメント、キャンペーンマッピングという、測定プロセスに必要な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ナレッジベース記事の手順に従う必要があります。