提供80+媒体资源
我司提供互联网广告营销服务超10年,拥有专业的人才储备
【 服务热线 】4009602809
一、【升级背景】
在创建应用类的转化追踪时,广告主可通过「应用API」方式回传用户发生在应用内或与应用相关场景内的转化行为,让后续的百度广告竞价投放和模型得到充分的数据,达到最佳的百度广告投放效果。但因当前在百度搜索广告推广与百度信息流广告推广「应用API」接入方式下,创编流程与通配符能力等方面存在差异,导致同时投放百度搜索广告与百度信息流广告的广告主,在转化数据接入中需付出较大的理解成本和开发成本。
基于上述背景,为统一百度搜索广告与百度信息流广告在「应用API」接入方式下的通配符,降低广告主的理解门槛与技术开发成本,本次百度信息流广告推广-转化追踪-应用API接入方式下,监测地址的通配符将进行升级:
1、新增支持 【__OS_VERSION__或 {{OS_VERSION}} 】与 【__OS_TYPE__或{{OS_TYPE}}】通配符,向广告主传递用户设备的操作系统版本及操作系统类型信息;
2、下线【__DEVICE_INFO__或 {{DEVICE_INFO}}】通配符,已使用此通配符的存量物料不受影响,新建物料可通过【__MODEL__或 {{MODEL}} 】通配符获取设备信息;
3、下线【__OS__或 {{OS}}】通配符,后续可通过【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符获取操作系统类型。
二、【升级点详述】
1.功能入口:百度信息流广告推广-->转化追踪-->新建/编辑转化追踪-->接入方式为应用API-->点击监测链接 /曝光监测链接
如下图所示:

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经标准32位MD5后的加密值,无值时替换为NULL |
| android_id_md5 | Android设备标识 | __ANDROIDID__或{{ANDROID_ID_MD5}} | 例:875b051d04caedfb0d891c6fddd2be84 | ANDROID_ID经经标准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_md5[21baa000f63c7d0f0b2cd9af8bd0eb24] | MAC地址经标准32位MD5后的加密值,无值时替换为NULL |
| mac | 去除分隔符”:“的大写MAC地址取MD5摘要 | __MAC__或{{MAC}} | 例:mac[90:F0:52:48:5e:12] 去除”:“分隔符后大写[90F052485E12] | 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 | 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支持的通配符能力,在进行联调时,是否会下发参数的真实值?
A3:百度搜索广告推广-应用API的联调中支持下发参数真实值。当参数值为“NULL”时,则表示百度未获取到相应参数,或该参数在当前推广平台不支持下发。
Q4:上述应用API支持的通配符能力,在进行联调时,是否会下发参数的真实值?
A4:百度信息流广告推广-应用API的联调中支持下发参数真实值。当参数值为“NULL”时,则表示百度未获取到相应参数,或该参数在当前推广平台不支持下发。
转化追踪-应用API-通配符更新的主要目的是为了提高转化追踪的准确性和灵活性,帮助开发者更加方便地匹配和追踪不同转化类型的用户行为,从而更好地评估百度广告投放效果和用户价值。
我司提供互联网广告营销服务超10年,拥有专业的人才储备
拥有单账户日消耗百万运营经验,广告账户总量超1万!
账户开通后,提供专业的建站运营服务,百名运营服务!
如无需我司进行代运营,可提供较高返点政策,靠谱!
专注信息流广告/直播广告/搜索广告/短视频广告开户服务!