此为高级功能,由于涉及到宏参数替换、回传接口格式等偏技术项的配置,此部分内容建议由贵方的产研侧同学协助,对照媒体文档一同完成。
如需神策官方服务人员协助所有配置,则需要支付相应服务工时。
使用「自定义媒体渠道」,您可以实现:
后续需要按照对应对接文档中的监测回传格式,对该渠道进行自定义配置。
进入「管理与配置-渠道管理-媒体渠道Tab页」,点击右上角「创建媒体渠道」,进入创建页面。
>>>渠道名称:请填写您要创建的媒体渠道的中文名称,注意不要与平台中已有的渠道重名哦。且请慎重填写,渠道创建后将无法更改。
>>>渠道英文名:请填写您要创建的媒体渠道的英文名,系统会自动在您输入的英文名后拼接上_track,注意不要与平台中已有的渠道英文名重名哦。且请慎重填写,渠道创建后将无法更改。
>>>渠道类型:请判断您所需要创建的渠道是类似抖音/快手之类的信息流类型渠道、还是类似百度搜索之类的SEM类型渠道、还是类似小米/VIVO/OPPO/应用宝之类的安卓商店类型渠道,并根据实际情况选择渠道类型。且请慎重填写,渠道创建后将无法更改。
Tips:可在「管理与配置-渠道管理」页面中看到已有媒体渠道的名称和英文名。
其中,大部分媒体会选择使用「宏参数替换」方式来传递点击信息,少部分媒体会直接在「点击监测链接」后面拼接参数来下发点击信息。
客户需要具体选择通过「宏参数替换」抑或是「链接后添加参数」的方式接收点击信息。请慎重选择,渠道创建后将无法更改。
「点击信息接受方式」默认选择市面上大部分媒体通用的「宏参数替换」方式。
「宏参数替换」方式,即当发生点击后,媒体侧会找到「点击监测链接」中的宏参数(形如__AD_ID__、{AD_ID}、{{AD_ID}}等),并将其替换成具体的值(如把__AD_ID__替换成843292),然后发送给SAT。
因此需要在创建渠道时,完成该渠道宏参数的配置。
步骤一:请根据媒体侧提供的监测对接文档,找到其中的点击监测宏参数说明部分。
以「快手-磁力智投」为例,即为下图的「监测参数表」。
步骤二:请根据SAT的参数字段表中(详见附录一)的释义,将媒体侧的宏参数(常见格式有__OAID__、__oaid__、{OAID}、{{OAID}}等)填写到对应的SAT参数字段中。
特别说明
1、宏参数大小写敏感
2、请根据媒体支持字段情况配置完所有宏参数,且强烈建议完整配置oaid、idfa、idfv、ip、ua、os这六个归因所需字段哦。
3、当媒体侧对同一个属性提供了不同加密方式的宏参数时(如对imei属性同时提供了「md5后的imei宏参数」和「imei原值宏参数」时),请使用「媒体能够稳定替换的宏参数」填入,SAT会对属性的原值和md5后的值进行兼容。
步骤一:请根据媒体侧提供的监测对接文档,找到其中的参数说明部分。
步骤二:请根据SAT的参数字段表中(详见附录一)的释义,将媒体侧要添加的参数填写到对应的SAT参数字段中。
以上图「接受点击接口参数介绍」中的muid为例。
应用宝渠道会通过muid字段下发IMEI或IDFA值,然而由于应用宝渠道只能推广Android应用,故在此处只需要将muid填入SAT对应的imei字段中,详见下图。
1、参数大小写敏感
配置完成后,点击右上角「提交」按钮,即可完成渠道创建,并在「管理与配置-渠道管理-媒体渠道Tab页」最下方看到新创建的渠道。
点击目标自定义媒体渠道右侧的「回传配置」,进入回传界面。
点击右上角「创建回传方案」,即可开始「回传方案」的配置。
>>>回传方案名称:按需填写。
>>>支持内容类型:自定义媒体渠道仅支持APP一种内容类型。
>>>生效状态:按需选择。
回传请求方式和请求地址由媒体侧定义,可在媒体对接文档-转化回传接口说明部分找到。
如下图中即为GET方式。
当为GET请求时,需要填写「回传接收地址」。
SAT平台将媒体「回传接收地址」的结构提炼成三部分:「域名」、「固定参数」和「SAT回传宏参数」。SAT回传宏参数列表详见附件二。
CASE1
此时,则需要到SAT宏参数列表(附件二)中找到event_type对应的SAT宏参数,即__ACTION_VALUE__(对应SAT回传方案中填写的「回传内容名称」,详见下文)
CASE2
某些媒体侧逻辑为:回调地址不固定,而是通过监测链接中的宏参数返回回调地址。此时需留意回调地址结尾格式,确保地址后拼接参数格式需满足key1=value1&key2=value2。
部分媒体的回传请求方法为POST方式,典型的如腾讯-应用宝渠道。
此时就需要填写「回传接收地址」、「回传请求头」、「回传请求体」。
详请参考GET请求的回传接受地址说明部分。
示例一
其中access_token、timestamp、nonce字段的释义如下。
根据SAT回传宏参数列表(附件二),access_token和timestamp(秒级别)字段对应的SAT宏参数分别为:__ACCESS_TOKEN__和__TIMESTAMP_S__;而nonce字段(随机字串标识)可以由__EVENT_TIME____TIMESTAMP__组成。
示例二
回传请求头(-H)说明
如应用宝截图的第二个红框所示,应用宝的请求头为:Content-Type:application/json
那么对应则需在平台中输入
如应用宝截图的第三个红框所示,应用宝的请求体为:
{“account_id”:“
那么对应则需在平台中输入:
{"account_id":"__AUTHORIZED_ACCOUNT_ID__","user_action_set_id":1201435339,"actions":[{"action_time":__EVENT_TIME_S__,"user_id":{"hash_imei":"__IMEI_MD5__","hash_oaid":"__OAID_MD5__"},"action_type":"__ACTION_VALUE__"}]}
1、当发生回传时,SAT仅对SAT回传宏参数进行值的替换,具体数据格式由您在请求体中定义。
2、请注意:为了确保回传请求的格式是正确的,当未能成功取到SAT回传宏参数对应的值时,SAT会默认将值替换为0。
>>>回传内容名称:请根据媒体回传对接文档中的事件类型进行填写。对应SAT回传宏参数:__ACTION_VALUE__
>>>采集事件名称:根据实际情况选择,如$AppInstall。对应SAT回传宏参数:__EVENT_NAME__
>>>频次控制:每次/首次。
>>>回传数值:请选择需要回传的属性,如PayAmount。对应SAT回传宏参数:__CUSTOM_PARAM__
以上图应用宝的「标准行为类型」为例,在SAT平台中,则需对应填写为:
配置完成后,点击「提交」按钮,即可创建完成。
类型
回传链接宏参数变量
参数描述
SAT的参数
用户信息类
__OAID__
Android系统特有的设备ID,用于精确归因
__IDFA__
iOS系统特有的设备ID,用于精确归因
__IDFV__
iOS系统特有的设备ID,高版本系统归因失效
__IMEI__
设备imei
__MAC__
设备mac地址
__IP__
媒体投放系统获取的用户终端的公共IP地址
__ANDROID__
Android系统特有的设备ID,高版本系统归因失效
__OAID_MD5__
android系统特有属性,用于精确归因。此为MD5加密后的值。
__IDFA_MD5__
ios系统特有属性,用于精确归因。此为MD5加密后的值。
__IDFV_MD5__
ios特有属性,高版本系统归因失效。此为MD5加密后的值。
__IMEI_MD5__
设备imei。此为MD5加密后的值。
__MAC_MD5__
设备mac地址。此为MD5加密后的值。
__IP_MD5__
用户外网的IP。此为MD5加密后的值。
__ANDROID_MD5__
android系统特有属性,高版本系统归因失效。此为MD5加密后的值。
__MODEL__
手机型号
__OS__
操作系统类型
媒体信息类
__ACCOUNT_ID__
__CAMPAIGN_ID__
__AD_GROUP_ID__
__AD_ID__
__CAMPAIGN_NAME__
__AD_GROUP_NAME__
__AD_NAME__
__KEYWORD_ID__
SEM关键词ID
__KEYWORD__
SEM关键词
用户行为类
__CLICK_TIME__
__CLICK_ID__
用户点击ID
__ACCESS_TOKEN__
__AUTHORIZED_ACCOUNT_ID__
埋点事件及回传配置
__CALLBACK_URL__
回传的URL信息
__CALLBACK_PARAM__
需要透传到回传的参数
__EVENT_NAME__
对应SAT回传方案中选择的「采集事件名称」
__ACTION_VALUE__
对应SAT回传方案中填写的「回传内容名称」
__CUSTOM_PARAM__
对应SAT回传方案中填写的「回传数值」
__EVENT_TIME__
__EVENT_TIME_S__
__TIMESTAMP__
__TIMESTAMP_S__
注:本文档内容为神策产品使用和技术细节说明文档,不包含适销类条款;具体企业采购产品和技术服务内容,以商业采购合同为准。