loadding
加载进行中
产品资讯-详情

聚焦行业产品资讯

与您共享互联网红利

搜索推广-转化追踪-应用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”时,则表示百度未获取到相应参数,或该参数在当前推广平台不支持下发。


版权所有© 厦门易尔通网络科技有限公司 闽ICP备05015420号-1 公安备案号:35020302034886
未经易尔通允许,不得盗链、盗用本站资源;不得复制或仿造本网站,不得在非易尔通所属的服务器上建立镜像,易尔通对其自行开发的所有内容、技术手段和服务拥有全部知识产权,任何人不得侵害或破坏,也不得擅自使用。如有发现,必将追究法律责任!

产品

×
产品服务