1. 提供的功能

神策广告分析支持通过生成「监测链接」采集公域广告行为数据，使用「神策SDK」采集私域用户行为数据，并将二者进行归因匹配，实现公私域数据打通。


渠道推广流程示例见下图：

媒体渠道：特指媒体广告投放平台，如腾讯广告、字节-巨量引擎、百度营销平台等，通常需广告主开通账户付费推广，具备广告监测、转化回传能力。

2. 监测链接

了解神策监测链接以及其上拼接的参数，可以帮助使用者更好的分析公域采集数据，定位数据问题。下面将分别介绍神策广告分析-渠道推广功能中各链接参数的含义。

2.1. 参数类型说明及示例

在监测/推广链接中，除了头部地址是神策服务器域名或客户服务器域名地址外，其余部分（?后边的部分）均由参数组成。详见下表：

参数类型作用定义方式是否支持客户调整备注
固定参数用于判断执行哪条神策归因数据流分支，包括环境参数、渠道信息参数、深度回传参数由神策定义客户创建链接时后台根据不同设置方案自动生成，生成后不可调整神策业务逻辑
宏参数用于接收媒体客户端返回的单次曝光/点击事件的信息，包括设备相关信息、广告相关信息等由神策定义媒体在每次曝光/点击发生时直接替换宏参数value值，客户不可调整渠道业务逻辑
utm参数用于客户自定义标识监测链接，神策提供5个常用信息预设为utm参数，供客户直接使用由神策定义客户根据自身需要，自行定义，并在创建一条监测链接时即绑定一个固定的value客户业务逻辑
自定义参数当5个预设utm参数无法满足标识诉求时，由客户根据业务场景自行新增参数、定义由用户自定义客户根据自身需要，自行新增，并在创建一条监测链接时即绑定一个固定的value



点击监测链接示例（请勿直接使用）：

https://satetedataflow.debugbox.sensorsdata.cn/ad/track?channel_name=baidu_sem_track&channel_link_type=app&hash_key=9Y7pDLTJZNEWa9DhR2cJ&callback_id=cz0LfEmn&_channel_app_id=cn.sensorscloud.calendar&_data_version=0.4.0&callbacks=%24AppInstall%2Cregister&project=production&_channel_track_key=kbY0bv8O&link_version=1&channel_keyword_id={{WORDID}}&os={{OS}}&ip={{IP}}&ua={{UA}}&channel_account_id={{USER_ID}}&channel_campaign_id={{PLAN_ID}}&callback_url={{CALLBACK_URL}}&channel_click_id={{CLICK_ID}}&click_time={{TS}}&channel_ad_id={{IDEA_ID}}&imei={{IMEI_MD5}}&model={{DEVICE_INFO}}&android_id={{ANDROID_ID_MD5}}&oaid={{OAID}}&channel_adgroup_id={{UNIT_ID}}&channel_utm_source=baidu&tuiguang_name=xiaoming

其中，各部分分别为：

1、神策服务器域名地址：https://satetedataflow.debugbox.sensorsdata.cn/ad/track

  • ?符号前边的内容
  • 请勿随意修改

2、固定参数：channel_name=baidu_sem_track&channel_link_type=app&hash_key=9Y7pDLTJZNEWa9DhR2cJ&callback_id=cz0LfEmn&_channel_app_id=cn.sensorscloud.calendar&_data_version=0.4.0&callbacks=%24AppInstall%2Cregister&project=production&_channel_track_key=kbY0bv8O&link_version=1

  • 以&符号分隔，神策广告数据流中将会使用，请勿随意修改

3、宏参数：channel_keyword_id={{WORDID}}&os={{OS}}&ip={{IP}}&ua={{UA}}&channel_account_id={{USER_ID}}&channel_campaign_id={{PLAN_ID}}&callback_url={{CALLBACK_URL}}&channel_click_id={{CLICK_ID}}&click_time={{TS}}&channel_ad_id={{IDEA_ID}}&imei={{IMEI_MD5}}&model={{DEVICE_INFO}}&android_id={{ANDROID_ID_MD5}}&oaid={{OAID}}&channel_adgroup_id={{UNIT_ID}}

  • 带双括号大写字母的参数字段即为宏参数，以&符号分隔；部分渠道为双下划线格式，例如"__OAID__"。
  • 通过宏参列表我们可以看出，该条监测链接可以接收关键词ID、OS、IP、UA、账户id、广告id、回传地址、点击id、点击时间、创意id、MD5加密的IMEI号等多种信息，其中IP、UA与设备号相关尤为重要，可用于点击归因

