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

CTV・PC・コンソールのダイレクトアトリビューションリンク

  • 更新

概要:CTV、PC、コンソール向けのAppsFlyerアトリビューションリンクの構造とパラメータを説明します。注意:Android PCゲームを含むAndroid・iOSアプリについては、モバイル向けアトリビューションリンクの手順をご覧ください。

概要

CTV、PC、コンソールのダイレクトアトリビューションリンクを使用すると、広告主はユーザーのクリック後にリダイレクトを行い、データを収集できます。ダイレクトアトリビューションリンクは、単一のプラットフォーム上の特定のアプリに対して、リダイレクトとアトリビューションを行うAppsFlyerのリンクです。リダイレクト先は、リンクに含まれるaf_rパラメータの値で指定します。 

注意:Android PCゲームを含むAndroid・iOSアプリについては、モバイル向けアトリビューションリンクの手順をご覧ください。

アトリビューションリンクは、ご自身で直接作成して広告に設定できます。作成方法は、この記事の手順に従ってください。

また、Engagements APIを使用して、S2S経由でリンクを作成することも可能です。この方法では、開発者による作業が必要です。注意:S2S経由で作成したリンクでは、インプレッションデータも収集できます。

アトリビューションリンク

項目 値
ベースURL engagements.appsflyer.com/v1.0/c2s/click/app/
必須のパスパラメータ
  • platform
    例:steam
  • app_id
    例:123456
必須のクエリパラメータ
  • af_media_source
  • af_campaign_id
その他のパラメータ すべてのパラメータを見る
URL構造 https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}
URLの例 https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

パラメータ

パラメータ ローデータ出力およびPull APIでの表示名 説明 データ型
platform プラットフォーム
  • アプリのプラットフォームを指定するパスパラメータ。
  • 指定可能な値:
    • smartcast
    • tizen
    • roku
    • webos
    • vidaa
    • playstation
    • steam
    • quest
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 
文字列
app_id アプリID
  • 送信対象のアプリのアプリIDを指定するパスパラメータ。
  • 例:ap123456
  • アプリIDの値にプラットフォームのプレフィックスを追加しないでください。たとえば、アプリIDがap123456、プラットフォームがplatformXの場合、platformX_ap123456をapp_idの値に指定しないでください。
文字列
af_media_source メディアソース AppsFlyerで定義されているパートナー固有の識別子。
次の特殊文字は使用できません:;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %。
文字列
af_campaign キャンペーン キャンペーン名 文字列
af_campaign_id キャンペーンID キャンペーンID 文字列
af_request_id N/A パートナーからのリクエストを一意に識別するID。 文字列
af_adset 広告セット 広告セット名 文字列
af_adset_id 広告セットID 広告セットID 文字列
af_ad 広告 広告名 文字列
af_ad_id 広告ID 広告ID 文字列
af_campaign_type キャンペーンタイプ

次のいずれか:

  • user_acquisition
  • retargeting
文字列
af_prt パートナー
  • インストールを代理店の成果として計測するための、代理店アカウント名。
  • 注意:代理店の権限が有効になっていることを確認してから、このパラメータを使用してください。
文字列
af_siteid サイトID

広告を表示するパブリッシャーを一意に識別するID。

文字列
af_sub_siteid サブサイトID

広告サブネットワーク / パブリッシャーのID

文字列
af_click_id N/A

アドネットワーク固有のトランザクションID

文字列
af_lookback_window N/A
  • アトリビューションのルックバック期間を日数または時間数で設定します。指定可能なパラメータ値: 
    • クリック:1d~7d(日単位)。
    • インプレッション:1d~7d(日単位)、または1h~23h(時間単位)。
  • 入力形式:上記の形式で最大3文字。
  • デフォルト値は、インプレッションが24時間、クリックが7日です。
文字列
af_ad_placement N/A

アドネットワーク固有のトランザクションID

文字列
af_ad_type 広告タイプ
  • 広告の種類。次の命名規則に従って指定してください。
    • text:検索結果など、テキストのみで構成される広告ユニット
    • banner:デバイス画面の上部または下部に表示される基本的な広告形式
    • interstitial:コンテンツの利用中、区切りのタイミングで表示される全画面広告
    • video:リワードを伴わない通常の動画広告
    • rewarded_video:動画の視聴と引き換えにアプリ内報酬を提供する広告ユニット
    • playable:アプリの操作を試せるインタラクティブなプレビューを含む広告ユニット
    • audio:音声広告
  • 大文字と小文字は区別されます。
文字列
af_channel チャネル

広告が配信されるメディアソース内のチャネル。例:UAC_Search、UAC_Display、Instagram、Meta Audience Networkなど。

文字列
af_model デバイスモデル

デバイスのモデル

文字列(64文字)
af_os_version N/A
  • デバイスのOSバージョン
  • 数字とドットのみ使用できます。
  • 例:8.1.0
文字列
af_device_id_type N/A

デバイス識別子の種類。次のいずれか:

  • vida
  • tifa
  • rida
  • lgudid
  • fire
  • advertising_id
  • fire
  • custom
文字列
af_device_id_value N/A

デバイス識別子の種類

文字列
af_r N/A
  • 対応するアプリストアまたはランディングページへのリンクを指定します。
  • af_rパラメータに含まれる値は、すべてエンコードする必要があります。 UTMパラメータを追加する場合は、その値もエンコードの対象です。

注意:af_rに指定するURLのドメインが、リダイレクト許可リストに含まれていることを確認してください。

文字列

仕様と制限事項

項目 説明
代理店へのアトリビューション
  • CTV・PC・コンソールからモバイルへの誘導では、代理店へのアトリビューションに対応しています。
  • モバイルからCTV・PC・コンソールへの誘導では、代理店へのアトリビューションに対応していません。