1. 百度轉(zhuǎn)化追蹤聯(lián)調(diào)newType 字段為什么總讓線索 API 回傳失敗百度轉(zhuǎn)化追蹤的線索 API 回傳是 oCPC 投放里繞不開的一環(huán)。簡單說你在百度推廣后臺建好轉(zhuǎn)化追蹤拿到 token然后后端在用戶完成注冊、付費、表單提交這些動作時調(diào)百度接口把轉(zhuǎn)化數(shù)據(jù)回傳過去百度用這些數(shù)據(jù)去優(yōu)化流量分配。聽起來就是發(fā)個 POST 請求的事但真正聯(lián)調(diào)的時候一個newType字段能把人卡到懷疑人生。我這次聯(lián)調(diào)的場景是信息流推廣 oCPC轉(zhuǎn)化目標(biāo)選了「表單按鈕點擊」「表單提交成功」「服務(wù)購買成功」三個事件接入方式選線索 API。聯(lián)調(diào)頁面會顯示三張事件卡片每張都是「待聯(lián)調(diào)」?fàn)顟B(tài)你需要掃碼生成帶bd_vid的測試 URL后端拿這個bd_vid去調(diào)https://ocpc.baidu.com/ocpcapi/api/uploadConvertData回傳測試數(shù)據(jù)頁面才會點亮。問題就出在newType上。我前后重試了 7 次前 6 次要么只亮一部分要么全 success 但頁面紋絲不動。最后發(fā)現(xiàn)根因特別簡單newType是百度定義好的轉(zhuǎn)化類型編碼每個事件對應(yīng)一個固定數(shù)字傳錯了百度就按另一個事件處理頁面自然不認(rèn)。這篇就把這 7 次重試的復(fù)盤、可復(fù)制的請求體、newType取值對照表以及用 TaoToken 統(tǒng)一 Key 通道在 CC Switch 里寫settings.json骨架后逐項驗證的動作清單一次講清楚。適合誰看正在接百度轉(zhuǎn)化追蹤線索 API 的后端同學(xué)、做 oCPC 投放需要回傳轉(zhuǎn)化數(shù)據(jù)的運營/開發(fā)、以及被聯(lián)調(diào)頁面「待聯(lián)調(diào)」卡住過的人。2. 前置準(zhǔn)備TaoToken 統(tǒng)一 Key 通道與聯(lián)調(diào)環(huán)境在講newType之前先把聯(lián)調(diào)環(huán)境里跟 Key 管理相關(guān)的部分理一下。我這邊后端服務(wù)會調(diào)用多個模型接口做線索評分和意圖識別Key 散落在各個配置文件里聯(lián)調(diào)時改一個環(huán)境就要同步改好幾處很容易出錯。后來我用 TaoToken 做統(tǒng)一 Key 通道把所有模型的調(diào)用收斂到一個入口聯(lián)調(diào)時只需要維護(hù)一份配置。TaoToken 的定位是統(tǒng)一的大模型 API 接入層官網(wǎng)在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的價值在于你不需要為每個模型單獨管一套 Key 和 base_url統(tǒng)一走一個通道切換模型只改模型名。對于百度轉(zhuǎn)化追蹤這種聯(lián)調(diào)場景后端要同時跑線索評分、表單意圖識別、付費行為打標(biāo)用統(tǒng)一通道能少很多環(huán)境變量。具體操作上我是在 CC Switch 里管理配置的。CC Switch 是一個多環(huán)境配置切換工具你可以把不同環(huán)境的settings.json骨架寫好聯(lián)調(diào)時一鍵切換。下面是我用的骨架結(jié)構(gòu)重點是env里的ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN指向 TaoToken 通道{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(curl:*), Read, Write ] } }這里有幾個點要注意。ANTHROPIC_BASE_URL填https://taotoken.net/api不要帶 UTM 參數(shù)UTM 只用于官網(wǎng)跳轉(zhuǎn)統(tǒng)計。ANTHROPIC_AUTH_TOKEN去 TaoToken 控制臺的 API Keys 頁面生成地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。生成后直接粘進(jìn)settings.json不要提交到 Git。如果你還沒配過可以先去模型對話頁面驗證 Key 是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。能正常對話說明 Key 和通道都沒問題再往下做百度線索 API 聯(lián)調(diào)。注意TaoToken 是模型 API 的統(tǒng)一接入通道不替代百度轉(zhuǎn)化追蹤本身。百度線索 API 的 token、bd_vid、newType這些還是走百度自己的體系兩者是配合關(guān)系不要混在一起。3. 可復(fù)制配置線索 API 請求體與 newType 取值對照表這一節(jié)是核心。百度線索 API 的回傳接口是POST https://ocpc.baidu.com/ocpcapi/api/uploadConvertData請求體是 JSON 數(shù)組每個元素代表一次轉(zhuǎn)化回傳。關(guān)鍵字段有token、bd_vid、newType、convertTime、convertType。下面是我最終跑通的請求體三個事件一次回傳[ { token: 你的百度轉(zhuǎn)化追蹤token, bd_vid: 聯(lián)調(diào)頁面生成的bd_vid, newType: 5, convertTime: 1735689600000, convertType: form_button_click }, { token: 你的百度轉(zhuǎn)化追蹤token, bd_vid: 聯(lián)調(diào)頁面生成的bd_vid, newType: 3, convertTime: 1735689600000, convertType: form_submit_success }, { token: 你的百度轉(zhuǎn)化追蹤token, bd_vid: 聯(lián)調(diào)頁面生成的bd_vid, newType: 10, convertTime: 1735689600000, convertType: service_purchase_success } ]convertTime是毫秒時間戳convertType是我自己加的業(yè)務(wù)標(biāo)識百度不強(qiáng)制要求但方便日志排查。真正決定事件歸屬的是newType。下面這張對照表是我踩坑后整理的建議直接存下來轉(zhuǎn)化事件newType 取值說明咨詢按鈕點擊1頁面咨詢按鈕電話按鈕點擊2撥打電話按鈕表單提交成功3表單真正提交激活4App 激活表單按鈕點擊5表單上的按鈕點擊不是提交服務(wù)購買成功10付費轉(zhuǎn)化應(yīng)用注冊25App 注冊表單提交成功備用26部分賬戶用這個表單按鈕點擊備用27部分賬戶用這個咨詢按鈕點擊備用28部分賬戶用這個電話按鈕點擊備用114部分賬戶用這個我前 6 次失敗的核心原因就是把「表單按鈕點擊」當(dāng)成了newType3。實際上3是「表單提交成功」5才是「表單按鈕點擊」。百度收到3就按表單提交處理聯(lián)調(diào)頁面上「表單按鈕點擊」那張卡片當(dāng)然不會亮。還有一個坑不同賬戶的編碼表可能有細(xì)微差異26/27/28/114這些備用值就是我在搜索時看到的。最穩(wěn)的做法是去百度推廣后臺的轉(zhuǎn)化追蹤文檔里查你賬戶對應(yīng)的編碼表不要憑記憶猜。用 curl 測試的話命令長這樣curl -X POST https://ocpc.baidu.com/ocpcapi/api/uploadConvertData \ -H Content-Type: application/json \ -d [ { token: 你的token, bd_vid: 你的bd_vid, newType: 5, convertTime: 1735689600000 }, { token: 你的token, bd_vid: 你的bd_vid, newType: 3, convertTime: 1735689600000 }, { token: 你的token, bd_vid: 你的bd_vid, newType: 10, convertTime: 1735689600000 } ]返回{code:0,message:success}只代表百度收到了請求不代表聯(lián)調(diào)頁面會點亮。頁面點亮取決于newType是否匹配你選的事件。這點一定要分清否則會像我一樣看到 success 卻以為成功了。4. 驗證請求逐項點亮聯(lián)調(diào)頁面的動作清單聯(lián)調(diào)頁面有 1 小時超時超時后bd_vid失效要重新掃碼。所以配好腳本、備好參數(shù)再開始別邊調(diào)邊等。下面是我最終跑通的驗證清單按順序做第一步在百度推廣后臺新建轉(zhuǎn)化追蹤渠道選信息流推廣轉(zhuǎn)化目標(biāo)選不限轉(zhuǎn)化事件勾選你要的三個接入方式選線索 API拿到 token。第二步打開聯(lián)調(diào)頁面掃碼生成帶bd_vid的測試 URL。把bd_vid復(fù)制出來填進(jìn)上面的請求體。第三步確認(rèn)newType映射表單按鈕點擊用5表單提交成功用3服務(wù)購買成功用10。三個事件一次回傳不要分三次。第四步執(zhí)行 curl 或后端腳本觀察返回。返回code:0后刷新聯(lián)調(diào)頁面三張卡片應(yīng)該全部變綠。第五步如果還有卡片沒亮單獨回傳那個事件的newType看返回和頁面變化。比如「表單按鈕點擊」沒亮就只傳newType5確認(rèn)是不是編碼問題。第六步聯(lián)調(diào)通過后把測試bd_vid換成真實用戶行為里的bd_vid在正式環(huán)境回傳。真實bd_vid來自用戶點擊廣告后落地頁 URL 里的參數(shù)后端要把它存下來跟用戶 ID 關(guān)聯(lián)。這里有個細(xì)節(jié)bd_vid是百度用來關(guān)聯(lián)點擊和轉(zhuǎn)化的唯一標(biāo)識聯(lián)調(diào)用的bd_vid和正式環(huán)境的不一樣。聯(lián)調(diào)通過只代表你的請求格式和newType對了正式回傳還要確保bd_vid能正確透傳。如果你在聯(lián)調(diào)過程中需要調(diào)模型做線索意圖判斷可以用 TaoToken 的 Coding Plan 來跑批量測試https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它適合長期編碼和 Agent 場景聯(lián)調(diào)時用來批量驗證回傳邏輯比較順手。5. 本篇常見錯排查newType 與線索 API 的 7 類報錯這一節(jié)把我踩過的和搜索時看到的錯誤歸一下類你對著排查能省不少時間。第一類newType傳錯導(dǎo)致頁面不亮。這是最高頻的。表現(xiàn)是接口返回 success但聯(lián)調(diào)頁面某張卡片一直「待聯(lián)調(diào)」。排查方法對照上面的表確認(rèn)你選的事件和newType是否匹配。表單按鈕點擊是5不是3。第二類一次只傳一個事件。表現(xiàn)是傳了 A 事件B 事件卡片不亮。百度聯(lián)調(diào)頁面是按事件獨立校驗的你選了幾個事件就要傳幾個newType。建議第一次就把所有事件的newType一起傳。第三類bd_vid過期。聯(lián)調(diào)頁面 1 小時超時超時后bd_vid失效再傳也是 success 但頁面不動。排查方法重新掃碼生成新bd_vid重新回傳。第四類token填錯。表現(xiàn)是接口返回非 0 錯誤碼。排查方法去百度推廣后臺轉(zhuǎn)化追蹤詳情頁復(fù)制 token注意不要多空格。第五類convertTime格式錯。百度要毫秒時間戳傳成秒級會解析異常。排查方法用Date.now()或time.time()*1000生成。第六類請求頭Content-Type沒設(shè)。表現(xiàn)是接口報參數(shù)錯誤。排查方法加-H Content-Type: application/json。第七類把 TaoToken 的 Key 和百度 token 搞混。TaoToken 的 Key 是給模型 API 用的百度 token 是給線索 API 用的兩者不能互換。排查方法檢查請求體里的token是不是百度后臺那個。注意聯(lián)調(diào)頁面顯示 success 不等于轉(zhuǎn)化追蹤配置完成。聯(lián)調(diào)只是驗證你的回傳格式和newType正確正式投放還要確保真實bd_vid能透傳、回傳時機(jī)對、去重邏輯對。6. 語義一致 CTA聯(lián)調(diào)通過后的接入與驗證入口聯(lián)調(diào)通過后接下來就是把測試邏輯搬到正式環(huán)境。正式環(huán)境要處理三件事bd_vid的透傳和存儲、回傳時機(jī)的選擇注冊成功、付費成功等、以及重復(fù)回傳的去重。去重可以用bd_vid newType做唯一鍵避免同一轉(zhuǎn)化多次上報。如果你在正式接入時需要統(tǒng)一管理模型 KeyTaoToken 的接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各語言的接入示例。API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成后寫進(jìn) CC Switch 的settings.json骨架即可。驗證模型通道是否正常用模型對話頁面最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。長期做編碼和 Agent 聯(lián)調(diào)的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。最后說個我自己的經(jīng)驗百度轉(zhuǎn)化追蹤聯(lián)調(diào)最耗時的不是寫代碼是等聯(lián)調(diào)頁面刷新和重新掃碼。所以第一次就把newType對照表查清楚三個事件一次傳完能省掉我那次 7 次重試?yán)锏拇蟛糠謺r間。newType5這個值我建議你直接記在便簽上。