4、utm参数：channel_utm_source=baidu

  • 以&符号分隔，形如channel_utm_xxx共5个，通常用于人工事先标记该链接的投放渠道或计划。
  • 当宏参中无对应渠道计划字段、客户有其他自定义标识诉求时推荐使用。

5、自定义参数：tuiguang_name=xiaoming

  • 以&符号分隔，无固定格式。
  • 当5个utm参数无法满足客户诉求时，支持客户创建自定义参数进行标识（不得与其他参数重名）。如utm参数中无关于创建人的标识，可自定义tuiguang_name参数，赋值xiaoming，来标识该链接创建人为xiaoming。
  • 需注意，创建自定义参数将在数据库中自动创建相同的属性，请妥善管理权限，勿随意创建，以免污染数据仓库。

2.2. 固定参数

参数分类神策链接参数参数描述预置事件属性
SAT环境参数project项目名称，不同项目取值不同
渠道信息参数



channel_name渠道名称，不同渠道取值不同$channel_name
channel_link_type渠道类型，枚举值包括app、web$channel_link_type
_channel_track_key链接唯一标识，入库时变成channel_link_id$channel_link_id
_channel_app_id（仅应用）应用唯一标识，不同应用取值不同$app_id

exposure_event（仅曝光）

是否支持曝光监测，仅在渠道支持曝光监测时会有该参数且取值为true
sat_cf（仅网页）渠道投放链接标识，用户sdk判断，sat_cf=1为单次会话归因；sat_cf=2为用户归因
link_versionchannel_utm_xxx启用标识，仅在开启channel_utm_xxx时会有该参数且取值为1
深度回传参数callbacks回传事件标识，用于校验各种转化事件触发后是否回传
hash_key映射akey，不同账号不同akey值，用于callback回传时生成签名值SIGN

2.3. 宏参数介绍

参数分类神策链接参数参数描述

预置事件属性

仅点击事件上报时携带

举例：巨量引擎举例：百度信息流
渠道信息参数channel_account_id

渠道账号结构中最高层级，各种渠道命名不同，有账户 ID、广告账号ID、广告主ID等

$channel_account_id__ADVERTISER_ID__{{USER_ID}}
channel_account_name

渠道账号结构中最高层级，各种渠道命名不同，有账户名称、广告账号名称、广告主等

$channel_account_name

channel_campaign_id

渠道账号结构中第二层级，各种渠道命名不同，有推广计划ID、广告系列D、任务ID等

$channel_campaign_id__CAMPAIGN_ID__{{PLAN_ID}}
channel_campaign_name 

渠道账号结构中第二层级，各种渠道命名不同，有推广计划、广告系列、广告计划、任务名等

$channel_campaign_name__CAMPAIGN_NAME__
channel_adgroup_id

渠道账号结构中第三层级，各种渠道命名不同，有推广单元ID、推广组ID、广告组ID等

$channel_adgroup_id__AID__{{UNIT_ID}}
channel_adgroup_name

渠道账号结构中第三层级，各种渠道命名不同，有推广单元、推广组、广告组等

$channel_adgroup_name__AID_NAME__
channel_ad_id

渠道账号结构中最小层级，各种渠道命名不同，有广告创意ID、创意ID等

$channel_ad_id__CID__{{IDEA_ID}}
channel_ad_name

渠道账号结构中最小层级，各种渠道命名不同，有物料、创意等

$channel_ad_name__CID_NAME__
channel_keyword_id

渠道账号结构中最小层级，各种渠道命名不同，有关键词ID、关键字ID等

$channel_keyword_id

channel_keyword

渠道账号结构中最小层级，各种渠道命名不同，有关键词、关键字等

$channel_keyword

channel_click_id

点击唯一 ID

$channel_click_id__REQUEST_ID__{{CLICK_ID}}
channel_click_time

客户端发生广告点击事件的时间，，以毫秒为单位时间戳。样例：1575194434000

$channel_click_time__TS__{{TS}}
深度回传参数callback_url

事件回传接口URL


__CALLBACK_URL__{{CALLBACK_URL}}
callback_key事件回传唯一标识


设备标识参数os

