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

アドネットワーク向けアトリビューションリンクの仕様

  • 更新

概要:AppsFlyerと連携するアドネットワークは、本記事の仕様に従ってアトリビューションリンクを設定します。 

アドネットワーク向けアトリビューションリンク

アトリビューションリンクは、ユーザーが広告をクリックしたことをAppsFlyerに通知するために使用します。最も基本的な構成では、広告のリンク先にアトリビューションリンクを設定します。これにより、ユーザーが広告をクリックすると、アトリビューションリンクにアクセスするようになります。

アトリビューションモデル

最初のクリックやインプレッションから、インストールやイベントのアトリビューション、さらにその後までの流れを説明します。

appsflyer-attribution-model-for-partners.png

  1. ユーザーがバナーまたはオファーのリンクをクリックします。
  2. そのバナーまたはリンクから、AppsFlyerのアトリビューションリンクにリダイレクトされます。アトリビューションリンクには、クリック時に収集された情報が入力されます。
  3. AppsFlyerは、アトリビューションリンクから情報を取得し、データベースに保存します。
  4. アプリがインストールされ、初めて起動されます。アプリ内のAppsFlyer SDKが、インストール先のデバイス情報をAppsFlyerのサーバーに送信します。
  5. AppsFlyerは、以下のアトリビューション手法を使用して、このデータをクリックのデータベースと照合します。
    • リファラマッチング
      Androidデバイスに固有のアトリビューション手法です。ユーザーがリンクをクリックしてGoogle Playにリダイレクトされると、Google Playが一意のリファラIDを付与します。インストール時に、AppsFlyerはデバイスからこのIDを取得します。その後、Google Playの記録と照合します。
    • デバイスIDマッチング
      クリック時に取得したデバイスID(iOSはIDFA、AndroidはGAID)を、インストールしたデバイスのIDと照合します。
    • 確率論的モデリング

    アトリビューション手法の詳細を参照してください。

    クリックのデータベースで、リファラ、デバイスID、確率論的モデリングに使用するデータの順に、一致する情報を探します。一致するデータが見つかった場合、そのクリックをインストールのアトリビューション先とします。一致するデータが見つからなかった場合、オーガニックのインストールとして扱います。

  6. インストールのアトリビューション先が決まると、コンバージョンの詳細を含むポストバックがアドネットワークに送信されます。

このように、AppsFlyerはアトリビューションリンクでアドネットワークから情報を受け取り、ポストバックで計測結果を返します。

 注意

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} クリックID。アドネットワークで発生するクリックごとに付与する、一意の識別子です。
&advertising_id={gaid}または
&idfa={IDFA}
クリックが発生したデバイスのID。AndroidはGAID、Appleのデバイスは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、EUR)。デフォルトはUSDです。
通貨コードの一覧。
&expires={timestamp} アドネットワークがクリックを有効と認める期限を示すUNIXタイムスタンプ。クリック不正を防ぐためのクリック署名に使用します。詳細はこちら
&signature={signature} クリックを検証し、不正を防ぐためのHMAC-SHA256署名。詳細はこちら