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

アドネットワーク向け | CTV広告によるモバイルアプリのビュースルーアトリビューション

  • 更新

コネクテッドTV(CTV)デバイスで視聴された広告に、モバイルアプリのインストールをアトリビューションします。

アドネットワーク向けCTV広告からモバイルアプリへのアトリビューション

AppsFlyerのクロスプラットフォーム用インプレッションURLを使うと、モバイルアプリのインストールをCTV上で表示された広告にアトリビューションできます。同じ世帯内での複数のインストールを、同一のCTV広告インプレッションにアトリビューションできます。

CTV広告からモバイルアプリへのアトリビューションの流れ

CTV-to-mobileアプリのビュースルーアトリビューションには、OneLinkインプレッションURLを使用します。このURLは、広告主が作成したクロスプラットフォーム用OneLinkテンプレート(テンプレートID付き)に基づくものです。これにより、AndroidアプリとiOSアプリなど、異なるプラットフォームの複数のアプリを1つのURLにまとめられます。

ユーザーがCTV上で広告を視聴した際に、インプレッションURLをリアルタイムでAppsFlyerに送信してください。 

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

コンバージョンが発生するたびに、AppsFlyerから自社にポストバックが送信されます。

この機能は、指定されたパートナーのみ利用できます。利用を希望する場合は、担当のPartner Development Manager(PDM)にお問い合わせください。

CTV-to-mobileアトリビューションの設定

広告主とのCTV-to-mobileアプリのビュースルーアトリビューションを設定するには、次の手順を実行します。

  1. AppsFlyerの連携済みパートナーであり、ポストバックが正しく設定され、AppsFlyerとのCTV-to-mobileアプリの連携テストが完了していることを確認します。
  2. URLに必須パラメータと、必要な追加パラメータが含まれていることを確認します。
  3. ユーザーのIPアドレスとユーザーエージェントをAppsFlyerに送信します。これらは、CTV-to-mobileアプリのビュースルーアトリビューションに必須です。以下のいずれかの方法で送信できます。
    1. インプレッションURLのaf_ipパラメータとaf_uaパラメータで送信します。
    2. リクエストヘッダー内の<X-Forwarded-For>と<User-Agent>で送信します。
パートナー連携のテスト

CTV-to-mobileアプリのビュースルーアトリビューションをテストするには、次の手順を実行します。

  1. 以下のテストアプリを使用します。com.appsflyer.android.deviceid、id1192323960
  2. AppsFlyerのPartner Solutionsチームに連絡し、テスト用URLを入手します。連絡するには、パートナー管理画面にログインし、上部メニューで[Help(ヘルプ)] > [Contact our team(担当チームに問い合わせ)]をクリックします。
    • サンプル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
  3. pidパラメータに指定されているパートナーIDが正しいことを確認します。
  4. af_ipパラメータに自社のテスト環境のIPアドレスを入力します。
  5. af_uaパラメータに自社のテスト環境のユーザーエージェントを入力します。
  6. デスクトップのブラウザーにURLを入力します。
  7. モバイルデバイスでアプリストアを開き、アプリをダウンロードしてインストールし、起動します。
  8. AppsFlyerに新しいインストールが表示され、対応するポストバックも送信されます。インストールが表示されない場合や、ポストバックを受信できない場合は、Partner Solutionsチームにお問い合わせください。
パラメータ

以下のパラメータは、広告主へのアトリビューションデータの提供と計測に使用します。

パラメータ 必須 説明
template_id ✓ OneLinkテンプレートのID。テンプレートには広告主のアプリの基本的なリダイレクト設定が含まれ、ほかのリンクを作成する際の基になります。注意:template_idの値はエンコードしないでください。
pid ✓ 広告を配信するメディアソース(アドネットワーク)に、AppsFlyerが割り当てたパートナー識別子。
af_xplatform ✓
  • 広告主が設定し、リンクがクロスプラットフォームアトリビューションに対応しているかどうかを示します。 
  • 値:true / false
af_xplatform_vt_lookback - インプレッション発生後、アプリのインストールをそのインプレッションにアトリビューションできる期間を、時間単位で設定します。指定できる値:1h~72h(時間)。デフォルトは24hです。
af_ip ✓
  • 広告を表示するCTVデバイスのIPアドレス。 
  • IPアドレスをURLで送信しない場合は、必ずリクエストヘッダーで送信してください。CTV-to-mobileアプリのアトリビューションに必要です。
af_ua ✓
  • 広告を表示するCTVデバイスのユーザーエージェント。
  • ユーザーエージェントをURLで送信しない場合は、必ずリクエストヘッダーで送信してください。CTV-to-mobileアプリのアトリビューションに必要です。
af_source_platform -
  • インプレッションが発生したデバイスのOSを示す、あらかじめ定められた値。 
  • 値:
    • android
    • ios
    • tizen
    • webos
    • smartcast
    • roku
    • windowsphone
    • vidaa
    • PlayStation
    • website
af_source_device_category -
  • インプレッションが発生したデバイスの種類を示す、あらかじめ定められた値。
    • tv
    • mobile_phone
    • desktop
    • tablet
    • set_top_box
    • games_console
    • unknown_device_category
    • media_player

URLに追加できるその他のパラメータについては、アトリビューションリンクの構造とパラメータの記事を参照してください。

仕様と制限事項
項目 説明
アトリビューション期間 ルックバック期間のパラメータaf_xplatform_vt_lookbackに応じて、1~72時間。 
リターゲティング
  • リアトリビューション:クロスプラットフォームからモバイルへのアトリビューションで対応。その他のプラットフォームでは未対応。
  • リエンゲージメント:未対応
アトリビューション方法 確率的モデリング(IPアドレス)を用いたビュースルーアトリビューション
世帯単位のアトリビューション 対応。同じ世帯内での複数のインストールを、同一のCTV広告インプレッションにアトリビューションできます。
パートナー連携のテスト モバイルアプリ間の不正率が高いと判定されたアドネットワーク、または同様の判定を受けた別のメディアソースと関係のあるアドネットワークは利用できません。