一、【升級(jí)背景】

在創(chuàng)建應(yīng)用類(lèi)的轉(zhuǎn)化追蹤時(shí)，廣告主可通過(guò)「應(yīng)用API」方式回傳用戶(hù)發(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ù)接入中需付出較大的理解成本和開(kāi)發(fā)成本。

基于上述背景，為統(tǒng)一搜索與信息流在「應(yīng)用API」接入方式下的通配符，降低廣告主的理解門(mén)檻與技術(shù)開(kāi)發(fā)成本，本次搜索推廣-轉(zhuǎn)化追蹤-應(yīng)用API接入方式下，監(jiān)測(cè)地址的通配符將進(jìn)行升級(jí)：

1、新增支持 【__SIZE__或{{SIZE}}】與 【__OS_TYPE__或{{OS_TYPE}}】通配符，向廣告主傳遞用戶(hù)設(shè)備的屏幕寬高及操作系統(tǒng)類(lèi)型信息；

2、下線(xiàn)【__DEVICE_INFO__或 {{DEVICE_INFO}}】通配符，已使用此通配符的存量物料不受影響，新建物料可通過(guò)【__MODEL__或 {{MODEL}} 】通配符獲取設(shè)備信息；

3、下線(xiàn)【__OS__或 {{OS}}】通配符，后續(xù)可通過(guò)【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符獲取操作系統(tǒng)類(lèi)型。

二、【升級(jí)點(diǎn)詳述】

2.1 功能入口：

搜索推廣-->轉(zhuǎn)化追蹤-->新建/編輯轉(zhuǎn)化追蹤-->接入方式為應(yīng)用API-->點(diǎn)擊監(jiān)測(cè)地址

如下圖所示：

2.2 升級(jí)后的通配符：（標(biāo)紅字體為本次的新增的通配符）

caid	iOS設(shè)備標(biāo)識(shí)	__CAID__或{{CAID}}	例：	利用設(shè)IOS備信息生成的設(shè)備表示， 可用來(lái)替代 IDFA 進(jìn)行歸因和定向，無(wú)值時(shí)替換為NULL
model	設(shè)備信息	__MODEL__或{{MODEL}}	IOS樣例：iPhone13,4 Android樣例：EVA-AL10	客戶(hù)端獲取的原始設(shè)備信息數(shù)據(jù)，無(wú)值時(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的用戶(hù)可以不拼接s,o參數(shù)
ext_info	點(diǎn)擊信息/曝光信息	__EXT_INFO__或{{EXT_INFO}}	根據(jù)點(diǎn)擊信息/曝光信息產(chǎn)生的字符串	callType=v2客戶(hù)使用
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=簽名值

三、常見(jiàn)問(wèn)題

Q1：本次升級(jí)是否會(huì)影響投放效果？

A1：本次升級(jí)僅影響應(yīng)用API下，監(jiān)測(cè)地址中可支持的通配符能力，對(duì)投放效果沒(méi)有影響。

Q2: 存量物料內(nèi)使用的已下線(xiàn)的【__DEVICE_INFO__或 {{DEVICE_INFO}}】與【__OS__或 {{OS}}】通配符，是否還可以繼續(xù)使用，需要調(diào)整嗎？

A2：已使用【__DEVICE_INFO__或 {{DEVICE_INFO}}】與【__OS__或 {{OS}}】通配符的存量物料，仍可以正常使用，將繼續(xù)支持下發(fā)相應(yīng)參數(shù)值。新建物料可通過(guò)【__MODEL__或 {{MODEL}} 】通配符獲取設(shè)備信息，可通過(guò)【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符獲取操作系統(tǒng)類(lèi)型。

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ā)。