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