ディファードディープリンク - コンバージョンデータの取得

ディファードディープリンク - コンバージョンデータの取得 - https://support.appsflyer.com/hc/en-us/articles/207032096-Deferred-Deep-Linking-Getting-the-Conversion-Data

はじめにSDKの実装例レスポンスキー

はじめに

AppsFlyerを使用すると、SDKレベルでリアルタイムのユーザーアトリビューションデータに直接アクセスできます。 これにより、新規アプリをインストールした後、最初にアプリを開く際にユーザーが目にするランディングページをカスタマイズすることができます。 これは、一般的に「ディファード」ディープリンクと呼ばれています。 ウェブ上では非常に一般的ですが、モバイルアプリのエコシステムでこれを行うことは困難です。 幸いにも、AppsFlyerはあらゆるケースとプラットフォームをサポートしています。

インストール時に新規アプリユーザーをディープリンクに誘導することは、すでにアプリをインストールしているユーザーに対して、アプリのディープリンクを行うカスタムURLスキーム(iOSAndroid)を利用することと非常に類似しています。 

 

「ホテル ニューヨーク」を検索する際に、HotelTonightのGoogle Adwordsの広告をクリックしたばかりのユーザーについて考察しましょう。 まずユーザーは、Google PlayまたはApp Storeに転送されて、アプリをダウンロードします。アプリを初めて開いた際に、ユーザーには「ニューヨークのホテル」に関するランディングページが直接表示されます。AppsFlyerが提供するアトリビューションデータにアクセスすることで、アプリは、ユーザーまたはインストールを獲得するために使用される正確なキャンペーンとキーワードを受け取ります。


この機能により、エクスペリエンスやコンバージョンの向上のほか、コンテキストに基づく高度なキャンペーンを実施することができます。これには、アプリをインストールし、利用するユーザーにクレジットまたはボーナスを提供するなどのキャンペーンが挙げられます。例:「クリックしてインストール」キャンペーンではなく、「インストールして、予約に使える$50の予約クレジットを獲得」キャンペーンなど。 これらのキャンペーンは、「クリックしてインストール」コンバージョンを向上するだけでなく、有料ユーザーへのコンバージョンも向上します。 これらのキャンペーンにより、全体的なROIは2~5倍向上する可能性があります。

AppsFlyerのNativeTrack™ SDKは、サーバー側のトラッキングを実施しています。 つまり、コンバージョントラックは、AppsFlyerサーバー上で処理され、利用することができます。 AppsFlyerのSDKからアトリビューションデータにアクセスする際、アプリを初めて開いてから数秒かかることがあります。

 注意

Facebookのプライバシーポリシーによると、AppsFlyer(または他のサードパーティーのモバイル測定パートナー)は、Facebookのサービス規約に同意しない限り、Facebookインストールのユーザーレベルアトリビューションを提供することができません。 詳細については、こちらを参照してください。

サービス規約に同意しない場合、Facebookモバイル広告のインストールが「オーガニック」カテゴリーとして分類され、Facebookインストールのユーザーレベルデータを受信できなくなります。

ディファードディープリンクを実装するためのアトリビューションデータへのアクセスについては、インストール後にユーザーが初めて起動する場合に適用されます。 すでにアプリをインストールしているユーザーに対して、ディープリンクを実装する場合は、こちらを参照してください。

アトリビューションレスポンスで利用可能なキー

アプリ側へ返されたコンバージョンデータは、元のトラッキングリンク上のすべてのパラメーターのほか、クリックまたはインストール時に作成された、追加のサーバーパラメーターにより構成されています。

コンバージョンデータは、トラッキングリンクにより異なるため、メディアソースおよびトラッキングリンクが異なる場合、コンバージョンデータパラメーターが異なることがあります。

以下の機能は、アプリが起動するたびに呼び出されます。

onInstallConversionDataLoaded :Android

onConversionDataReceived :iOS

インストールのタイプによって、以下の3通りの結果が起こる可能性があります。

非オーガニックインストール
インストールの元のアトリビューションデータを返します(以下の例を参照してください)。
オーガニックインストール
(または再インストール)「オーガニックインストール」を返します
再アトリビューション
再アトリビューションされたコンバージョンの詳細を返します。

レスポンスキーの説明

キー名 説明 値の例 メディア
ソース

af_status

検知されたアトリビューションのタイプが表示されます。

有効な値:

  • Organic
  • Non-organic
  • Error

Non-organic

すべて

af_message

自由入力欄

Organic install/Error message

すべて

media_source

メディアソース名。 これはAFトラッキングリンクの「pid」パラメーターです

  • inmobi_int
  • tapjoy_int
  • Facebook Ads

 注意

代理店経由のメディアソースは非表示であり、「null」の値が設定されています。

すべて

 

campaign

キャンペーン名(AppsFlyerのトラッキングリンク「c」パラメーターまたはFacebookキャンペーン名)

