コンバージョンデータのペイロードとシナリオ

概要：コンバージョンデータを使用して、さまざまなコンバージョンシナリオを特定したり、ユーザー体験をカスタマイズしたりできます。

概要

次のセクションでは、さまざまなユーザーのコンバージョンシナリオとそれらに対応するコンバージョンデータのペイロードについて説明します：

ユーザー獲得 (UA)
リターゲティング

コンバージョンデータは次のいずれかのプラットフォームで利用できます：

精度と遅延のトレードオフにより、同じデバイスIDのコンバージョンデータはAPI間で異なる場合があります。

非オーガニックコンバージョンデータのペイロード項目

常に使用可能な項目

以下の表は、コンバージョンの media_source に関係なく、非オーガニックコンバージョンに常に存在するフィールドの一覧です。

ペイロード項目名	ローデータ項目名	備考
`media_source`	Media source	成果が紐づくパブリッシャー。計測リンクの `pid` パラメーターに相当。
`install_time`	Install time
`click_time`	Attributed touch time	クリックまたはインプレッションが発生したUTC時刻。
`is_first_launch`	N/A	`true`, `false`
`af_status`	ローデータは別々のレポートに分かれています： organic / non-organic	`"Non-organic"`
`af_siteid`	Site ID
`adgroup_id`	Ad ID
`adset`	Adset
`adset_id`	Adset ID
`agency`	Partner	`null` または代理店名（代理店が運用するキャンペーンの場合）
`campaign`	Campaign
`campaign_id`	Campaign ID
`http_referrer`	HTTP Referrer
`retargeting_conversion_type`	Retargeting Conversion Type	"none" または retargeting_conversion_type
`af_sub[n] (n=1—5)`	Sub Param [n] (n=1–5)

Fields available in some cases

次の表内の項目は、SRNが個々のイベントへの入力方法によって、使用できる場合があります。

ペイロード項目名	ローデータ項目名	備考
`af_channel`	Channel	このパラメーターを含むSRN馬体： AppLovin Google Ads Meta ads Snapchat TikTok for Business X Ads 例：例：Facebook—Instagram, Google—YouTube
`orig_cost`		注 (1)
`cost_cents_USD`		注 (1)
`af_cpi`		注 (1)
注意 (1) コスト項目にはアドネットワークがレポートした値が入力されます。アドネットワークがコストをAppsFlyerと共有するためには、連携パートナー画面にてコスト連携を有効にする必要があります。一部のSRNは、コストの一括共有をサポートしています。この場合、イベントレベルのコスト項目は 0 として返されます。

追加フィールド

AppsFlyerのパラメーターリスト
計測リンクにパラメーターを追加でき、それらをペイロードで使用できます。

詳細については、ローデータ項目の手引きを参照してください。

制限事項

カスタムパラメーター名

カスタムパラメーターでは、name は利用できません（小文字の n。 Name は利用可能）。

パラメーターに name という名前を付けると、ペイロードから除外されます。

UA conversion data with SRNs

セルフレポーティングネットワーク (SRNs) は、独自の計測メカニズムを実装しているアドネットワークです。

SRNは計測リンクを使用しません。これは、次のことを意味します：

ペイロード項目は事前に定義されています。
計測リンクにパラメーターを追加してペイロードに項目を追加することができません。

SRNはAppsFlyerにコンバージョンをレポートします。コンバージョンデータは、アプリで利用できるようになります。利用できる項目はSRNによって異なりますので、次の各SRNのタブで詳細を確認してください。

Meta広告についての注意事項

Meta adsでキャンペーンを実施しており、Metaの利用規約に同意していない場合、AppsFlyerはインストールを計測しますが、レポートの利用範囲は次のように制限されますのでご注意ください。 Report availability is limited as follows:

利用可能：集計および分析ダッシュボードとレポート
利用不可：ローデータ

Meta ads

Meta広告のコンバージョンデータ

