搜索推廣-轉(zhuǎn)化追蹤-應(yīng)用API-通配符更新 ——全流量
一、【升級(jí)背景】
在創(chuàng)建應(yīng)用類的轉(zhuǎn)化追蹤時(shí),廣告主可通過「應(yīng)用API」方式回傳用戶發(fā)生在應(yīng)用內(nèi)或與應(yīng)用相關(guān)場(chǎng)景內(nèi)的轉(zhuǎn)化行為,讓后續(xù)的廣告競(jìng)價(jià)投放和模型得到充分的數(shù)據(jù),達(dá)到最佳的廣告投放效果。但因當(dāng)前在搜索推廣與信息流推廣「應(yīng)用API」接入方式下,創(chuàng)編流程與通配符能力等方面存在差異,導(dǎo)致同時(shí)投放搜索與信息流的廣告主,在轉(zhuǎn)化數(shù)據(jù)接入中需付出較大的理解成本和開發(fā)成本。
基于上述背景,為統(tǒng)一搜索與信息流在「應(yīng)用API」接入方式下的通配符,降低廣告主的理解門檻與技術(shù)開發(fā)成本,本次搜索推廣-轉(zhuǎn)化追蹤-應(yīng)用API接入方式下,監(jiān)測(cè)地址的通配符將進(jìn)行升級(jí):
1、新增支持 【__SIZE__或{{SIZE}}】與 【__OS_TYPE__或{{OS_TYPE}}】通配符,向廣告主傳遞用戶設(shè)備的屏幕寬高及操作系統(tǒng)類型信息;
2、下線【__DEVICE_INFO__或 {{DEVICE_INFO}}】通配符,已使用此通配符的存量物料不受影響,新建物料可通過【__MODEL__或 {{MODEL}} 】通配符獲取設(shè)備信息;
3、下線【__OS__或 {{OS}}】通配符,后續(xù)可通過【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符獲取操作系統(tǒng)類型。
二、【升級(jí)點(diǎn)詳述】
2.1 功能入口:
搜索推廣-->轉(zhuǎn)化追蹤-->新建/編輯轉(zhuǎn)化追蹤-->接入方式為應(yīng)用API-->點(diǎn)擊監(jiān)測(cè)地址
如下圖所示:
2.2 升級(jí)后的通配符:(標(biāo)紅字體為本次的新增的通配符)
參數(shù)名
|
描述
|
通配符
|
參數(shù)值
|
說明
|
a_type
|
轉(zhuǎn)化事件
|
{{ATYPE}}
|
activate:激活 register:注冊(cè) orders:付費(fèi) retain_1day:次日留存 user_defined:客戶自定義 ec_buy:商品下單成功 deep_page_access:關(guān)鍵頁面瀏覽 highvalue_customer: 深度使用 credit_granting: 授信 feed_deeplink:應(yīng)用調(diào)起 |
表示客戶回傳的轉(zhuǎn)化事件
|
a_value
|
轉(zhuǎn)化指標(biāo)
|
{{AVALUE}}
|
|
可用于回傳付費(fèi)金額或轉(zhuǎn)化價(jià)值,單位為分,必須為整數(shù)。無轉(zhuǎn)化金額回傳時(shí),數(shù)值填寫為“0”即可 |
userid
|
賬戶ID
|
__USER_ID__或{{USER_ID}}
|
例:630152
|
|
pid
|
計(jì)劃ID
|
__PLAN_ID__或{{PLAN_ID}}
|
例:282086005
|
|
uid
|
單元ID
|
__UNIT_ID__或{{UNIT_ID}}
|
例:7611126171
|
|
aid
|
創(chuàng)意ID
|
__IDEA_ID__或{{IDEA_ID}}
|
例:487646160381
|
|
size
|
屏幕寬高
|
{{SIZE}}或__SIZE__
|
例:840_1092
|
無值時(shí)替換為NULL
|
os_version
|
操作系統(tǒng)版本
|
__OS_VERSION__或{{OS_VERSION}}
|
iOS樣例: 14.4.2; Android樣例 8.1.0; |
無值時(shí)替換為NULL
|
os_type
|
操作系統(tǒng)類型
|
__OS_TYPE__或{{OS_TYPE}}
|
安卓:0;iOS:1;其他:3
|
無值時(shí)替換為NULL
|
idfa
|
iOS設(shè)備標(biāo)識(shí)
|
__IDFA__或{{IDFA}}
|
例:40879ADB-E3E8-4FD4-BE28-86DF97532DC7
|
IDFA原值,無值時(shí)替換為NULL
|
imei_md5
|
Android設(shè)備標(biāo)識(shí)
|
__IMEI__或{{IMEI_MD5}}
|
例:imei[10bc955ac2a675d3] imei_md5[f703b39228c8c5cf8069051d86a20747] |
IMEI經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL
|
android_id_md5
|
Android設(shè)備標(biāo)識(shí)
|
__ANDROIDID__或{{ANDROID_ID_MD5}}
|
例:imei[10bc955ac2a675d3] imei_md5[f703b39228c8c5cf8069051d86a20747] |
IMEI經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL |
ip
|
IP地址
|
__IP__或{{IP}}
|
例: 183.198.101.184
|
用戶端公網(wǎng)IP地址,無值時(shí)替換為NULL
|
ua
|
數(shù)據(jù)上報(bào)終端設(shè)備,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 |
終端設(shè)備的User Agent,無值時(shí)替換為NULL
|
ts
|
時(shí)間戳
|
__TS__或{{TS}}
|
例:1678251198
|
廣告點(diǎn)擊時(shí)間的毫秒時(shí)間戳
|
mac_md5
|
mac地址
|
__MAC1__或{{MAC_MD5}}
|
例:mac[00:0C:18:EF:FF:ED]
|
MAC地址經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL
|
mac
|
去除分隔符”:“的大寫MAC地址取MD5摘要
|
__MAC__或{{MAC}}
|
例:mac[90:F0:52:48:5e:12] 去除”:“分隔符后大寫[90F052485E12] mac1[83afcfa842269ae2c8b96e6ee0546ec2] |
MAC地址大寫字符且去除分隔符,經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值
|
oaid_md5
|
Md5加密oaid
|
__OAID_MD5__或{{OAID_MD5}}
|
例:953a43cbc8e4a653709cf3a9d028322d
|
OAID經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL
|
oaid
|
原文oaid
|
__OAID__或者{{OAID}}
|
例:47befdff-fb1f-4b96-ddff-bf3fb77f744e
|
OAID原值,無值時(shí)替換為NULL
|
caid |
iOS設(shè)備標(biāo)識(shí)
|
__CAID__或{{CAID}}
|
例:
|
利用設(shè)IOS備信息生成的設(shè)備表示, 可用來替代 IDFA 進(jìn)行歸因和定向,無值時(shí)替換為NULL |
model
|
設(shè)備信息
|
__MODEL__或{{MODEL}}
|
IOS樣例:iPhone13,4 Android樣例:EVA-AL10 |
客戶端獲取的原始設(shè)備信息數(shù)據(jù),無值時(shí)替換為NULL
|
click_id
|
點(diǎn)擊或曝光唯一標(biāo)識(shí)
|
__CLICK_ID__或{{CLICK_ID}}
|
默認(rèn):searchid_time 小流量:bd_vid原值 |
--
|
combid
|
程序化創(chuàng)意組合
|
__COMBID__或{{COMBID}}
|
廣告對(duì)應(yīng)的程序化創(chuàng)意組合id
|
僅信息流推廣支持下發(fā)真實(shí)值;搜索不支持替換
|
deeplink_url
|
deeplink鏈接
|
__DEEPLINK_URL__或{{DEEPLINK_URL}}
|
廣告對(duì)應(yīng)的deeplink鏈接
|
僅信息流支持下發(fā)真實(shí)值,搜索不支持替換
|
callback_url |
轉(zhuǎn)化數(shù)據(jù)回傳URL
|
__CALLBACK_URL__或{{CALLBACK_URL}}
|
用于回傳轉(zhuǎn)化的字符串
|
由百度server端調(diào)用監(jiān)測(cè)URL時(shí)直接傳輸給廣告主,產(chǎn)生轉(zhuǎn)化時(shí)廣告主替換轉(zhuǎn)化相關(guān)參數(shù)(a_type、a_value)后生成簽名進(jìn)行回調(diào),callback_url中的s,o,ext_info字段由baidu公司server負(fù)責(zé)處理。callType=v2的用戶可以不拼接s,o參數(shù)
|
ext_info
|
點(diǎn)擊信息/曝光信息
|
__EXT_INFO__或{{EXT_INFO}}
|
根據(jù)點(diǎn)擊信息/曝光信息產(chǎn)生的字符串
|
callType=v2客戶使用
|
sign
|
簽名
|
__SIGN__或{{SIGN}}
|
根據(jù)每次廣告的點(diǎn)擊監(jiān)測(cè)/回調(diào)URL與AKEY生成的字符串
|
替換通配符后的完整回調(diào)URL(不包含&sign=)+akey進(jìn)行標(biāo)準(zhǔn)32位md5,生成簽名值,在回調(diào)URL后添加&sign=簽名值
|
三、常見問題
Q1:本次升級(jí)是否會(huì)影響投放效果?
A1:本次升級(jí)僅影響應(yīng)用API下,監(jiān)測(cè)地址中可支持的通配符能力,對(duì)投放效果沒有影響。
Q2: 存量物料內(nèi)使用的已下線的【__DEVICE_INFO__或 {{DEVICE_INFO}}】與【__OS__或 {{OS}}】通配符,是否還可以繼續(xù)使用,需要調(diào)整嗎?
A2:已使用【__DEVICE_INFO__或 {{DEVICE_INFO}}】與【__OS__或 {{OS}}】通配符的存量物料,仍可以正常使用,將繼續(xù)支持下發(fā)相應(yīng)參數(shù)值。新建物料可通過【__MODEL__或 {{MODEL}} 】通配符獲取設(shè)備信息,可通過【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符獲取操作系統(tǒng)類型。
Q3:上述應(yīng)用API支持的通配符能力,在進(jìn)行聯(lián)調(diào)時(shí),是否會(huì)下發(fā)參數(shù)的真實(shí)值?
A2:搜索推廣-應(yīng)用API的聯(lián)調(diào)中支持下發(fā)參數(shù)真實(shí)值。當(dāng)參數(shù)值為“NULL”時(shí),則表示百度未獲取到相應(yīng)參數(shù),或該參數(shù)在當(dāng)前推廣平臺(tái)不支持下發(fā)。