Ad1/camp123

すべて

clickid

クリックIDまたはトランザクションID

123456/xsfd234

すべて

af_siteid

サイトID(最適化用)

Site1

すべて

af_sub1

追加パラメーター

someParameter

すべて

af_sub2

追加パラメーター

 

すべて

af_sub3

追加パラメーター

 

すべて

af_sub4

追加パラメーター

 

すべて

af_sub5

追加パラメーター

 

すべて

af_keywords

検索キャンペーンで検索したキーワード。  例: Google検索キャンペーン

 

すべて

click_time

クリック時刻(ミリ秒)

2014-01-08 00:07:53.233

すべて

install_time

コンバージョン時刻(ミリ秒)

2014-01-08 00:12:51.701

すべて

agency

代理店またはPMDによって生成されたインストール

nanigans

すべて

is_first_launch

初回起動時はtrue、それ以降はfalseとなる

true

すべて

is_fb

 

Facebookアトリビューションであることを示すフラグ:true/false

true

Facebook

ad

Facebookの広告名

Angry BirdのFacebook広告1

Facebook

ad_id

Facebookの広告ID

6012740800279

Facebook

campaign_id

FacebookのキャンペーンID

6012700005123

Facebook

adset

Facebookの広告セット名

US - 18+

Facebook

adset_id

Facebook広告セットID

6099800005123

Facebook

ad_id

Facebook固有の広告ID番号

6012998843079

Facebook

通常のAppsFlyerトラッキングリンクインストールの例

以下のトラッキングリンクを使用して生成されたインストール:

Android iOS
http://app.appsflyer.com/angry-birds-android?pid=tapjoy_int&c=July4-2014&
af_prt=starcomm&af_siteid=57&af_sub1=subtext1&freehand-param=somevalue

これにより、以下が生成されます。 

コンバージョンデータレスポンス

Android iOS
{
   "media_source":"Yeahmobi_int",
   "campaign":"Yeahmobi_TH",
   "adset":null,
   "clickid":"fb7f51d42-2621-93bd-e9a1b24f1acfab7b76e5104706104f4d683ffdb560c0010",
   "adgroup":null,
   "campaign_id":null,
   "af_cost_currency":"USD",
   "af_status":"Non-organic",
   "af_sub_siteid":"1702",
   "agency":"ECHOMARKETING",
   "af_sub3":null,
   "af_cost_model":"CPI",
   "af_siteid":"1777215",
   "af_dp":"agoda://home",
   "adset_id":null,
   "click_time":"2017-07-19 08:30:31.890",
   "cost_cents_USD":"150",
   "iscache":true,
   "is_first_launch":true,    "af_cpi":null,    "af_sub1":"102619",    "af_cost_value":"1.5",    "af_click_lookback":"1d",    "af_sub4":null,    "site_id":"1777215",    "adgroup_id":null,    "tag":"8d55089f-31b6-407b-9266-00690845fbce",    "orig_cost":"1.5",    "af_prt":"ECHOMARKETING",    "af_sub5":null,    "install_time":"2017-07-19 08:30:35.461",    "af_sub2":"Yeahmobi_TH_G001_Android", "freehand-param":"somevalue" }

 注意

キーの順番は異なる場合があります。 追加キーが予告なく追加されることがあります。

Facebookインストールの例

 注意

Facebookキャンペーンへのトラッキングリンクはありません。

Facebookキャンペーンで定義されているディープリンクパラメーターは、Facebook以外で使用することができません。 これには、アプリのスキームパスを保有しているaf_dpパラメーターが含まれます。したがって、ディファードディープリンクを実施するために、Facebookキャンペーンに追加のロジックが適用される必要があります。 キャンペーン、広告セット、広告グループなど、getConversionDataレスポンスのFacebookデータを使用して、プログラムでユーザーをリダイレクトします。

コンバージョンデータレスポンス

Android iOS
{
   "adset":"T:DAT-Desktop_O:All_L:AR-AE_A:All_R:1-30 Day",
   "adgroup":"T:DAT-Desktop_O:All_L:AR-AE_A:All_R:1-30 Day",
   "campaign_id":"6068535534218",
   "af_status":"Non-organic",
   "agency":null,
   "af_sub3":null,
   "af_siteid":null,
   "adset_id":"6073532011618",
   "is_fb":true,
   "is_first_launch":true,
   "click_time":"2017-07-18 12:55:05",    "iscache":false,    "ad_id":"6074245540018",    "af_sub1":null,    "campaign":"T:DAT_L:AR-AE",    "is_paid":true,    "af_sub4":null,    "adgroup_id":"6073532011418",    "is_mobile_data_terms_signed":true,    "af_channel":"Facebook",    "af_sub5":null,    "media_source":"Facebook Ads",    "install_time":"2017-07-19 08:06:56.189",    "af_sub2":null }
この記事は役に立ちましたか?
7人中7人がこの記事が役に立ったと言っています