フィールド名	備考	データソース
`match_type`	`srn`, `gp_referrer`	AF
`media_source`	常に `Facebook Ads`	AF
`agency`	`null` またはMeta広告キャンペーンを運用した代理店名を含む	Meta ads
`http_referrer`	常に `null`	Meta ads
`retargeting_conversion_type`		AF
`af_channel`		Meta ads (publisher_platform)
`af_status`	常に `Non-organic`	AF
`ad_id`	Meta広告社内使用のみ。	Meta ads (ad_id)
`click_time`		AF
`install_time`		AF
`is_first_launch`	`true`, `false`	端末
`adset_id`	ローデータで利用可能：Adset ID	Meta ads (campaign_id)
`is_fb`	常に `true`	AF
`campaign`	ローデータで利用可能：Campaign Name	Meta ads (campaign_group_name)
`campaign_id`	ローデータで利用可能：Campaign ID	Meta ads (campaign_group_id)
`is_paid`	常に `true`	Meta ads
`adgroup`	ローデータで利用可能：Ad	Meta ads (adgroup_name)
`adgroup_id`	ローデータで利用可能：Ad ID	Meta ads (adgroup_id)
`adset`	ローデータで利用可能：adset	Meta ads (campaign_name)
`af_siteid`	af_siteid mapping: publisher_platform → af_siteid Facebook → "" Instagram → Instagram AudienceNetwork → AudienceNetwork Messenger → Messenger unknown → unknown "" + is_instagram=true → Instagram "" + is_external=true → AudienceNetwork	Meta ads
`af_sub[1-5]`	常に `null`	広告主

注記：Meta広告ではコンバージョン時にコストデータを共有しないため、コスト関連のフィールドは利用できません。コスト連携が有効に設定されている場合、Meta adsは1日に数回、AppsFlyerとコストデータを共有します。

Google Ads

Google Adsコンバージョンデータ

フィールド名	備考
`match_type`	常に `srn`
`media_source`	常に `googleadwords_int`
`agency`	`none` または `af_prt` の値
`http_referrer`
`retargeting_conversion_type`
`af_channel`	注 (1)
`af_status`	常に `Non-organic`
`click_time`
`install_time`
`is_first_launch`	`true`, `false`
`adgroup_name`
`adset_id`	常に `null`
`campaign`	注 (3)
`campaign_id`
`adgroup`
`adgroup_id`
`adset`	注 (3)
`af_siteid`
`af_sub[1-5]`
`ad_event_id`
`af_ad`	空の文字列
`af_ad_id`	Available in raw data when Google returns `creative_id` value.
`af_ad_type`	AdWords ad type
`af_adset`	ローデータで利用可能：Adset
`af_adset_id`	ローデータで利用可能：Adset ID
`af_c_id`	ローデータで利用可能：Campaign ID
`af_click_lookback`
`af_cpi`	注 (2)
`af_dp`	フィードのGoogleアプリキャンペーンにのみ関連します。
`af_keywords`	ローデータで利用可能：Keywords
`af_prt`	`none` または `af_prt` の値
`af_reengagement_window`	ローデータで利用可能：リエンゲージメント期間
`af_viewthrough_lookback`	ローデータで利用可能：ビュースルーアトリビューションのルックバック期間）
`click_url`	ローデータで利用可能：HTTP Referrer
`click-timestamp`	ソース：AppsFlyer
`cost_cents_USD`	注 (2)
`external_account_id`	AdWords account ID
`gclid`
`lat`
`network`	注 (1)
`orig_cost`	注 (2)
`video_id`	常に `null`
備考 (1) Googleは複数のアドネットワークを使用します。インストールソースを導き出すには、`network` とともに `af_channel` を使用します。 (2) これらのフィールドは0を返します。広告主がコスト連携の設定を有効にしている場合、GoogleはAppsFlyerのコストデータを1日に数回送信します。 (3) `campaign` と`af_adset` を使って、ユーザーコンテンツをパーソナライズします。

ASA

Apple Search Adsコンバージョンデータ

