0592-3500555
效果推廣
品牌推廣
營銷工具
自營產品搜索推廣-轉化追蹤-應用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”時，則表示百度未獲取到相應參數，或該參數在當前推廣平臺不支持下發。
聲明：該文觀點僅代表作者本人，并不代表本網站贊同其觀點和對其真實性負責，文章內容僅供參考。
公安備案號：35020302034886
