CTV、PC、コンソールプラットフォームの直接アトリビューションリンク

推奨
最終更新日：

概要：  CTV、PC、コンソール プラットフォーム向けの AppsFlyer アトリビューションリンク構造とパラメーターについて学習します。注意：Android および iOS アプリ（Android PC ゲームを含む）の場合は、 モバイルアトリビューションリンクの手順を使用します。

概要

CTV、PC、コンソール プラットフォームの直接アトリビューションリンクを使用すると、広告主はユーザーをリダイレクトし、クリック後にデータを収集できます。ダイレクトアトリビューションリンクは、一度に1つのプラットフォーム上の1つのリンク先を持つアプリに対するリダイレクトとアトリビューションをサポートする、AppsFlyer のリンクです。リダイレクト先は、リンクに含まれる af_r パラメーターの値です。 

注：Android および iOS アプリ（Android PC ゲームを含む）の場合は、 モバイルアトリビューションリンクの手順を使用します。

アトリビューションリンクは、直接作成して広告の背後に配置することができます。このようなリンクを作成するには、この記事の手順に従ってください。

あるいは、 エンゲージメント APIを使用して S2S 経由でリンクを作成することもできます。これにはデベロッパーの作業が必要です。注意：S2S 経由で作成されたリンクでもインプレッションデータを収集できます。

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

アトリビューションリンク構造
ベースURL engagements.appsflyer.com/v1.0/c2s/click/app/
必須パパラメーター
  • プラットフォーム
    例：steam
  • app_id
    例：123456
必須のクエリパラメーター
  • af_media_source
  • af_campaign_id
  • af_r
その他のパラメーター すべてのパラメーターを表示
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

パラメーター名

パラメーター ローデータのエクスポートとプルAPI での表示名 説明 フィールドタイプ
プラットフォーム プラットフォーム
  • アプリケーションプラットフォームを指定するパスパラメーター。
  • 想定値：
    • smartcast
    • tizen
    • Roku
    • webos
    • vidaa
    • プレイステーション
    • steam
    • クエスト
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 

文字列
app_id アプリ ID
  • 投稿するアプリのアプリ ID を指定するパス パラメーター。
  • 例: ap123456

文字列
af_media_source メディアソース これは、AppsFlyer プラットフォームで定義されている一意のパートナー識別子です。
次の文字は使用できません： ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, % 		文字列
af_campaign キャンペーン キャンペーン名 文字列
af_campaign_id キャンペーン ID キャンペーン ID 文字列

af_request_id

N/A

パートナーによるリクエストを一意に識別する識別子。

文字列

af_adset

 広告セット

広告セット名

文字列

af_adset_id

広告セットID

広告セットID

文字列

af_ad

広告

広告名

文字列

af_ad_id

広告ID

広告ID

文字列

af_campaign_type

キャンペーンタイプ

以下のいずれかから選択してください。

  • user_acquisition
  • リターゲティング

文字列

af_prt

パートナー
  • インストールを代理店にアトリビュートさせるための代理店アカウント名
  • 注意：代理店権限が有効になっていることを確認する前に、このパラメーターを使用しないでください。

文字列

af_siteid

サイトID

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

文字列

af_sub_siteid

サブサイトID

アドネットワークのサブネットワーク/パブリッシャーID

文字列

af_click_id

該当無し

広告ネットワーク固有のトランザクション識別子

文字列

af_lookback_window

該当無し
  • ルックバック期間は、ID マッチングによるアトリビューションに関連します。
  • ルックバック期間のアトリビューション期間に設定可能な日数/時間数。使用可能なパラメーター値：1d-30d (日数) または 1h-23h (時間数)。
  • 検証：上記のスキームを使用すると、最大3文字になります。
  • デフォルト値は、インプレッションの場合は24時間、クリックの場合は7日です。

文字列

該当無し

広告ネットワーク固有のトランザクション識別子

文字列

af_ad_type

広告タイプ
  • 広告タイプ。以下の命名規則を利用してください：
    • テキスト：テキストのみを含む広告ユニット(例：検索結果など）
    • バナー：画面の上部または下部に表示される基本フォーマット
    • インタースティシャル： 画面閲覧中に差し込まれる、インターステシャル広告
    • ビデオ： リワード広告ではない通常の動画広告
    • rewarded_video: 動画視聴と引き換えにアプリ内報酬を提供するリワード動画広告
    • プレイアブル： 実際のアプリ操作が一部可能な、インタラクティブな広告
    • オーディオ： 音声広告
  • 大文字と小文字の区別を強制します。

文字列

af_channel

チャネル

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

文字列

af_model

デバイスモデル

デバイスモデル

String型 64文字

af_os_version

該当無し
  • デバイス／OSバージョン
  • 数字とドットのみ使用可能
  • 例：8.1.0

文字列

af_device_id_type

該当無し

デバイス識別子のタイプ。以下のいずれかから選択してください。

  • vida
  • tifa
  • rida
  • lgudid
  • 火
  • advertising_id
  • 火
  • カスタム

文字列

af_device_id_value

該当無し

デバイス識別子のタイプ

文字列

af_r

該当無し
  • 必須
  • 正しいアプリストアまたはランディングページへのリンクが含まれています
  • af_r パラメーター内のすべてをエンコードする必要があります。これには、UTM パラメーター値（追加されている場合）も含まれます。

文字列

特性と制限

確率論的モデリングでは、クリックとインプレッションに対して24時間の固定ルックバック期間が使用されます。af_lookback_window 値は無視されます。