計測リンクの仕様:アドネットワーク向け

概要: AppsFlyerと連携しているアドネットワークは、このページの内容に従って計測リンクの設定を行ってください。 

計測リンク:アドネットワーク向け

計測リンクは、ユーザーが広告をクリックすることで広告へエンゲージしたことをAppsFlyerへ通知するために使用するものです。もっともシンプルな例は、計測リンクを広告の裏側に設定しておいて、ユーザーが広告をクリックした際に計測リンクもクリックされたことになるというものです。

計測方法

このセクションでは、最初のクリックまたはインプレッションからインストール / イベントの紐付けに至るまでの過程で何が起こるかを説明しています。

appsflyer-attribution-model-for-partners.png

  1. ユーザーがバナーやリンクをクリック。
  2. そのバナーやリンクは、ユーザーをAppsFlyerの計測リンクへリダイレクトし、AppsFlyerの計測リンクにはこのクリック中に収集された情報が入力される。
  3. AppsFlyerはそれらの情報を計測リンクから取得し、データベースへ格納。
  4. ユーザーはアプリをインストールしてアプリを初回起動。アプリ内に実装されたSDKが、インストールした端末の情報と一緒にAppsFlyerのサーバーと通信。
  5. AppsFlyerの 計測メソッドを使用して、このデータをクリックデータベースと照合。
    • リファラーマッチング
      この計測方法は、Android端末のみに適用されます。ユーザーがリンクをクリックしてGoogle Play にリダイレクトされると、Google Playはユニークなリファラー IDを発行します。アプリのインストールが発生すると、AppsFlyerは端末からこのリファラーIDを収集します。そして、このIDをGooglePlay側の記録と照合します。
    • IDマッチング
      URLクリック時に収集された広告ID(iOS:IDFA / Android:GAID)と、インストール時にSDKが取得した端末の広告IDを照合します。
    • 確率論的モデリング

    すべての計測メソッドの詳細については、こちらを参照してください。

    クリックデータベースにて、リファラー、広告ID、確率論的モデリングのデータポイントの順にデータを探します。データがマッチすれば、そのクリックにインストールを紐付け、マッチしなければオーガニックインストールに紐付けます。

  6. インストールが計測されると、コンバージョンの詳細が含まれたポストバックがアドネットワークに送信されます。

この流れに沿って、計測リンクを利用してアドネットワークから情報を得て、ポストバックで情報を送り返しています。

 注意

TUNE、CAKE、Affiseなどのサードパーティのパフォーマンスマーケティングツールを使用している場合は、プラットフォーム向けのガイドを代わりに参照してください。

計測リンクのテンプレート

計測リンク(バナーの背後に設置されているリンク)は、次のように形になります。

https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid={affiliate_id}&af_cost_model=CPI&af_cost_value={cost_value}&af_cost_currency={currency}&c={Campaign}&af_ad_type={AdType}&af_adset={Adset}&af_ad={Ad}&is_incentivized={true\false}&expires={timestamp}&signature={signature}


https://app.appsflyer.com/ は AppsFlyerのエンドポイントで、 com.yourapp はアプリID、 pid=mediaName_int はアドネットワーク毎に割り当てられるユニークなメディアソース名です。

リンクのこの部分はスタティックであり、アドネットワーク側では何も変更する必要はありません。

リンクの構造に関する解説:

  • '='の後ろにある{}内の値は、クリックが発生しAppsFlyerにデータが送信されるときにアドネットワーク側で値を入力する必要があるマクロです。テンプレートを作成する際には、{}内の値を御社のマクロに置き換えてください。 
  • 御社側でのマクロの命名は、御社のシステムがそれらのマクロを実際の正しい値に置き換えることができるのでれば特に意味を持ちません。'='の前のパラメータはAppsFlyer側で使用するプレースホルダなので、どの値を御社がAppsFlyerへ送信しているかが判別できます。
  • AppsFlyerとの連携をご希望の場合には、計測リンクのテンプレートを御社側のマクロも記載した上でメールでご連絡ください。 

次の表にリストされているパラメータは、推奨される最小値と見なしてください。 より多くのパラメーターのセットがサポートされています。 クリック時に取得できた情報は、できる限り多くAppsFlyerへ共有してください。詳細は、 計測リンクパラメータの一覧をご覧ください。

最低限推奨の計測リンクパラメータ 

パラメーター 説明
&clickid={clickid} ClickID は、アドネットワーク上で発生した各クリックに対して割り振られるユニークなクリック識別子です。
&advertising_id={gaid} もしくは
&idfa={IDFA}
クリックが行われた端末の広告ID(Android:GAID / iOS:IDFA)です。
&c={campaign} 広告主によって定義されたキャンペーン名です。
&af_siteid={publisher_id} クリックを生んだパブリッシャー(配信面)またはアフィリエイター毎に振られたパブリッシャー/アフィリエイトIDです。
&af_ad_type={search_text} 広告タイプです。次の命名規則のいずれかを使用して値を返してください:
search_text
banner
interstitial
video
rewarded_video
playable
sponsored_content
audio
&af_adset={adsetid} 広告セット名 - 広告主かパブリッシャーにより設定されるもので、広告セットはキャンペーンと広告の間に位置する階層レベルです。詳細
&af_ad={ad_id} 広告名(詳細を参照)- 広告主かパブリッシャーにより設定されるものです。
&is_incentivized={true} インセンティブキャンペーンなのか、またはそうではない(ノンインセンティブキャンペーン)なのかをtrue / false の値で返してください。
&af_cost_value={cost_value} コンバージョンのコストの値です。小数点以下4桁まで対応しています。
"56"、"2.85"など、数値のみ設定可ですので注意してください。(必要に応じて小数点は使用可です)
&af_cost_currency={currency} コストの通貨コード - (例:USD、JPY) デフォルトの値はUSDです。
通貨コードのリスト
&expires={timestamp} アドネットワークがクリックを主張しなくなるUnixのタイムスタンプです。クリック洪水を防止するための、クリック署名の機能で使用します。(詳細)
&signature={signature} クリックの検証と不正を防止するための、HMAC-SHA256形式の署名です。(詳細)