CTV、PC和主机端的直接归因链接

推荐用于
最近更新：

概要：  本文针对适用于CTV、PC和主机端的AppsFlyer归因链接，介绍了其结构和参数。请注意：如需了解适用于安卓和iOS应用的归因链接，包括PC端的安卓游戏，请参考移动端归因链接说明。

速览

广告主能通过CTV、PC和主机端的直接归因链接为用户实现跳转，并在点击发生之后收集数据。直接归因链接是一种AppsFlyer链接，支持单平台应用的单平台跳转和归因，跳转后到达的网址通过链接中af_r参数的值来表达。 

请注意：如需了解适用于安卓和iOS应用的归因链接，包括PC端的安卓游戏，请参考 移动端归因链接说明。

您可以直接创建归因链接并将其设置在广告中。如需创建此类链接，请按照本文说明操作。

另外，您也可以使用Engagements API通过S2S的方式创建链接。如选择这种方式，需要引入开发人员协助。请注意：通过S2S的方式创建的链接也可以收集展示数据。

归因链接

归因链接结构
基础链接 engagements.appsflyer.com/v1.0/c2s/click/app/
必须配置的路径参数
  • platform
    示例：steam
  • app_id
    示例：123456
必须配置的查询参数
  • af_media_source
  • af_campaign_id
  • af_r
其他参数 查看所有参数
链接结构 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）
  • 路径参数，用于说明您推广的应用所带的应用ID。
  • 示例：ap123456

字符串
af_media_source Media Source（媒体渠道） AppsFlyer平台所定义的渠道唯一标识符
不支持下列字符：;、*、!、@、#、?、$、^、:、&、~、`、=、+、’、>、<、/、{、}、%。 		字符串
af_campaign Campaign 即广告系列的名称 字符串
af_campaign_id Campaign ID 即广告系列的ID 字符串

af_request_id

不适用

渠道用于识别相关请求的唯一标识符

字符串

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

用于识别子渠道的唯一标识符。

字符串

af_sub_siteid

Sub Site ID

次级广告平台/子渠道的ID。

字符串

af_click_id

不适用

广告平台的交易标识符

字符串

af_lookback_window

不适用
  • 回溯窗口适用于通过ID匹配完成的归因。
  • 回溯窗口期可按天数或小时数自行调整。可用的参数值为：1d-30d（天）或1h-23h（小时）。
  • 请确保：参数值使用上述格式，长度不超过三个字符。
  • 广告展示的默认回溯窗口为24小时，广告点击的默认回溯窗口为7天。

字符串

不适用

广告平台的交易标识符

字符串

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

设备型号

字符串限长64

af_os_version

不适用
  • 设备的操作系统版本
  • 仅可使用数字和句点
  • 示例：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参数值，这些值也需要编码。

字符串

特点与局限性

回溯窗口 概率模型归因中，广告点击和广告展示的回溯窗口固定不变，都是24小时。此时af_lookback_window值会被忽略。
代理归因
  • CTV-PC-主机端到移动端的归因流程支持代理归因，
  • 但移动端到CTV-PC-主机端的归因流程不支持代理归因。