フィールド名	備考
`match_type`	常に `srn`
`media_source`	常に `Apple Search Ads`
`adset`	注 (2)
`adset_id`
`af_adset`	注 (2)
`af_adset_id`
`af_c_id`
`af_click_lookback`
`af_cpi`	注 (1)
`af_keywords`	注 (2)—keywords IDを使用してください
`af_siteid`
`af_status`	常に `Non-organic`
`af_sub[1-5]`
`agency`	`null` または `af_prt` の値
`campaign`	注 (2)
`campaign_id`
`click_time`
`is_first_launch`	`true`, `false`
`cost_cents_USD`	注 (1)
`http_referrer`
`install_time`
`adgroup`
`adgroup_id`
`orig_cost`	注 (1)
`retargeting_conversion_type`
備考 (1) Apple Search Adsは、コンバージョンデータではなく一括でのコスト共有をサポートしています。 (2) Apple Search Ads が AdServices APIを導入したため、2021年2月15日より廃止されました。

Snapchat

Snapchatコンバージョンデータ

フィールド名	備考
`match_type`	`srn`, `gp_referrer`, `id_matching`, `probabilistic` アドバンスドSRNとして、すべてのマッチタイプがサポートされています。
`media_source`	`snapchat_int`
`adset`
`adset_id`
`af_ad`
`af_ad_id`
`af_adset`
`af_adset_id`
`af_c_id`
`af_channel`
`af_cpi`
`af_siteid`
`af_status`	常に `Non-organic`
`af_sub[1-5]`
`af_viewthrough_lookback`
`agency`
`campaign`
`campaign_id`
`click_time`
`cost_cents_USD`
`http_referrer`
`install_time`
`is_first_launch`
`adgroup`
`adgroup_id`
`orig_cost`
`retargeting_conversion_type`

X Ads

X Adsのコンバージョンデータ

フィールド名	備考
`match_type`	常に `srn`
`media_source`	常に `Twitter`
`af_ad`
`af_ad_id`
`af_adset`
`af_adset_id`
`af_channel`
`af_siteid`
`af_status`	常に `Non-organic`
`af_sub[1-5]`
`agency`	常に `null`
`campaign`
`campaign_id`	`null` または Campaign ID
`click_time`
`http_referrer`
`install_time`
`is_first_launch`	`true`, `false`
`adgroup`
`adgroup_id`
`retargeting_conversion_type`	常に `none`

注記：X Adsはコストデータの共有をサポートしていないため、コストフィールドはペイロードに表示されません。

TikTok

TikTok for Businessコンバージョンデータ

フィールド名	備考
`match_type`	`srn`, `gp_referrer`, `id_matching`, `probabilistic` アドバンスドSRNとして、すべてのマッチタイプがサポートされています。
`media_source`	`tiktokglobal_int`
`af_ad`
`af_ad_id`
`af_adset`
`af_adset_id`
`af_channel`	`tiktok`, `pangle`
`af_siteid`
`af_status`	常に `Non-organic`
`af_sub[1-5]`
`agency`
`campaign`
`campaign_id`
`click_time`
`http_referrer`
`install_time`
`is_first_launch`
`adgroup`
`adgroup_id`
`retargeting_conversion_type`

注記：TikTokはコストデータの共有をサポートしていないため、コストフィールドはペイロードに表示されません。

Oath

Oath Ad Platformsコンバージョンデータ

フィールド名	備考
`match_type`	常に `srn`
`media_source`	常に `yahoogemini_int`
`adset`
`adset_id`
`af_ad`
`af_ad_id`
`af_c_id`
`af_cpi`	注 (1)
`af_siteid`
`af_status`	常に `Non-organic`
`af_sub[1-5]`
`agency`
`campaign`
`campaign_id`
`campaign_type`
`click_time`
`cost_cents_USD`	注 (1)
`http_referrer`
`install_time`
`is_first_launch`
`adgroup`
`adgroup_id`
`orig_cost`	注 (1)
`retargeting_conversion_type`
注意 (1) Oath はコスト共有をサポートしていますが、コスト関連のデータはコンバージョンデータではなく一括で送信します。

他のアドネットワークでのUAコンバージョン

その他のアドネットワークに関しては、ペイロードのデータは、計測リンクのパラメーターが直接影響します。

以下に示すJSONペイロードを確認してください。

注！コンバージョンデータはマップのようなデータ構成として返されます。デベロッパーは、生のJSONとはインタラクトしません。

Applovin

計測リンク：