操作系统类型，如Android，IOS等


__OS__{{OS}} 
model

手机型号，如iPhone12,2 (urlencode之后为iPhone12%2c2)，iPhone X (urlencode之后为iPhone+X)，SM-A750GN (urlencode之后为SM-A750GN)


__MODEL__
imei（仅安卓）

安卓设备标识，渠道提供宏变量（或参数）满足如下条件即可填写至右侧，优先考虑原值

1.原值为小写，15位

2.原值保持小写，原值MD5加密后小写，32位

$ios_install_source__IMEI__{{IMEI_MD5}}
android_id（仅安卓）

安卓 ID，渠道提供宏变量（或参数）满足如下条件即可填写至右侧，优先考虑原值

1.原值为小写

2.原值保持小写，MD5加密后小写，32位

3.原值转成大写，MD5加密后小写，32位

__ANDROIDID__{{ANDROID_ID_MD5}}
oaid（仅安卓）

Android Q 及更高版本的设备号，渠道提供宏变量（或参数）满足如下条件即可填写至右侧，优先考虑原值

1.原值为小写，32位

2.原值保持小写，MD5加密后小写，32位

__OAID__{{OAID}}
idfa（仅苹果）

IOS 6+的设备ID字段，渠道提供宏变量（或参数）满足如下条件即可填写至右侧，优先考虑原值

1.原值为大写，32位

2.原值保持大写，MD5加密后小写，32位

3.原值保持大写，MD5加密后大写，32位

__IDFA__{{IDFA}} 
idfv（仅苹果）Vendor标识用户ID，渠道提供宏变量（或参数）满足如下条件即可填写至右侧，优先考虑原值

caid1（仅苹果）

20200901版本的中国广告协会互联网广告标识



caid2（仅苹果）20201230版本的中国广告协会互联网广告标识__CAID2__
ip

媒体投放系统获取的用户终端的公共IPv4地址。

样例：61.158.146.195或240e:398:1c90:9d00:5513:b9c9:650a:d9d2

$ip__IP__{{IP}} 
ua

用户代理(User Agent)，一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。

样例：News+7.4.5+rv%3A7.4.5.23%5C%28iPhone%3B+iOS+12.4.1%3B+zh_CN%5C%29Cronet


__UA__{{UA}}

2.4. UTM参数介绍

神策广告预置了5个UTM参数用于支持用户对推广/监测链接进行标记。用户可通过这5个参数区分广告活动、广告来源、广告媒介、广告字词、广告内容，也可以根据实际业务需要自行定义5个参数的用途。

神策广告最新UTM参数对应老的UTM参数参数描述备注

channel_utm_campaign

utm_campaign广告系列活动，用来标记特定的产品促销活动或战略性广告系列，例如周末活动，双11大促等仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_campaign 虚拟属性查询
channel_utm_sourceutm_source广告系列来源，用来标记流量来源，例如weibo、weixin、edm等仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_source 虚拟属性查询

channel_utm_medium

utm_medium广告系列媒介，用来标记广告营销媒介，例如banner、feeds、pre-roll等仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_medium  虚拟属性查询

channel_utm_term

utm_term广告系列字词，用来标记广告关键词，主要用于 SEM 投放仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_term 虚拟属性查询
channel_utm_contentutm_content广告系列内容，用来标记广告创意，主要用于 A/B 测试，标记同一广告间细微差别仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_content 虚拟属性查询


需注意：参数值请尽量使用英文字符，中文字符转义后通常较长，易导致链接超长。（媒体平台通常会限制链接长度，过长容易造成无法填写、截断、跳转失效等异常。）

特殊用法

用户可以使用UTM参数接收媒体侧已提供，但神策暂未接收的参数字段。

例如：巨量引擎点击监测支持提供广告投放位置信息，对应的参数为__CSITE__，其值含义为见下，神策暂未接收该字段信息。

今日头条：1-10000，80000-110001
西瓜视频：10001-10099
火山小视频：30001-30099
抖音：40001-40099
番茄小说：26001-26099
穿山甲开屏广告：800000000
穿山甲网盟非开屏广告：900000000
通投广告位：33013
搜索：38016

可在任意UTM参数中填写该通配符，已达到接收广告投放位置信息的目的。

如，在channel_utm_medium中填写参数__CSITE__，即可接收该字段。看数时，即可使用channel_utm_medium字段的值来区分用户来自巨量的哪个广告投放位置。

