一、【升级背景】
在创建应用类的转化追踪时，广告主可通过「应用API」方式回传用户发生在应用内或与应用相关场景内的转化行为，让后续的广告竞价投放和模型得到充分的数据，达到最佳的广告投放效果。但因当前在搜索推广与信息流推广「应用API」接入方式下，创编流程与通配符能力等方面存在差异，导致同时投放搜索与信息流的广告主，在转化数据接入中需付出较大的理解成本和开发成本。
基于上述背景，为统一搜索与信息流在「应用API」接入方式下的通配符，降低广告主的理解门槛与技术开发成本，本次搜索推广-转化追踪-应用API接入方式下，监测地址的通配符将进行升级：
1、新增支持 【__SIZE__或{{SIZE}}】与 【__OS_TYPE__或{{OS_TYPE}}】通配符，向广告主传递用户设备的屏幕宽高及操作系统类型信息；
2、下线【__DEVICE_INFO__或 {{DEVICE_INFO}}】通配符，已使用此通配符的存量物料不受影响，新建物料可通过【__MODEL__或 {{MODEL}} 】通配符获取设备信息；
3、下线【__OS__或 {{OS}}】通配符，后续可通过【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符获取操作系统类型。
二、【升级点详述】
2.1 功能入口：
搜索推广-->转化追踪-->新建/编辑转化追踪-->接入方式为应用API-->点击监测地址
如下图所示：
2.2 升级后的通配符：（标红字体为本次的新增的通配符）
|
参数名
|
描述
|
通配符
|
参数值
|
说明
|
|
a_type
|
转化事件
|
{{ATYPE}}
|
activate：激活 register：注册 orders：付费 retain_1day：次日留存 user_defined：客户自定义 ec_buy：商品下单成功 deep_page_access：关键页面浏览 highvalue_customer: 深度使用 credit_granting: 授信 feed_deeplink：应用调起 |
表示客户回传的转化事件
|
|
a_value
|
转化指标
|
{{AVALUE}}
|
|
可用于回传付费金额或转化价值，单位为分，必须为整数。无转化金额回传时，数值填写为“0”即可 |
|
userid
|
账户ID
|
__USER_ID__或{{USER_ID}}
|
例：630152
|
|
|
pid
|
计划ID
|
__PLAN_ID__或{{PLAN_ID}}
|
例：282086005
|
|
|
uid
|
单元ID
|
__UNIT_ID__或{{UNIT_ID}}
|
例：7611126171
|
|
|
aid
|
创意ID
|
__IDEA_ID__或{{IDEA_ID}}
|
例：487646160381
|
|
|
size
|
屏幕宽高
|
{{SIZE}}或__SIZE__
|
例：840_1092
|
无值时替换为NULL
|
|
os_version
|
操作系统版本
|
__OS_VERSION__或{{OS_VERSION}}
|
iOS样例： 14.4.2； Android样例 8.1.0； |
无值时替换为NULL
|
|
os_type
|
操作系统类型
|
__OS_TYPE__或{{OS_TYPE}}
|
安卓：0；iOS：1；其他：3
|
无值时替换为NULL
|
|
idfa
|
iOS设备标识
|
__IDFA__或{{IDFA}}
|
例：40879ADB-E3E8-4FD4-BE28-86DF97532DC7
|
IDFA原值，无值时替换为NULL
|
|
imei_md5
|
Android设备标识
|
__IMEI__或{{IMEI_MD5}}
|
例：imei[10bc955ac2a675d3] imei_md5[f703b39228c8c5cf8069051d86a20747] |
IMEI经标准32位MD5后的加密值，无值时替换为NULL
|
|
android_id_md5
|
Android设备标识
|
__ANDROIDID__或{{ANDROID_ID_MD5}}
|
例：imei[10bc955ac2a675d3] imei_md5[f703b39228c8c5cf8069051d86a20747] |
IMEI经标准32位MD5后的加密值，无值时替换为NULL |
|
ip
|
IP地址
|
__IP__或{{IP}}
|
例： 183.198.101.184
|
用户端公网IP地址，无值时替换为NULL
|
|
ua
|
数据上报终端设备，UserAgent
|
__UA__或{{UA}}
|
iOS样例：Mozilla/5.0 (iPhone; CPU iPhone OS 14_4_2like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 swan/2.26.0 swan-baiduboxapp/12.6.5.10 baiduboxapp/12.6.5.10 (Baidu; P2 14.4.2) Android样例：Mozilla/5.0 (Linux; Android 8.1.0; DUB-AL00 Build/HUAWEIDUB-AL00; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/76.0.3809.89 Mobile Safari/537.36 T7/12.9 SP-engine/2.21.0 matrixstyle/0 lite baiduboxapp/5.4.0.10 (Baidu; P1 8.1.0) NABar/1.0 |
终端设备的User Agent，无值时替换为NULL
|
|
ts
|
时间戳
|
__TS__或{{TS}}
|
例：1678251198
|
广告点击时间的毫秒时间戳
|
|
mac_md5
|
mac地址
|
__MAC1__或{{MAC_MD5}}
|
例：mac[00:0C:18:EF:FF:ED]
|
MAC地址经标准32位MD5后的加密值，无值时替换为NULL
|
|
mac
|
去除分隔符”:“的大写MAC地址取MD5摘要
|
__MAC__或{{MAC}}
|
例：mac[90:F0:52:48:5e:12] 去除”:“分隔符后大写[90F052485E12] mac1[83afcfa842269ae2c8b96e6ee0546ec2] |
MAC地址大写字符且去除分隔符，经标准32位MD5后的加密值
|
|
oaid_md5
|
Md5加密oaid
|
__OAID_MD5__或{{OAID_MD5}}
|
例：953a43cbc8e4a653709cf3a9d028322d
|
OAID经标准32位MD5后的加密值，无值时替换为NULL
|
|
oaid
|
原文oaid
|
__OAID__或者{{OAID}}
|
例：47befdff-fb1f-4b96-ddff-bf3fb77f744e
|
OAID原值，无值时替换为NULL
|
|
caid |
iOS设备标识
|
__CAID__或{{CAID}}
|
例：
|
利用设IOS备信息生成的设备表示， 可用来替代 IDFA 进行归因和定向，无值时替换为NULL |
|
model
|
设备信息
|
__MODEL__或{{MODEL}}
|
IOS样例：iPhone13,4 Android样例：EVA-AL10 |
客户端获取的原始设备信息数据，无值时替换为NULL
|
|
click_id
|
点击或曝光唯一标识
|
__CLICK_ID__或{{CLICK_ID}}
|
默认：searchid_time 小流量：bd_vid原值 |
--
|
|
combid
|
程序化创意组合
|
__COMBID__或{{COMBID}}
|
广告对应的程序化创意组合id
|
仅信息流推广支持下发真实值；搜索不支持替换
|
|
deeplink_url
|
deeplink链接
|
__DEEPLINK_URL__或{{DEEPLINK_URL}}
|
广告对应的deeplink链接
|
仅信息流支持下发真实值，搜索不支持替换
|
|
callback_url |
转化数据回传URL
|
__CALLBACK_URL__或{{CALLBACK_URL}}
|
用于回传转化的字符串
|
由百度server端调用监测URL时直接传输给广告主，产生转化时广告主替换转化相关参数（a_type、a_value）后生成签名进行回调，callback_url中的s,o,ext_info字段由baidu公司server负责处理。callType=v2的用户可以不拼接s,o参数
|
|
ext_info
|
点击信息/曝光信息
|
__EXT_INFO__或{{EXT_INFO}}
|
根据点击信息/曝光信息产生的字符串
|
callType=v2客户使用
|
|
sign
|
签名
|
__SIGN__或{{SIGN}}
|
根据每次广告的点击监测/回调URL与AKEY生成的字符串
|
替换通配符后的完整回调URL（不包含&sign=）+akey进行标准32位md5，生成签名值，在回调URL后添加&sign=签名值
|
三、常见问题
Q1：本次升级是否会影响投放效果？
A1：本次升级仅影响应用API下，监测地址中可支持的通配符能力，对投放效果没有影响。
Q2: 存量物料内使用的已下线的【__DEVICE_INFO__或 {{DEVICE_INFO}}】与【__OS__或 {{OS}}】通配符，是否还可以继续使用，需要调整吗？
A2：已使用【__DEVICE_INFO__或 {{DEVICE_INFO}}】与【__OS__或 {{OS}}】通配符的存量物料，仍可以正常使用，将继续支持下发相应参数值。新建物料可通过【__MODEL__或 {{MODEL}} 】通配符获取设备信息，可通过【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符获取操作系统类型。
Q3：上述应用API支持的通配符能力，在进行联调时，是否会下发参数的真实值？
A2：搜索推广-应用API的联调中支持下发参数真实值。当参数值为“NULL”时，则表示百度未获取到相应参数，或该参数在当前推广平台不支持下发。
公安备案号：35020302034886
•营销产品
•自营产品