SDKによるコンバージョンデータの取得｜リターゲティング

SRNおよびSRN以外の経路で獲得したユーザーについて、リアトリビューションとリエンゲージメントがコンバージョンデータにどのように反映されるかを説明します。

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

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

リターゲティングのコンバージョンデータだけでは、コンバージョンの種類を明確に判別できるとは限りません。コンバージョンデータのその他の取得方法を参照してください。

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

SRN経由でユーザーのリアトリビューションが発生しても、コンバージョンデータのペイロードには、リターゲティングキャンペーン経由であることは示されません。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パラメータ：このインストールがリアトリビューションによるインストールであることを示します。
af_reengagement_window：リエンゲージメント期間は、リエンゲージメントしたユーザーのイベントをアトリビューションの対象とできる日数です。この例はリアトリビューションのコンバージョンなので、このパラメータは不要です。

ディファードディープリンクによるリアトリビューション

リアトリビューションの対象となるユーザーは、その性質上、アプリがインストールされていない状態です。こうしたユーザーをディープリンクで誘導したい場合は少なくありません。例えば、アプリをアンインストールしたユーザーを呼び戻すためのキャンペーンを設定するとします。そのキャンペーンで商品やサービスを訴求する場合は、広告で紹介した商品やサービスに関連するコンテンツをユーザーに表示したいと考えるでしょう。

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

SRNでのディファードディープリンク

SRNでディファードディープリンクを実装するには、追加のロジックを必ず 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のレスポンスに含まれるキャンペーン、広告セットなどのデータを使うと、プログラムでユーザーをリダイレクトし、そのユーザーに関連するコンテンツを表示できます。

スポーツウェア専門のECアプリを例に説明します。あるユーザーが、アプリ未インストールの状態で広告に反応し、アプリをインストールします。アプリが起動すると、SDKはそのコンバージョンデータを返します。開発者は、アプリで 夏のランニングシューズコレクション（キャンペーン）の画面を開き、ストア内の女性用ランニングシューズのカテゴリ（広告セット）を表示するよう実装します。

計測リンクを使用したディファードディープリンク

ディープリンクでユーザーを誘導する方法は、次の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のアプリリンク

これらは、3つある誘導方法のうち、残りの2つのディープリンク方式です。

ユニバーサルリンクやアプリリンクを使用する場合、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などの他のフィールドも、同様にこの目的に使用できます。

shortlinkフィールドがペイロードに含まれないのは、 OneLinkロングリンクを使用する場合です。

OneLinkショートリンクとロングリンクのいずれを使用する場合も、カスタムパラメータで誘導先のアプリ内画面を指定することを推奨します。例えば、 &deep_link_activity=shoes_cateogry

ユニバーサルリンクとアプリリンクを使用できるのは、 OneLinkのみです。

SRN経由のリエンゲージメント

リアトリビューションキャンペーンと同様に、SRN経由でユーザーのリエンゲージメントが発生しても、コンバージョンデータには、リエンゲージメントキャンペーン経由であることは示されません。

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

この場合も、コンバージョンデータのペイロードには、ユーザーがリエンゲージメントキャンペーン経由であることは示されません。この制限を補うには、リエンゲージメントであることが分かるキャンペーン名を設定します。

ディープリンクを使用したリエンゲージメント

リエンゲージメントでは、ユーザーを特定のアプリ内画面に誘導することが重要です。例えば、商品やセールの広告を配信する場合を考えてみましょう。このような場合、広告をクリックしたユーザーを、その商品やセールに関連するアプリ内画面に直接誘導したいと考えるでしょう。

そのために使用するのが、ディープリンクです。ディープリンクでは、コンバージョンデータが非常に重要です。ユーザーに合わせた体験を提供し、適切なアプリ内画面に誘導するために開発者が必要とする情報が、コンバージョンデータに含まれています。

リエンゲージメント：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つの条件に該当するためです。
1. Meta広告との連携設定でリターゲティングが有効になっている
2. ユーザーがリアトリビューション期間中である
この場合、キャンペーン名からはリアトリビューションであることを判別できません。
同じ例で、ユーザーがリアトリビューション期間外の場合を考えてみましょう。この場合、インストールは新規の非オーガニックインストールとして扱われます。
別の例を見てみましょう。Meta広告でリターゲティングキャンペーンを設定します。一部のユーザーがこのキャンペーンに接触し、アプリをインストールします。ただし、これらのユーザーにとっては初めてのインストールです。このようなユーザーは、リアトリビューションの対象にはなりません。AppsFlyerでは、ユーザー獲得キャンペーン経由のユーザーとして扱われます。

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

検索