CTVからのアプリインストール計測：アドネットワーク向け

推奨
アドネットワーク
最終更新日：
概要： モバイルアプリのインストールをCTVデバイスで表示した広告にアトリビューションします。

CTVからのアプリインストール計測：アドネットワーク向け

AppsFlyerクロスプラットフォームのインプレッション計測リンクを使用すると、モバイルアプリのインストール数を CTVに表示される広告に紐付けることができます。
同一世帯内での複数インストールは、同じCTV広告のインプレッションに起因することがあります。

50310_CTV_flow_chart__2_.jpg

CTVからのアプリインストールのビュースルー計測では、広告主が作成したクロスプラットフォーム用のOneLinkテンプレート（テンプレートID付き）を使用したOneLinkのインプレッションURLを使用します。これにより広告主は、異なるプラットフォームの複数アプリ（例えば、AndroidとiOSの両方のアプリ）を1つのURLで計測することができます。

エンドユーザーがCTV上で広告に接触した際に、AppsFlyerに対して以下のようなインプレッションURL経由でリアルタイムにデータを送信するように設定してください。

サンプルURL：

https://impressions.onelink.me/{template_id}?pid=__media_source__&af_xplatform=true&af_xplatform_vt_lookback=24h&af_siteid=__CSITE__&c=__CAMPAIGN_NAME__&af_channel=__PLACEMENT__&af_c_id=__CAMPAIGN_ID__&af_adset=__AID_NAME__&af_adset_id=__AID__&af_ad=__CID_NAME__&af_ad_id=__CID__&af_source_platform=__source_platform__&af_source_device_category=__device_category__&af_ad_type=__CTYPE__&af_ip=__IP__&af_ua=__UA__&redirect=false

そうすることで、各インストール後に適宜ポストバックが送信されるようになります。

セットアップ

広告主がCTV-to-モバイルアプリへのビュースルーアトリビューションを設定するには：

  1. AppsFlyerの連携済みパートナーであること、ポストバックが適切に設定されていること、 CTVからモバイルアプリへのAppsFlyerへの連携のテストを完了していることを確認してください。
  2. 計測URLに以下に記載の必須パラメータと、その他貴社側で必要なパラメータがそれぞれ追加されている / 含まれていることを確認してください。
  3. CTV計測に必要なので、以下のいずれかの方法でユーザーのIPアドレスとユーザーエージェントを送信してください：
    1. インプレッションURL上のaf_ipとaf_ua のパラメータへ渡す。
    2. リクエスト時のヘッダー内の<X-Forwarded-For>と<User-Agent>のパラメータへ渡す。

パートナー連携のテスト

CTVからモバイルアプリへのビュースルーアトリビューションをテストするには：

  1. 次のテストアプリを使用してください： com.appsflyer.android.deviceid および id1192323960
  2. AppsFlyerパートナーソリューションチームに連絡して、テストURLを受け取ります（パートナー ダッシュボードにログインし、ヘルプ > チームに連絡をクリックします）。
    • サンプルURL: https://impressions.onelink.me/dfHa?pid=partner_int&c=test_1&af_xplatform=true&af_xplatform_vt_lookback=24h&af_ip=MACRO&af_ua=MACRO&redirect=false&af_engagement_type=engaged_view
  3. パラメーターの pid パートナーID が正しいことを確認します。
  4. パラメータの af_ip IP アドレスを入力します。
  5. パラメータの af_ua ユーザエージェントを入力します。
  6. デスクトップブラウザーにURLを入力します。
  7. モバイルデバイスで、アプリストアにアクセスし、アプリをダウンロード、インストール、起動します。
  8. 新しいインストールがAppsFlyer管理画面で計上され、対応するポストバックが表示されます。インストールが表示されない場合、またはポストバックを取得できない場合は、パートナーソリューションチームにお問い合わせください。

パラメーター

以下の各パラメータは、 広告主へ成果計測と計測データを提供する上で必要なものになります。

パラメーター 必須 説明
template_ID ✓ 広告主側で設定したOneLinkテンプレートのIDです。テンプレートIDには、広告主アプリの基本的なリダイレクトの設定が含まれており、計測リンクを作成する上での基盤として機能します。
pid ✓

メディアソース毎に発行されている、ユニークなAppsFlyer上の識別子です。
af_xplatform ✓
  • その計測リンクが、クロスプラットフォームでの計測をサポートしているかどうかを示すためのパラメータで、広告主によって設定されます。
  • 値：true / false
af_xplatform_vt_lookback -

アプリのインストールをCTV上でのインプレッションに紐付けるルックバック期間を設定可能で、デフォルト設定は24時間です。
設定可能な値：1h - 72h (時間)。デフォルトは24hです。
af_ip ✓
  • 広告を表示したCTV端末のIPアドレスを送信してください。
  • URLのパラメータ経由で送信されない場合には、リクエストのヘッダーで必ず送信してください。
af_ua ✓
  • 広告を表示したCTV端末のユーザーエージェントを送信してください。
  • URLのパラメータ経由で送信されない場合には、リクエストのヘッダーで必ず送信してください。
af_source_platform -
  • インプレッションが発生した端末のOSの情報を以下のリストから選択して送信可能です。
  • 値：
    • android
    • iOS
    • tizen
    • webos
    • smartcast
    • Roku
    • Windows Phone
    • vidaa
    • PlayStation
    • smartcast
    • website
af_source_device_category -
  • インプレッションが発生した端末の種別の情報を、以下のリストから選択して送信可能です。
    • テレビ
    • mobile_phone
    • desktop
    • タブレット
    • set_top_box
    • game_console
af_engagement_type -
  • 広告に対するユーザーのエンゲージメントレベル(広告接触レベル)を送信可能です。
  • 広告が表示されたタイミングでは通常のインプレッション URLを送信し、広告が10秒間 (短い動画の場合には5秒間) 表示された後には af_engagement_type=engaged_view のパラメータを追加した別のインプレッション URL を送信することをおすすめしています。

計測URLに追加可能なその他のパラメータについては、計測リンクとパラメータの記事を参照してください。

特性と制限

特性 備考
アトリビューション期間 1〜72 時間
ルックバック期間のパラメーター af_xplatform_vt_lookbackの設定により異なります。
リターゲティング サポートされていません
アトリビューション方法 確率論的モデリング(IPアドレス)によるビュースルー計測
世帯アトリビューション サポート対象
つまり、同じ世帯内で複数のインストールが行われた場合は、同じCTV広告インプレッションに起因する可能性があります。
パートナー連携のテスト モバイルアプリ間不正の割合が高いとの指摘を受けているアドネットワークや、他の異なる指摘を受けているメディアソースと提携しているアドネットワークではご利用いただけません。