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/
必須のpathパラメーター
  • 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 Platform
  • アプリケーションプラットフォームを指定するパスパラメーター。
  • 含まれる値：
    • smartcast
    • tizen
    • roku
    • webos
    • vidaa
    • playstation
    • steam
    • quest
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 
 文字列
app_id App ID
  • 投稿するアプリのアプリIDを指定するパスパラメーター。
  • 例： ap123456
  • アプリIDの値にプラットフォームプレフィックスを追加しないでください。例えば、アプリIDが ap123456 で、プラットフォームが platformX の場合、platformX_ap123456 を app_id の値として使用しないでください。
 文字列
af_media_source Media Source これは、AppsFlyer プラットフォームで定義されている一意のパートナー識別子です。
次の文字は使用できません： ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %		 文字列
af_campaign Campaign キャンペーン名 文字列
af_campaign_id Campaign ID キャンペーンID 文字列
af_request_id N/A パートナーによるリクエストを一意に識別する識別子。 文字列
af_adset Adset 広告セット名 文字列
af_adset_id Adset ID 広告セットID 文字列
af_ad Ad 広告名 文字列
af_ad_id Ad ID 広告ID 文字列
af_campaign_type Campaign Type 以下いずれか：
  • user_acquisition
  • retargeting
 文字列
af_prt Partner
  • 代理店運用のトラフィックと識別するための代理店識別子
  • 注意：代理店権限が有効になっていることを確認する前に、このパラメーターを使用しないでください。
 文字列
af_siteid Site ID

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

 文字列
af_sub_siteid Sub Site ID

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

 文字列
af_click_id 該当無し

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

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

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

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

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

 文字列
af_model Device Model

デバイスモデル

 String型 64文字
af_os_version 該当なし
  • デバイス／OSバージョン
  • 数字とドットのみ使用可能
  • 例：8.1.0
 文字列
af_device_id_type 該当なし

デバイス識別子のタイプ。以下いずれか：

  • vida
  • tifa
  • rida
  • lgudid
  • fire
  • advertising_id
  • fire
  • custom
 文字列
af_device_id_value 該当なし

デバイス識別子のタイプ

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

注記：あなたのリダイレクト許可リストに af_r のURLドメインが含まれていることを確認してください。

 文字列

特性と制限

ルックバック期間 確率論的モデリングでは、クリックとインプレッションに対して24時間の固定ルックバック期間が使用されます。af_lookback_window 値は無視されます。
代理店計測
  • CTV、PC、コンソールからモバイル：対応しています。
  • モバイルからCTV、PC、コンソール：対応していません。