1. 整体介绍

神策广告投放分析为客户提供追踪广告点击后全链路用户行为的数据能力,主要方式为创建渠道监测链接,接收渠道「点击」事件中用户设备等相关信息,与「激活」等事件进行归因匹配,并关联后续转化事件。

渠道监测链接由广告主(通常找第三方)生成,当用户产生有效广告点击时,渠道将以HTTPS / HTTP 请求的方式,将宏参数的值替换并返回给神策部署在客户本地的监测服务端。

通过这种方式,采集公域产生的曝光和点击事件,可以实现广告监测(监测媒体实际发生的曝光数和点击数)、广告归因(将私域转化数据与公域点击/曝光数据做匹配)、广告追踪(通过追踪信息,可以进行聚类分析)。

2. 链接参数介绍

在监测链接中,除了头部地址是监测回传地址外,其余部分均由参数组成(包括宏参数、utm参数、自定义参数),以下将分别介绍神策广告投放分析系统的链接参数定义。

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

2.1. 固定参数介绍

参数分类神策链接参数参数描述预置事件属性
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.2. 宏参数介绍

参数分类神策链接参数参数描述预置事件属性举例:巨量引擎举例:百度信息流
渠道信息参数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、素材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}}
gaid(仅安卓)安卓设备GoogleAD ID,道提供宏变量(或参数)满足如下条件即可填写至右侧,优先考虑原值

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.3. utm参数介绍

升级:从0.3版本开始,神策对utm的命名规则统一进行了升级,改为由channel_utm开头(原为utm开头)。该改动主要优化了

  1. 将utm处理逻辑由各端SDK调整至服务端,更灵活&统一;
  2. 支持承载更多服务端事件(如加购、充值成功等事件),分析维度更丰富。

以下为目前升级后的channel_utm参数介绍:

神策对外标准UTM参数参数描述标准预置事件属性神策历史映射UTM参数历史预置事件属性

channel_utm_campaign

广告系列活动,用来标记特定的产品促销活动或战略性广告系列,例如周末活动,双11大促等$channel_utm_campaignutm_campaign$utm_campaign
channel_utm_source广告系列来源,用来标记流量来源,例如weibo、weixin、edm等$channel_utm_sourceutm_source$utm_source

channel_utm_medium


广告系列媒介,用来标记广告营销媒介,例如banner、feeds、pre-roll等$channel_utm_mediumutm_medium$utm_medium

channel_utm_term


广告系列字词,用来标记广告关键词,主要用于 SEM 投放$channel_utm_termutm_term$utm_term
channel_utm_content广告系列内容,用来标记广告创意,主要用于 A/B 测试,标记同一广告间细微差别$channel_utm_contentutm_content$utm_content

2.3.1. 如何升级至channel_utm

由于utm参数的value覆盖问题,仅部分客户有遇到。如果你需要升级至以channel_utm开头的新参数方案,需要手动打开开关进行升级。若不打开,则保仍为以utm开头的旧参数方案逻辑。

2.3.1.1. 如何开启channel_utm

spadmin config set server -m web -p advertising-management -n utm_to_channel_utm_switch -v true
CODE

2.3.1.2. 开启开关后现有逻辑影响

点击监测、曝光监测、短链、deeplink链接所有涉及utm_xxx参数拼接的地方会全部修改为channel_utm_xxx,链接会增加一个参数:link_version=1

所有归因时会将$channel_utm_xxx作为渠道参数添加到后续事件,包括激活-点击归因、激活-深度回传归因、推广web用户归因、推广web单会话归因、180天缓存逻辑(一个用户如果发生过激活或者落地页触达,后续所有事件无论是否归因都会挂渠道参数)

profile_set_once渠道会在激活和落地页触达事件后,自动生成。生成的profile_set_once会挂上$first_channel_utm_xxx参数

2.3.1.3. 关闭开关后逻辑

点击监测、曝光监测、短链、deeplink链接所有涉及utm_xxx参数拼接的地方保持不变,仍然是utm_xxx

除推广web归因,其他时会将$utm_xxx作为渠道参数添加到后续事件。

推广web归因时,后续事件不会挂$utm_xxx属性

profile_set_once渠道会在激活和落地页触达事件后,自动生成。生成的profile_set_once会挂上$utm_xxx参数

2.3.1.4. 开启开关客户需要操作

I 对于新客户(完全没使用过渠道链接功能的客户):

       只需开启channel_utm开关即可,无需其他操作。

II 对于老客户(使用过渠道链接功能的客户):

       ①如果有链接是utm,这些老链接仍然保持utm的逻辑,新的链接会走channel_utm的逻辑。

       ②原来使用utm进行投放链接/监测链接需要统一替换为新的带有channel_utm的参数的链接,否则功能不生效

       ③查询会受到影响,需要客户调整查询条件。后续将开发升级解决这个问题。


看数问题:在事件分析中由于库中有历史utm_xxx数据,新的数据则使用channel_utm_xxx存储,造成在切换过程中没有办法直接查看数据的延续性问题,例如:原来的投放链接中utm_source=A的链接改变为channel_utm_source=A,在存储数据区分位两个属性字段,当我需要查询本周的所有A渠道来源的数据时候没法直观一次查询出来。

解决方案:建立一个虚拟属性,按照优先级聚合一下两个属性的值,在查询的时候使用新的虚拟属性是可以查询出A渠道来源数据的所有可延续数据。


III 所有使用SEM推广的客户(无论新客户还是老客户):

        需要调用js-sdk的函数

sensors.use('SensorsChannel');
CODE

        详情请参考文档:https://manual.sensorsdata.cn/kbs/latest/%E6%B8%A0%E9%81%93%E9%93%BE%E6%8E%A5%E7%9B%91%E6%B5%8B%E5%92%8C%E5%9B%9E%E4%BC%A0-22258345.html


2.4. 自定义参数介绍 

客户根据自身需要,自行定义,并在创建一条监测链接时即绑定一个固定的value,自定义参数key跟value不能与固定参数、宏参数、utm参数命名重复