2.5. 自定义参数介绍 

若预置的5个UTM参数仍不能满足客户业务需要，神策广告也支持客户新建自定义参数。

即，在创建监测链接时即绑定一个固定的key，并对其赋值。自定义参数key与value不能与固定参数、宏参数、utm参数的命名重复。

需注意：参数值请尽量使用英文字符，中文字符转义后通常较长，易导致链接超长。（媒体平台通常会限制链接长度，过长容易造成无法填写、截断、跳转失效等异常。）

在神策广告中，自定义参数与UTM参数本质相同，差别只是前者为客户按需新建，后者为神策广告预置。

自定义参数也支持UTM参数接收其他媒体字段信息的特殊用法。

需注意，如需使用自定义参数，强烈建议打开自定义参数弱校验开关，详见 推广使用指南

3. 转化回传

3.1. 什么是转化回传

转化回传是基于效果广告投放场景下，服务于oCPX广告投放的特殊产品功能。

对于严格考核广告转化效果（如激活成本、ROI）的客户，主流媒体平台大多提供了oCPM、oCPC的广告投放能力，以帮助效果广告主更好的优化广告成本。

  • 对于媒体方而言：只有用户点击广告的数据，没有广告主自身产品相关的转化数据。媒体想要做到整体漏斗分析与算法模型优化，于是开放了点击监测（部分媒体）与转化回传的接口，支持广告主将转化数据与点击归因后上报至媒体，以用于广告模型的优化，控制广告成本。
  • 对于广告主而言：只有自身产品相关转化数据，没有广告点击数据，无法实现用户粒度全链路漏斗打通。广告主需要具备接收广告点击、完成广告归因、回传转化数据的能力，才能利用媒体的oCPX能力优化自身广告成本。

3.2. 神策提供何种回传能力

针对不同推广内容类型，以及已对接的不同媒体渠道，神策广告提供了强大的自定义回传能力，包括以下几个方面：

1、自定义回传窗口期：可按照拉新、拉活两个场景，按渠道灵活配置回传窗口期。

2、自定义异常回传配置：可自助开启/关闭异常情况下是否自动补回传；若开启自动补回传，可配置补回传的窗口期。

3、自定义回传事件映射：可自定义配置回传事件映射，根据业务诉求灵活配置回传事件。（例如，将注册事件当做激活事件回传给媒体）

4、自定义筛选事件属性： 可筛选特定设备、特定时间、特定位置触发事件时，回传媒体指定的事件。（例如，筛选指定商品付费时，才回传该用户的付费事件）

5、自定义回传付费金额：对于支持回传付费金额的媒体，可灵活选择是否回传金额，以及回传金额对应的属性和单位。

6、控制回传事件频次：支持首次回传、每次回传两种方式，控制指定事件回传的频次

详细功能使用见 回传配置


原则上，除非对接媒体有特殊要求，神策广告仅在用户触发指定事件时，通过回传事件标识的方式告知媒体“谁完成了什么转化行为”，不会直接回传用户设备或额外的属性信息。

示例

例如，腾讯广告平台APP转化回传功能规定：广告主回传时，需往点击监测中提供的“每次点击唯一的CALLBACK_URL”地址中，回传事件标识 action_type。

当用户激活APP时，神策APP SDK将触发激活事件，神策广告将完成激活事件的归因。此时，根据回传配置，神策广告将向此次广告点击接收的“唯一CALLBACK_URL”地址中，回传 action_type=ACTIVATE_APP 字段。

于是，腾讯广告平台可以通过关联“唯一CALLBACK_URL”地址所对应的用户，来定位“哪一个用户完成了激活行为”。


在上述流程中，除非平台有特殊要求，神策不会将用户激活的设备号、激活的地域等其他额外信息回传给腾讯。（仅做释义，实际腾讯广告仍有其他的回传要求）

3.2.1. APP转化回传

支持广告主推广APP时，当用户触发APP客户端事件后，神策广告实时回传媒体转化事件。

APP客户端事件：由 Android 或 iOS SDK 上报，通常包括激活、唤醒、按钮点击、页面浏览等行为。

