搜索推广-转化追踪-应用API-通配符更新 ——全流量

发表时间：2023年03月15日 11:12:46 来源：百度营销

一、【升级背景】

在创建应用类的转化追踪时，广告主可通过「应用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”时，则表示百度未获取到相应参数，或该参数在当前推广平台不支持下发。

声明：该文观点仅代表作者本人，并不代表本网站赞同其观点和对其真实性负责，文章内容仅供参考。

热门产品推荐

Hot products

百度搜索推广品牌专区百度信息流基础产品智能建站小程序

通过百度营销让您获取更多客户

我们的专属顾问会尽快联系您