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

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

  • 更新

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

Attribution links for ad networks

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

Attribution model

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

appsflyer-attribution-model-for-partners.png

  1. ユーザーがバナーやリンクをクリック。
  2. The banner or link redirects the user to an AppsFlyer attribution link. The AppsFlyer attribution link is then populated with information that is collected during the click.
  3. We gather the information from the attribution link and store it in our database.
  4. ユーザーはアプリをインストールしてアプリを初回起動。アプリ内に実装されたSDKが、インストールした端末の情報と一緒にAppsFlyerのサーバーと通信。
  5. AppsFlyerの 計測メソッドを使用して、このデータをクリックデータベースと照合。
    • リファラーマッチング
      この計測方法は、Android端末のみに適用されます。ユーザーがリンクをクリックしてGoogle Play にリダイレクトされると、Google Playはユニークなリファラー IDを発行します。アプリのインストールが発生すると、AppsFlyerは端末からこのリファラーIDを収集します。そして、このIDをGooglePlay側の記録と照合します。
    • IDマッチング
      URLクリック時に収集された広告ID(iOS:IDFA / Android:GAID)と、インストール時にSDKが取得した端末の広告IDを照合します。
    • 確率論的モデリング

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

    We look for the referrer, device ID, and probabilistic modeling data points (in that order) in our click database. If we find a match, we attribute the install to the click. If not, we attribute the install to an organic download.

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

As it follows from this flow, we use attribution links to get information from you, and postbacks to send the information back to you.

 注意

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} Adset Name - provided by the advertiser/publisher. 広告セット名 - 広告主かパブリッシャーにより設定されるもので、広告セットはキャンペーンと広告の間に位置する階層レベルです。詳細
&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です。 The default value is USD.

通貨コードのリスト
&expires={timestamp} アドネットワークがクリックを主張しなくなるUnixのタイムスタンプです。クリック洪水を防止するための、クリック署名の機能で使用します。(詳細)
&signature={signature} クリックの検証と不正を防止するための、HMAC-SHA256形式の署名です。(詳細)