https://app.appsflyer.com/com.company.app?af_ad=ad_name&af_ad_type=INTER
  &af_channel=video&af_siteid=123_site_id&af_c_id=b8******************************&
  af_adset=_DEFAULT&pid=applovin_int&c=campaign_name
  &af_click_lookback=7d&clickid=10****************
  &advertising_id=50********************************&af_ip=

ペイロード：

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "applovin_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:49:54.186",
      "adgroup_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-24 14:29:33.738",
      "agency": null,
      "cost_cents_USD": "0",
      "af_ad_type": "INTER",
      "af_c_id": "b8******************************",
      "adset": null,
      "advertising_id": "50********************************",
      "af_sub1": null,
      "clickid": "10****************",
      "af_click_lookback": "7d",
      "af_siteid": "123_site_id",
      "af_ad": "ad_name",
      "http_referrer": null,
      "af_channel": "video",
      "af_adset": "_DEFAULT",
      "af_sub5": null,
      "af_sub4": null,
      "af_cpi": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }

計測リンク上のパラメーターは、ペイロードの項目として表示されます。
計測リンクにないペイロードのその他の項目は、null 値として表示されます。
Applovin は広告コスト共有をサポートしていますが、AppsFlyerに一括でコストデータを送信します。コスト関連の項目には0が返されます。

ironSource

計測リンク：

https://app.appsflyer.com/id123456789?
  af_ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &clickid=ab*******************&redirect=false
  &ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &af_lang=pt&imei=&af_sub1=&advertising_id=&af_ip=192.168.0.1&pid=ironsource_int
  &device_ip=192.168.0.1&c=campaign_name
  &idfa=01**********************************&af_siteid=123_site_id&
  af_enc_data=cN*********************************************************************

ペイロード：

{
      "adgroup": null,
      "af_enc_data": "cN**************************************************************************************",
      "campaign": "campaign_name",
      "media_source": "ironsource_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:59:32.194",
      "adgroup_id": null,
      "redirect": "false",
      "orig_cost": "0.75",
      "click_time": "2018-12-30 23:58:54.517",
     "agency": null,
      "cost_cents_USD": "75",
      "adset": null,
      "advertising_id": "35**********************************",
      "af_sub1": null,
      "af_ip": "192.168.0.1",
      "clickid": "ab*******************",
      "af_sub3": null,
      "af_cost_value": "0.75",
      "af_ref": "ironsource_5f******************************************",
      "af_siteid": "123_site_id",
      "http_referrer": null,
      "af_cost_model": "cpi",
      "af_ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-N950F Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/71.0.3578.99 Mobile Safari/537.36",
      "af_cost_currency": "USD",
      "af_sub5": null,
      "af_sub4": null,
      "af_lang": "en",
      "af_cpi": null,
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic"
  }

ironSourceは、 orig_cost、cost_cents_USD、af_cost_value フィールドを使用してコンバージョン時にAppsFlyerとコスト関連データを共有します。

ただし、コスト関連のデータは計測リンクには表示されません。 ironSourceはコストデータを暗号化し、af_enc_data 項目に保存します。

リターゲティングのコンバージョンデータ

リターゲティングには、リアトリビューションとリエンゲージメントの2種類のコンバージョンがあります。

ヒント

リターゲティングのコンバージョンデータは、コンバージョンの種類を明確に示しているとは限りません。代替のコンバージョンデータソースを参照してください。

SRNのリアトリビューション

SRNでリアトリビューションCVが計測された場合、コンバージョンデータペイロードは、これがリターゲティングキャンペーンであることを示しません。 SRNが計測リンクを使用しないため、計測リンクで is_retargeting=true パラメーターを設定することはできません。リターゲティング計測をサポートするSRNに関しては、AppsFlyerがユーザーをリアトリビューションするかどうかを判断します。

これは、インストールがリターゲティングキャンペーン経由のものかをSDKレベルで判断できないことを意味します。唯一の方法は、リターゲティングキャンペーンを示すようなキャンペーン名を設定することです。

注

ただし、リターゲティングと分かるようにキャンペーン名を設定する方法は、確実な方法ではありません。詳細に関しては例を参照してください。

通常のアドネットワークのリアトリビューション

