提供80+媒體資源
我司提供互聯(lián)網(wǎng)廣告營(yíng)銷服務(wù)超10年,擁有專業(yè)的人才儲(chǔ)備
【 服務(wù)熱線 】4009602809
一、【升級(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、新增支持 【__OS_VERSION__或 {{OS_VERSION}} 】與 【__OS_TYPE__或{{OS_TYPE}}】通配符,向廣告主傳遞用戶設(shè)備的操作系統(tǒng)版本及操作系統(tǒng)類型信息;
2、下線【__DEVICE_INFO__或 {{DEVICE_INFO}}】通配符,已使用此通配符的存量物料不受影響,新建物料可通過【__MODEL__或 {{MODEL}} 】通配符獲取設(shè)備信息;
3、下線【__OS__或 {{OS}}】通配符,后續(xù)可通過【__OS_TYPE__ 或 {{OS_TYPE}} 】通配符獲取操作系統(tǒng)類型。
二、【升級(jí)點(diǎn)詳述】
1.功能入口:百度信息流廣告推廣-->轉(zhuǎn)化追蹤-->新建/編輯轉(zhuǎn)化追蹤-->接入方式為應(yīng)用API-->點(diǎn)擊監(jiān)測(cè)鏈接 /曝光監(jiān)測(cè)鏈接
如下圖所示:

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)鍵頁(yè)面瀏覽 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經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL |
| android_id_md5 | Android設(shè)備標(biāo)識(shí) | __ANDROIDID__或{{ANDROID_ID_MD5}} | 例:875b051d04caedfb0d891c6fddd2be84 | ANDROID_ID經(jīng)經(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_md5[21baa000f63c7d0f0b2cd9af8bd0eb24] | MAC地址經(jīng)標(biāo)準(zhǔn)32位MD5后的加密值,無值時(shí)替換為NULL |
| mac | 去除分隔符”:“的大寫MAC地址取MD5摘要 | __MAC__或{{MAC}} | 例:mac[90:F0:52:48:5e:12] 去除”:“分隔符后大寫[90F052485E12] | 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 | 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í)值?
A3:百度搜索廣告推廣-應(yīng)用API的聯(lián)調(diào)中支持下發(fā)參數(shù)真實(shí)值。當(dāng)參數(shù)值為“NULL”時(shí),則表示百度未獲取到相應(yīng)參數(shù),或該參數(shù)在當(dāng)前推廣平臺(tái)不支持下發(fā)。
Q4:上述應(yīng)用API支持的通配符能力,在進(jìn)行聯(lián)調(diào)時(shí),是否會(huì)下發(fā)參數(shù)的真實(shí)值?
A4:百度信息流廣告推廣-應(yīng)用API的聯(lián)調(diào)中支持下發(fā)參數(shù)真實(shí)值。當(dāng)參數(shù)值為“NULL”時(shí),則表示百度未獲取到相應(yīng)參數(shù),或該參數(shù)在當(dāng)前推廣平臺(tái)不支持下發(fā)。
轉(zhuǎn)化追蹤-應(yīng)用API-通配符更新的主要目的是為了提高轉(zhuǎn)化追蹤的準(zhǔn)確性和靈活性,幫助開發(fā)者更加方便地匹配和追蹤不同轉(zhuǎn)化類型的用戶行為,從而更好地評(píng)估百度廣告投放效果和用戶價(jià)值。
我司提供互聯(lián)網(wǎng)廣告營(yíng)銷服務(wù)超10年,擁有專業(yè)的人才儲(chǔ)備
擁有單賬戶日消耗百萬運(yùn)營(yíng)經(jīng)驗(yàn),廣告賬戶總量超1萬!
賬戶開通后,提供專業(yè)的建站運(yùn)營(yíng)服務(wù),百名運(yùn)營(yíng)服務(wù)!
如無需我司進(jìn)行代運(yùn)營(yíng),可提供較高返點(diǎn)政策,靠譜!
專注信息流廣告/直播廣告/搜索廣告/短視頻廣告開戶服務(wù)!