以下为常用行为事件举例：

  • 激活：用户安装后首次打开APP时上报，对应$AppInstall/AppInstall预置事件，请勿变更修改。
  • 唤醒：用户点击Deeplink链接后直接打开APP时上报，对应$AppDeeplinkLaunch预置事件，请勿变更修改。
  • 留存：用户激活后第2天打开APP时上报次日留存，第7日打开APP时上报7日留存，对应的留存事件为神策根据打开APP与激活的日期间隔计算，同时也支持自定义上报的留存事件。

对于首次通过渠道链接激活/唤醒APP的用户，若用户后续再次打开APP，神策支持通过用户id将其与首次激活关联，并将其后续转化行为均标记为来自首次激活的渠道，并回传相应的媒体转化事件。

3.2.2. 网页转化回传

支持广告主推广网页时，当用户触发网页客户端事件后，神策广告实时回传媒体转化事件。

客户端事件：由Web JS SDK 上报，通常包括页面打开、页面浏览、按钮点击、表单提交等行为。

以下为常用行为事件举例：

  • $ChannelLinkReaching：H5渠道链接触达时上报（当链接中含sat_cf参数时，判定为H5渠道链接），$lib预置属性为web，请勿变更修改。
  • 页面浏览：用户打开H5链接时触发，对应$PageView事件。

对于首次通过渠道链接访问网页的用户，若其再次通过主动搜索或用户分享等自然流量的方式，访问同一个域名的网页，神策支持通过用户id将其与首次访问关联，并将其后续转化行为均标记为来自首次访问的渠道，并回传相应的媒体转化事件。

3.2.3. 微信小程序转化回传

支持广告主推广微信小程序时，当用户触发微信小程序客户端事件、微信小程序内嵌网页端事件后，神策广告实时回传媒体转化事件。

小程序客户端事件：由小程序 SDK 上报，通常包括小程序启动、小程序页面浏览、按钮点击、表单提交等行为。

以下为常用行为事件举例：

  • $ChannelLinkReaching：小程序渠道链接触达时上报（当页面路径中含sat_cf时，判定为小程序渠道链接），$lib预置属性为miniprogram，请勿变更修改。
  • 小程序启动：小程序冷启动打开时上报，对应$MpLaunch事件。

小程序内嵌网页端事件：特指当用户打开小程序内嵌网页时，在网页上触发的由Web JS SDK上报的事件，通常包括页面浏览（$PageView）、按钮点击、表单提交等行为。该部分网页上报事件将视作由小程序渠道带来，可按照小程序推广渠道进行归因关联，并回传给应渠道。

对于首次通过渠道链接访问小程序的用户，若其在微信中直接再次打开访问相同小程序，神策支持通过用户id将其与首次访问关联，并将其后续转化行为均标记为来自首次访问的渠道，并回传相应的媒体转化事件。

3.2.4. 服务端事件转化回传

除上述三类客户端事件转化回传外，神策广告进一步支持了当用户触发服务端事件后，关联对应的客户端归因事件，并实时回传媒体转化事件。

服务端事件：由 Java、C++、Python等 SDK 上报，通常包括付费、授信成功等行为。

由于三类客户端用户行为均有可能产生相同的服务端事件（例如，用户在APP/网页/小程序上均有可能产生付费成功的行为；希望将用户在小程序上产生，服务端上报的付费成功事件，按照小程序推广渠道进行回传），为了确保服务端事件回传准确，广告主需在上报服务端事件时，携带该事件来自哪个客户端的预置属性。神策广告将根据该预置属性与对应客户端的归因事件进行关联，并回传至对应媒体。

服务端事件上报具体要求如下：

1、携带预置属性$is_channel_callback_event，启用回传时必须携带，枚举值含义如下：

  • 首次上报：$is_channel_callback_event == true
  • 非首次上报：$is_channel_callback_event == false

2、携带预置属性$ad_custom_data_type，枚举值如下：

  • 关联APP端：上报 $ad_custom_data_type == app
  • 关联网页端：上报 $ad_custom_data_type == web
  • 关联微信小程序端：上报 $ad_custom_data_type == mp

3、携带预置属性$app_id，当希望关联APP、微信小程序时必须携带，用于关联对应的推广内容。

$is_channel_callback_event、$app_id更多介绍详见：回传配置 中 特殊事件属性调用方法

需注意，服务端事件作为深度转化事件，神策同样使用用户id（userid）将其与客户端归因事件进行关联，并回传相应的媒体转化事件。若服务端事件用户id与客户端归因事件不同，将导致关联回传失败。