アドネットワークのアトリビューシは計測リンクに依存します。通常の計測リンクでもOneLinkでも、リターゲティングの場合は計測リンクに is_retargeting=true というパラメーターが常に含まれています。

Criteoのリターゲティングキャンペーン

計測リンク

https://app.appsflyer.com/id1234567895?pid=criteo_int&af_click_lookback=30d&
  c=campaign_name&is_retargeting=true&redirect=false&idfa=68**********************************
  &af_reengagement_window=30d

コンバージョンデータのペイロード

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "criteo_int",
      "retargeting_conversion_type": "re-attribution",
      "adset_id": null,
      "campaign_id": null,
      "af_reengagement_window": "30d",
      "install_time": "2018-12-01 23:13:03.126",
      "adgroup_id": null,
      "redirect": "false",
      "af_sub5": null,
      "click_time": "2018-11-18 20:02:31.559",
      "agency": null,
      "cost_cents_USD": "0",
      "is_retargeting": "true",
      "af_cpi": null,
      "af_click_lookback": "30d",
      "af_siteid": null,
      "idfa": "68**********************************",
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "adset": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }

retargeting_conversion_type パラメーター：このパラメーターはリターゲティングのタイプを示します。 re-attribution, re-engagement, もしくは none のいずれかが入力されます。
is_retargeting: true パラメーター：このパラメーターはインストールがリアトリビューションCVのインストールであることを示します。
af_reengagement_window：リエンゲージメントアトリビューション期間は、後続のイベントを リエンゲージメント施策に紐づける日数を示します。リアトリビューションコンバージョンであるため、このパラメーターは冗長です。

Re-attribution with deferred deep linking

多くの場合、アプリをインストールしていないユーザーにもディープリンクを提供したいはずです。例えば、アプリをアンインストールしたユーザーを呼び戻すためのキャンペーンを設定したとします。そのキャンペーンが特定の製品やサービスを訴求している場合、訴求している特定の製品やサービスに関するコンテンツの画面へユーザーをリダイレクトしたいと考えています。

これをディファードディープリンクと呼びます。ディファードディープリンクのコンバージョンペイロードは、onConversionDataSuccess メソッドから取得できます。

Deferred deep linking with SRNs

SRNキャンペーンで定義されているディープリンクのパラメーターは、SRN以外では使用できません。これには、アプリのスキームパスを保持する af_dp パラメーターが含まれます。唯一の例外は、フィードのGoogle Appキャンペーンを使用する場合です。ディファードディープリンクを実装するには、SRNキャンペーンに追加のロジックを適用する必要があります。キャンペーン、広告セット、広告グループなどの onConversionSuccess レスポンスデータを使用して、プログラムでユーザーをリダイレクトしてください。

Meta広告でのディファードディープリンクのコンバージョンデータ

Android

