SRN経由とSRN以外の経路について、リアトリビューションとリエンゲージメントがコンバージョンデータにどのように反映されるかを説明します。
リターゲティングのコンバージョン
リターゲティングのコンバージョンには、リアトリビューションとリエンゲージメントの2種類があります。
リターゲティングのコンバージョンデータだけでは、コンバージョンの種別を明確に判断できない場合があります。コンバージョンデータを取得するその他の方法をご覧ください。
SRN経由のリアトリビューション
SRN経由でユーザーがリアトリビューションされた場合、コンバージョンデータの内容（ペイロード）からは、リターゲティングキャンペーン経由であることを確認できません。 SRNはアトリビューションリンクを使用しないため、アトリビューションリンクにis_retargeting=trueパラメータを設定できません。リターゲティングに対応しているSRNでは、AppsFlyerがユーザーをリアトリビューションの対象とするかどうかを判断します。
つまり、SDKのデータだけでは、そのインストールがリターゲティングキャンペーン経由かどうかを判断できません。
ただし、リターゲティングであることが分かるキャンペーン名を設定しても、確実に判別できるとは限りません。詳しくは、具体例をご覧ください。
SRN以外のアドネットワーク経由のリアトリビューション
アドネットワークへのアトリビューションには、アトリビューションリンクを使用します。リターゲティングの場合、通常のアトリビューションリンクと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パラメータ：そのインストールがリアトリビューションされたインストールであることを示します。 -
af_reengagement_window：リエンゲージメント期間は、リエンゲージメントしたユーザーのイベントをリエンゲージメントに紐づけられる日数です。この例はリアトリビューションのコンバージョンのため、このパラメータは不要です。
ディファードディープリンクを使用したリアトリビューション
リアトリビューションの対象となるユーザーは、その定義上、アプリをインストールしていない状態です。このようなユーザーを、ディープリンクでアプリ内の画面に誘導したい場合があります。例えば、アプリをアンインストールしたユーザーに再び利用してもらうためのキャンペーンを設定する場合です。このキャンペーンで商品やサービスを宣伝する際には、その商品やサービスに関連するコンテンツをユーザーに表示したいと考えられます。
このような誘導を「ディファードディープリンク」と呼びます。ディファードディープリンクのコンバージョンデータは、onConversionDataSuccessメソッドから取得します。
SRNでのディファードディープリンク
SRNでディファードディープリンクを実装するには、SRNのキャンペーンに追加の処理が必要です。 onConversionSuccessの応答に含まれるcampaign、adset、adgroupなどのデータを使用して、プログラムでユーザーの遷移先を制御してください。
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の応答に含まれるcampaign、adsetなどのデータを使用して、プログラムでユーザーの遷移先を制御し、関連するコンテンツを表示できます。
スポーツウェア専門のECアプリを例に説明します。 アプリをインストールしていないユーザーが広告に反応し、アプリをインストールします。アプリを起動すると、SDKがコンバージョンデータを返します。開発者は、ストア内の夏のランニングシューズコレクション（campaign）の画面を開き、女性用ランニングシューズのカテゴリ（adset）を表示するようにアプリを実装します。
アトリビューションリンクを使用したディファードディープリンク
ディープリンクでユーザーを誘導する方法は3つあります。
URIスキーム
URIスキームを使用する場合、アトリビューションリンクとOneLink、および返却データは次のようになります。
アトリビューションリンク
http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
&c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activityOneLink
// 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のUniversal LinksとAndroidのApp Links
これらが、ディープリンクを実現する3つの方法のうち、残りの2つです。
Universal LinksまたはApp Linksを使用する場合、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
Universal LinksとApp Linksは、OneLinkでのみ使用できます。
SRN経由のリエンゲージメント
リアトリビューションのキャンペーンと同様に、SRN経由でユーザーがリエンゲージメントした場合も、コンバージョンデータからは、リエンゲージメントキャンペーン経由であることを確認できません。
SRN以外のアドネットワーク経由のリエンゲージメント
この場合も、コンバージョンデータの内容からは、ユーザーがリエンゲージメントキャンペーン経由であることを確認できません。この制限に対処するには、リエンゲージメントであることが分かるキャンペーン名を設定します。
ディープリンクを使用したリエンゲージメント
リエンゲージメントでは、ユーザーをアプリ内の特定の画面に誘導することが主な目的の1つです。例えば、商品やセールを宣伝する場合が挙げられます。このような場合、広告をクリックしたユーザーを、その商品やセールのアプリ内の画面に直接誘導したいと考えられます。
これを実現するには、ディープリンクを使用します。ディープリンクでは、コンバージョンデータが非常に重要です。ユーザーに合わせた体験を提供し、適切な画面へ誘導するために開発者が必要とする情報が含まれているためです。
リエンゲージメント：SRNでのディープリンク
SRN経由でユーザーがリエンゲージメントした場合、コンバージョンデータは取得できません。開発者は、アプリの起動時にSRNが提供するメソッドを使用して、このデータを取得する必要があります。
リエンゲージメント：アドネットワークでのディープリンク
ユーザーがリエンゲージメントしてアプリを起動すると、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を推奨するもう1つの理由は、長い形式のOneLinkで返されるコンバージョンデータの構造にあります。長い形式を使用した場合、コンバージョンデータはlinkという単一のフィールドを持つマップ形式で返されます。このフィールドには、長い形式のOneLink全体が格納されます。
{
"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ガイドをご覧ください。 - ローデータレポートにも、コンバージョンの種別を示す情報が含まれます。リターゲティングのコンバージョンを扱うローデータレポートには、イベント名という列があります。この列の値は、コンバージョンの種別に応じてre-engagementまたはre-attribution になります。
ユーザー獲得とリアトリビューションが混在する例
-
ユーザーがアプリをインストールした後、アンインストールします。インストールした時点から、このユーザーにはリアトリビューション期間が適用されます。 Meta広告で、リターゲティングではなくユーザー獲得のキャンペーンを設定します。また、AppsFlyerとMeta広告の連携設定で、リターゲティングを有効にします。リアトリビューション期間内に、ユーザーが広告を見てクリックし、アプリを再インストールします。 AppsFlyerでは、このユーザーをリアトリビューションされたユーザーとして扱います。これは、次の2つの条件を満たしているためです。
- Meta広告との連携設定でリターゲティングが有効になっている
- ユーザーがリアトリビューション期間内にいる
この場合、キャンペーン名からはリアトリビューションであることを判断できません。
- 同じ例で、ユーザーがリアトリビューション期間外にいる場合を考えてみましょう。この場合、インストールは新規のノンオーガニックインストールとして扱われます。
- 別の例を見てみましょう。 Meta広告でリターゲティングキャンペーンを設定します。そのキャンペーンを見た一部のユーザーが、アプリをインストールします。ただし、これらのユーザーは初めてアプリをインストールしています。このようなユーザーは、リアトリビューションされたユーザーとは見なされません。 AppsFlyerでは、ユーザー獲得キャンペーン経由のユーザーとして扱います。