提供的功能
神策广告分析支持通过生成「监测链接」采集公域广告行为数据，使用「神策SDK」采集私域用户行为数据，并将二者进行归因匹配，实现公私域数据打通。
渠道推广流程示例见下图：
媒体渠道：特指媒体广告投放平台，如腾讯广告、字节-巨量引擎、百度营销平台等，通常需广告主开通账户付费推广，具备广告监测、转化回传能力。
监测链接
了解神策监测链接以及其上拼接的参数，可以帮助使用者更好的分析公域采集数据，定位数据问题。下面将分别介绍神策广告分析-渠道推广功能中各链接参数的含义。
参数类型说明及示例
在监测/推广链接中，除了头部地址是神策服务器域名或客户服务器域名地址外，其余部分（?后边的部分）均由参数组成。详见下表：
| 参数类型 | 作用 | 定义方式 | 是否支持客户调整 | 备注 |
|---|---|---|---|---|
| 固定参数 | 用于判断执行哪条神策归因数据流分支，包括环境参数、渠道信息参数、深度回传参数 | 由神策定义 | 客户创建链接时后台根据不同设置方案自动生成，生成后不可调整 | 神策业务逻辑 |
| 宏参数 | 用于接收媒体客户端返回的单次曝光/点击事件的信息，包括设备相关信息、广告相关信息等 | 由神策定义 | 媒体在每次曝光/点击发生时直接替换宏参数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。
- 需注意，创建自定义参数将在数据库中自动创建相同的属性，请妥善管理权限，勿随意创建，以免污染数据仓库。
固定参数
| 参数分类 | 神策链接参数 | 参数描述 | 预置事件属性 |
|---|---|---|---|
| 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_version | channel_utm_xxx启用标识，仅在开启channel_utm_xxx时会有该参数且取值为1 | ||
| 深度回传参数 | callbacks | 回传事件标识，用于校验各种转化事件触发后是否回传 | |
| hash_key | 映射akey，不同账号不同akey值，用于callback回传时生成签名值SIGN |
宏参数介绍
| 参数分类 | 神策链接参数 | 参数描述 | 预置事件属性 仅点击事件上报时携带 | 举例：巨量引擎 | 举例：百度信息流 |
|---|---|---|---|---|---|
| 渠道信息参数 | 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}} |
UTM参数介绍
神策广告预置了5个UTM参数用于支持用户对推广/监测链接进行标记。用户可通过这5个参数区分广告活动、广告来源、广告媒介、广告字词、广告内容，也可以根据实际业务需要自行定义5个参数的用途。
| 神策广告最新UTM参数 | 对应老的UTM参数 | 参数描述 | 备注 |
|---|---|---|---|
channel_utm_campaign | utm_campaign | 广告系列活动，用来标记特定的产品促销活动或战略性广告系列，例如周末活动，双11大促等 | 仅「访问渠道追踪链接」事件上报，用于记录点击监测的广告主账户名称。默认在神策分析中隐藏，如需在神策分析中分析渠道广告主账户名称，建议使用 sd_channel_utm_campaign 虚拟属性查询 |
| channel_utm_source | utm_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_content | utm_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字段的值来区分用户来自巨量的哪个广告投放位置。
自定义参数介绍
若预置的5个UTM参数仍不能满足客户业务需要，神策广告也支持客户新建自定义参数。
即，在创建监测链接时即绑定一个固定的key，并对其赋值。自定义参数key与value不能与固定参数、宏参数、utm参数的命名重复。
需注意：参数值请尽量使用英文字符，中文字符转义后通常较长，易导致链接超长。（媒体平台通常会限制链接长度，过长容易造成无法填写、截断、跳转失效等异常。）
在神策广告中，自定义参数与UTM参数本质相同，差别只是前者为客户按需新建，后者为神策广告预置。
自定义参数也支持UTM参数接收其他媒体字段信息的特殊用法。
需注意，如需使用自定义参数，强烈建议打开自定义参数弱校验开关，详见 推广使用指南
转化回传
什么是转化回传
转化回传是基于效果广告投放场景下，服务于oCPX广告投放的特殊产品功能。
对于严格考核广告转化效果（如激活成本、ROI）的客户，主流媒体平台大多提供了oCPM、oCPC的广告投放能力，以帮助效果广告主更好的优化广告成本。
- 对于媒体方而言：只有用户点击广告的数据，没有广告主自身产品相关的转化数据。媒体想要做到整体漏斗分析与算法模型优化，于是开放了点击监测（部分媒体）与转化回传的接口，支持广告主将转化数据与点击归因后上报至媒体，以用于广告模型的优化，控制广告成本。
- 对于广告主而言：只有自身产品相关转化数据，没有广告点击数据，无法实现用户粒度全链路漏斗打通。广告主需要具备接收广告点击、完成广告归因、回传转化数据的能力，才能利用媒体的oCPX能力优化自身广告成本。
神策提供何种回传能力
针对不同推广内容类型，以及已对接的不同媒体渠道，神策广告提供了强大的自定义回传能力，包括以下几个方面：
1、自定义回传窗口期：可按照拉新、拉活两个场景，按渠道灵活配置回传窗口期。
2、自定义异常回传配置：可自助开启/关闭异常情况下是否自动补回传；若开启自动补回传，可配置补回传的窗口期。
3、自定义回传事件映射：可自定义配置回传事件映射，根据业务诉求灵活配置回传事件。（例如，将注册事件当做激活事件回传给媒体）
4、自定义筛选事件属性： 可筛选特定设备、特定时间、特定位置触发事件时，回传媒体指定的事件。（例如，筛选指定商品付费时，才回传该用户的付费事件）
5、自定义回传付费金额：对于支持回传付费金额的媒体，可灵活选择是否回传金额，以及回传金额对应的属性和单位。
6、控制回传事件频次：支持首次回传、每次回传两种方式，控制指定事件回传的频次
详细功能使用见 回传配置
原则上，除非对接媒体有特殊要求，神策广告仅在用户触发指定事件时，通过回传事件标识的方式告知媒体“谁完成了什么转化行为”，不会直接回传用户设备或额外的属性信息。
示例
例如，腾讯广告平台APP转化回传功能规定：广告主回传时，需往点击监测中提供的“每次点击唯一的CALLBACK_URL”地址中，回传事件标识 action_type。
当用户激活APP时，神策APP SDK将触发激活事件，神策广告将完成激活事件的归因。此时，根据回传配置，神策广告将向此次广告点击接收的“唯一CALLBACK_URL”地址中，回传 action_type=ACTIVATE_APP 字段。
于是，腾讯广告平台可以通过关联“唯一CALLBACK_URL”地址所对应的用户，来定位“哪一个用户完成了激活行为”。
在上述流程中，除非平台有特殊要求，神策不会将用户激活的设备号、激活的地域等其他额外信息回传给腾讯。（仅做释义，实际腾讯广告仍有其他的回传要求）
APP转化回传
支持广告主推广APP时，当用户触发APP客户端事件后，神策广告实时回传媒体转化事件。
APP客户端事件：由 Android 或 iOS SDK 上报，通常包括激活、唤醒、按钮点击、页面浏览等行为。
以下为常用行为事件举例：
- 激活：用户安装后首次打开APP时上报，对应$AppInstall/AppInstall预置事件，请勿变更修改。
- 唤醒：用户点击Deeplink链接后直接打开APP时上报，对应$AppDeeplinkLaunch预置事件，请勿变更修改。
- 留存：用户激活后第2天打开APP时上报次日留存，第7日打开APP时上报7日留存，对应的留存事件为神策根据打开APP与激活的日期间隔计算，同时也支持自定义上报的留存事件。
对于首次通过渠道链接激活/唤醒APP的用户，若用户后续再次打开APP，神策支持通过用户id将其与首次激活关联，并将其后续转化行为均标记为来自首次激活的渠道，并回传相应的媒体转化事件。
网页转化回传
支持广告主推广网页时，当用户触发网页客户端事件后，神策广告实时回传媒体转化事件。
客户端事件：由Web JS SDK 上报，通常包括页面打开、页面浏览、按钮点击、表单提交等行为。
以下为常用行为事件举例：
- $ChannelLinkReaching：H5渠道链接触达时上报（当链接中含sat_cf参数时，判定为H5渠道链接），$lib预置属性为web，请勿变更修改。
- 页面浏览：用户打开H5链接时触发，对应$PageView事件。
对于首次通过渠道链接访问网页的用户，若其再次通过主动搜索或用户分享等自然流量的方式，访问同一个域名的网页，神策支持通过用户id将其与首次访问关联，并将其后续转化行为均标记为来自首次访问的渠道，并回传相应的媒体转化事件。
微信小程序转化回传
支持广告主推广微信小程序时，当用户触发微信小程序客户端事件、微信小程序内嵌网页端事件后，神策广告实时回传媒体转化事件。
小程序客户端事件：由小程序 SDK 上报，通常包括小程序启动、小程序页面浏览、按钮点击、表单提交等行为。
以下为常用行为事件举例：
- $ChannelLinkReaching：小程序渠道链接触达时上报（当页面路径中含sat_cf时，判定为小程序渠道链接），$lib预置属性为miniprogram，请勿变更修改。
- 小程序启动：小程序冷启动打开时上报，对应$MpLaunch事件。
小程序内嵌网页端事件：特指当用户打开小程序内嵌网页时，在网页上触发的由Web JS SDK上报的事件，通常包括页面浏览（$PageView）、按钮点击、表单提交等行为。该部分网页上报事件将视作由小程序渠道带来，可按照小程序推广渠道进行归因关联，并回传给应渠道。
对于首次通过渠道链接访问小程序的用户，若其在微信中直接再次打开访问相同小程序，神策支持通过用户id将其与首次访问关联，并将其后续转化行为均标记为来自首次访问的渠道，并回传相应的媒体转化事件。
服务端事件转化回传
除上述三类客户端事件转化回传外，神策广告进一步支持了当用户触发服务端事件后，关联对应的客户端归因事件，并实时回传媒体转化事件。
服务端事件：由 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与客户端归因事件不同，将导致关联回传失败。