{
     "adset":"Adidas Running Shoes Women",
       "adgroup": null,
     "campaign_id":"6**********",
     "af_status":"Non-organic",
     "retargeting_conversion_type": "none",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
     "is_first_launch":true,
     "click_time":"2017-07-18 12:55:05",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "campaign":"running shoes summer collection",
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "media_source":"Meta ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

iOS


  {
     "media_source":"Meta ads",
     "campaign":"running shoes summer collection",
     "adset":"Running Shoes Women",
     "adgroup":null,
     "campaign_id":"6**********",
     "retargeting_conversion_type": "none",
     "af_status":"Non-organic",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
   "is_first_launch":true,
     "click_time":"2017-07-17 16:23:18",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "install_time":"2017-07-18 15:10:50.190",
     "af_sub2":null
  }

キャンペーン、広告セットなどの getConversionData レスポンスのデータを使用して、プログラムでユーザーをリダイレクトし、関連するコンテンツを提供できます。

例

アプリはスポーツウェア専門のEコマースアプリです。アプリを持っていないユーザーが広告と接触してアプリをインストールします。アプリが起動すると、SDKがコンバージョンデータを返します。デベロッパーは、アプリ起動時に、広告で訴求した夏のランニングシューズコレクション（キャンペーン）のアクティビティ（画面）を起動し、女性用ランニングシューズのカテゴリー（広告セット）を提供します。

Deferred deep linking with attribution links

ユーザーをディープリンクするには3つの方法があります：

URIスキーム

計測リンクとOneLinkのどちらでも、URIスキームを使用する場合、計測リンクとペイロードは次のようになります：

計測リンク

http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
  &c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activity

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true&af_dp=superapp%3A%2F%2deeplink-activity

ペイロード

{
      "af_deeplink": true,
      "campaign": "campaign_name",
      "media_source": "media_source_name",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-30 23:59:09",
      "install_time": "2018-12-30 23:59:39.330",
      "agency": null,
      "cost_cents_USD": "0",
      "adset": "AD_SET_NAME",
      "ad_id": "AD_ID",
      "af_siteid": null,
      "http_referrer": null,
      "af_cpi": null,
      "af_sub5": null,
      "af_sub4": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic",
      "scheme": "superapp",
      "host": "deeplink_activity"
  }

af_deeplink: true：このパラメーターが表示され、true に設定されたら、scheme と host のフィールドを探します。
scheme および host ：これらのフィールドは、計測リンクの af_dp パラメーターから取得され、ユーザーがディープリンクされるべきスキームとアクティビティを示します。

iOSのユニバーサルリンクとAndroidのアプリリンク

These are the other two out of the three ways for performing deep linking.

ユニバーサルリンクやアプリリンクを使用する場合、OneLinkとペイロードは次のようになります：

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true

ペイロード

{
      "install_time": "2019-01-08 16:24:49.853",
      "cost_cents_USD": "0",
      "campaign": "campaign_name",
      "retargeting_conversion_type": "none",
      "is_first_launch": true,
      "click_time": "2019-01-08 16:24:14.322",
      "af_click_lookback": "7d",
      "orig_cost": "0.0",
      "af_status": "Non-organic",
      "iscache": "true",
      "shortlink": "71ba577e",
      "media_source": "media_source_name",
      "is_retargeting": true
  }

shortlink フィールド：これはユーザーをもたらした特定のOneLinkを示すフィールドです。これにより、デベロッパーはアクティビティの起動とコンテンツの提供をどのように進めるべきかを知ることができます。この目的のために、campaign 等のその他のフィールドも使用できます。

重要！

OneLinkロングリンクを使用している場合、shortlink ィールドはペイロードに表示されません。

いずれの場合（OneLinkショート／ロングリンク）も、アクティビティを示すカスタムパラメーターを追加することを推奨します。例：&deep_link_activity=shoes_cateogry

注記

ユニバーサルリンクとアプリリンクの使用はOneLinkでのみ実現できます。

SRNでのリエンゲージメント

リアトリビューションキャンペーンのように、ユーザーがSRN経由でエンゲージメントした場合、コンバージョンデータはこれがリエンゲージメントキャンペーン経由であることを明示しません。リエンゲージメントキャンペーンであることを示すキャンペーン名を設定してください。

通常のアドネットワークのリエンゲージメント

ここでも、コンバージョンデータはユーザーがリエンゲージメントキャンペーン経由であることを明示しません。この制限を克服するためには、リエンゲージメントであることを示すキャンペーン名を設定してください。

Re-engagement with deep linking

リエンゲージメントの主な役割は、ユーザーを特定のアクティビティ（アプリ内画面）に送信することです。例えば、なんらかの製品やセールを訴求するとします。その場合、広告をクリックしたユーザーをこの製品やセールに関連するアプリアクティビティ（アプリ内画面）に直接送信したいと考えるでしょう。

そのために、ディープリンクを使用します。ディープリンクのコンバージョンデータは非常に重要です。デベロッパーがユーザーエクスペリエンスをカスタマイズし、正しいアクティビティにユーザーを遷移させるために必要な情報がコンバージョンデータに含まれています。

リエンゲージメント：SRNでのディープリンク

リエンゲージメントユーザーがSRN経由の場合、コンバージョンデータは利用できません。デベロッパーはSRNの方法を使用して、取得する必要があります。

Re-engagement: deep linking with ad networks

ユーザーがリエンゲージしアプリを起動すると、次の onAppOpenAttribution メソッドのコンバージョンデータが利用できます：

iOSとAndroidの両方でOneLinkショートリンクを使用する場合、コンバージョンデータは、リンク上のすべてのパラメーターがマッピンクされた構造になります。

例：

{
     af_dp: "superapp://Deeplink",
     pid: "media_source_name"
     c: "campaign_name",
     link: "https://abcd.onelink.me/12ab/12ab34c"
     is_retargeting: true
  }

アプリ開発者は、af_dp やキャンペーン名のようなパラメーターを使用して、ユーザーを特定のアクティビティに送信し関連性のあるコンテンツを提供することができます。

重要！

OneLinkショートリンクを使用することを推奨します。こちらをクリックして詳細をご確認ください。

OneLinkショートリンクを使用すべきもう一つの理由は、OneLinkロングリンクのコンバージョンデータの構造です。 OneLinkロングリンクを使用する場合、コンバージョンデータは、OneLinkロングリンク全体を保持する link という単一のフィールドを持つマップとなります。

{
     "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
  }

代替コンバージョンデータソース

Push APIは、リアトリビューションまたはリエンゲージメントを明示する詳細なコンバージョンペイロードを提供します。 Push APIペイロードには、re_targeting_conversion_type というフィールドが含まれます。この項目は、リアトリビューションまたはリエンゲージメントのいずれかのコンバージョンタイプを示しています。詳細は、Push APIガイドを参照してください。
ローデータレポートにもコンバージョンの種類を示す項目が含まれています。リターゲティングコンバージョンのローデータレポートには、Event Name という項目が存在します。この列の値は、コンバージョンの種類に応じて、re-engagement または re-attribution のいずれかが入ります。

ユーザー獲得とリアトリビューションが混在する例

AppsFlyer

ユーザーがアプリをインストールしてから、アンインストールします。インストールにより、このユーザーのリアトリビューション期間のカウントが開始します。 Meta広告でユーザー獲得（リターゲティングではない）キャンペーンを設定します。また、AppsFlyerのMeta広告連携を設定し、リターゲティングを有効にします。

リアトリビューション期間中に、ユーザーが広告をクリックして、アプリを再インストールします。 AppsFlyerでは、このユーザーをリアトリビューションCVユーザーと見なします。

これは2つの要因によるものです：
1. Meta広告の設定により、リターゲティングが可能になる
2. ユーザーがリアトリビューション期間中である
この場合、このキャンペーン名はリアトリビューションであることを示唆しません。
同じ例を使い、今度はユーザーがリアトリビューション期間外であるとしましょう。この場合、このインストールは新規の非オーガニックインストールと見なされます。
もう一つ例を見てみましょう。 Meta広告にリターゲティングキャンペーンを設定します。一部のユーザーがキャンペーン経由でアプリをインストールします。ただし、これらのユーザーはアプリを初めてインストールするユーザーです。このようなユーザーはリアトリビューションユーザーとは見なされません。代わりに、AppsFlyerはこれらのユーザーを新規ユーザー獲得キャンペーン経由のユーザーと見なします。

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

検索

概要

非オーガニックコンバージョンデータのペイロード項目

常に使用可能な項目

Fields available in some cases

追加フィールド

制限事項

UA conversion data with SRNs

Meta広告についての注意事項

Meta広告のコンバージョンデータ

Google Adsコンバージョンデータ

Apple Search Adsコンバージョンデータ

Snapchatコンバージョンデータ

X Adsのコンバージョンデータ

TikTok for Businessコンバージョンデータ

Oath Ad Platformsコンバージョンデータ

他のアドネットワークでのUAコンバージョン

計測リンク：

ペイロード：

計測リンク：

ペイロード：

リターゲティングのコンバージョンデータ

SRNのリアトリビューション

通常のアドネットワークのリアトリビューション

計測リンク

コンバージョンデータのペイロード

Re-attribution with deferred deep linking

Meta広告でのディファードディープリンクのコンバージョンデータ

URIスキーム

iOSのユニバーサルリンクとAndroidのアプリリンク

SRNでのリエンゲージメント

通常のアドネットワークのリエンゲージメント

Re-engagement with deep linking

代替コンバージョンデータソース

ユーザー獲得とリアトリビューションが混在する例