百度廣告投放：線索API對接常見問題

1、Q：對接百度搜索廣告推廣或百度信息流廣告推廣，如何進行API聯(lián)調(diào)？

A：可直接從賬戶后臺對應(yīng)的轉(zhuǎn)化追蹤里點擊聯(lián)調(diào)（會跳轉(zhuǎn)至開發(fā)者中心），或者直接在開發(fā)者中心進行API接口聯(lián)調(diào)。

2、Q：線索API聯(lián)調(diào)狀態(tài)一直是聯(lián)調(diào)等待或聯(lián)調(diào)失敗，應(yīng)該如何排查？

A：首先請排查API接口是否正確調(diào)用，返回status字段（狀態(tài)碼）為0，表示上傳數(shù)據(jù)成功；其次，請排查是否回傳了正確的logidUrl，logidUrl中需帶有聯(lián)調(diào)的bd_vid參數(shù)；接下來請排查回傳的轉(zhuǎn)化類型是否與創(chuàng)建聯(lián)調(diào)的轉(zhuǎn)化類型（convertType值）相符；最后，如果對接百度信息流廣告推廣，需判斷下回傳的聯(lián)調(diào)數(shù)據(jù)是否超時。

3、Q：同時對接百度搜索廣告推廣和百度信息流廣告推廣，回傳代碼有區(qū)別嗎？

A：回傳接口沒有區(qū)別，并且您可以用同一Token回傳兩種渠道的轉(zhuǎn)化數(shù)據(jù)，百度后臺可自動區(qū)分投放渠道，只要確保廣告主回傳接口具有回傳兩個渠道轉(zhuǎn)化數(shù)據(jù)能力即可。

4、Q：PHP代碼參考示例調(diào)用為什么返回結(jié)果不正確？

A：嘗試在您的調(diào)用代碼中加入下行代碼，跳過證書校驗 圖片.png

5、Q：Ajax調(diào)用接口存在跨域問題，如何解決？

A：API接口由于涉及賬戶Token這類敏感信息，強烈建議不要使用Ajax接口調(diào)用，請將接口調(diào)用挪至服務(wù)端調(diào)用。

 6、Q：是否可以用Ajax調(diào)用API接口？

A：不可以，強烈建議不要使用Ajax接口調(diào)用，請將接口調(diào)用挪至服務(wù)端調(diào)用 

7、Q：調(diào)用回傳接口時，顯示的http狀態(tài)碼是415，是怎么回事？

A：http請求header中，設(shè)置Content-Type：application/json; charset=utf-8

 8、Q：發(fā)生轉(zhuǎn)化后，轉(zhuǎn)化數(shù)據(jù)最多可以延遲多久回傳？

A：建議實時回傳，最多延遲1小時，再長效果可能達不到預期。

9、Q：API調(diào)用接口返回「params error」，怎么回事？

A：請參考API接口文檔，確認回傳參數(shù)符合百度要求，尤其需注意回傳數(shù)據(jù)是否可被解析為標準JSON格式，以及conversionTypes是否是標準的JSONArray。

10、Q：如何回傳「有效線索」類轉(zhuǎn)化？

A：首先，需確認廣告主是否有通過第三方咨詢平臺收集有效線索，如果沒有，那么廣告主技術(shù)同學可在代碼邏輯中自行判斷，當該條轉(zhuǎn)化數(shù)據(jù)為「有效線索」時，將數(shù)據(jù)回傳；如果廣告主是通過第三方咨詢平臺收集的線索數(shù)據(jù)，則需要廣告主技術(shù)同學首先與第三方咨詢工具對接，獲取網(wǎng)民咨詢數(shù)據(jù)，然后自行用程序判斷數(shù)據(jù)是否為「有效線索」，是的話將數(shù)據(jù)回傳。

11、Q：如何獲取bd_vid？

A：

（1）對接搜索推廣，請在「工具中心」-> 「優(yōu)化工具」-> 「轉(zhuǎn)化追蹤」下，新建接入方式為「線索API」類的轉(zhuǎn)化追蹤，開通轉(zhuǎn)化追蹤后，在網(wǎng)民點擊百度廣告鏈接后，bd_vid參數(shù)會由百度自動添加到您該賬戶所推廣的落地頁Url后；

（2）對接信息流推廣，請在「工具中心」-> 「優(yōu)化工具」-> 「轉(zhuǎn)化追蹤」下，新建接入方式為「線索API」類的轉(zhuǎn)化追蹤，百度會自動在您URL后追加bd_vid=參數(shù)，數(shù)據(jù)回傳時，需要您在推廣URL找到bd_vid=XXXXX參數(shù)，連同轉(zhuǎn)化數(shù)據(jù)一起回傳給百度，用于轉(zhuǎn)化數(shù)據(jù)拼接。

12、Q：開啟轉(zhuǎn)化追蹤后，bd_vid多久會出現(xiàn)？

A：開通后一個半小時左右生效。

13、Q：bd_vid是否會重復？

A：bd_vid不會重復，網(wǎng)民每次點擊廣告產(chǎn)生的bd_vid均不同。

14、Q：進行聯(lián)調(diào)掃描二維碼一直顯示“未發(fā)現(xiàn)有效二維碼”，更換多個手機，均提示此問題，是什么原因?qū)е拢?/strong>

A：使用最新版本的安卓百度營銷 app掃描二維碼能正常識別，請客戶更新 app 到最新版本后重試。

15:、Q：轉(zhuǎn)化發(fā)生在二跳后的頁面，如何透傳落地頁url中的參數(shù)bd_vid？

A：轉(zhuǎn)化頁面是二跳頁面，可以嘗試從header的referer中獲取 進入落地頁后，將bd_vid存儲在cookie中 跳轉(zhuǎn)前從當前頁面的url中獲取bd_vid，拼接到跳轉(zhuǎn)的url中。

16、Q：落地頁中未帶bd_vid參數(shù)，怎么排查？

A：如果全部數(shù)據(jù)都沒有都沒有bd_vid，請聯(lián)系百度營銷賬戶管理員查看相關(guān)賬戶是否開通了API的轉(zhuǎn)化追蹤； 如果部分數(shù)據(jù)沒有bd_vid，首先判斷這部分數(shù)據(jù)是否來自百度流量，查看回傳是否是您開通轉(zhuǎn)化追蹤當天的數(shù)據(jù)，最后請查看是否存在二跳，多跳后的頁面未透傳bd_vid參數(shù)； 如果少量數(shù)據(jù)沒有bd_vid并排查不屬于上述原因造成，且數(shù)據(jù)量少于10%時，可忽略，有少部分流量未覆蓋（如百度知道、動態(tài)創(chuàng)意抓取的鏈接等）。

17、Q： bd_vid是否需要手動添加？

A：不需要，百度會自動回傳此參數(shù)。

18、Q：有多個推廣賬戶，是否可以使用其中一個推廣賬戶的Token回傳所有賬戶的轉(zhuǎn)化數(shù)據(jù)？

A：可以使用一個賬戶Token回傳所有賬戶的轉(zhuǎn)化數(shù)據(jù)，百度后臺可根據(jù)bd_vid參數(shù)區(qū)分出具體的投放賬號； 對于不同的投放渠道，百度搜索廣告推廣和百度信息流廣告推廣支持使用一個Token回傳所有賬戶數(shù)據(jù)，百度后臺可根據(jù)bd_vid參數(shù)區(qū)分投放渠道。

19:、Q：之前推廣賬戶使用js回傳，對接完API，需要下掉js嗎？

A：可以不下掉，只需要在百度廣告推廣后臺將數(shù)據(jù)來源設(shè)置為API回傳。

20、Q：如何獲取回傳數(shù)據(jù)的權(quán)限碼token？

A：開發(fā)人員需向您的百度廣告營銷賬戶管理員索要API數(shù)據(jù)回傳需要的代碼Token，需注意，如果您的百度廣告營銷賬戶管理員（SEM）同學點擊了Token重置，為避免您的回傳接口存在權(quán)限問題，您也需要在程序中更改成最新的Token。重置Token是實時生效的，請盡量減少更新頻率。

21、Q：同時對接搜索推廣和信息流推廣，Token要如何配置？

A：百度搜索廣告推廣和百度信息流廣告推廣可以使用同一Token回傳數(shù)據(jù)。

22、Q：同一主體多個賬戶是否可以用一個token？

A：可以多個推廣賬戶用一個token傳回數(shù)據(jù)。 

線索API對接是百度廣告投放中的一項技術(shù)功能，它允許廣告主將自家的客戶關(guān)系管理系統(tǒng)（CRM系統(tǒng)）與百度廣告系統(tǒng)進行數(shù)據(jù)對接。通過這個功能，廣告主可以更方便地管理廣告投放中的線索，提高轉(zhuǎn)化率和客戶滿意度。使用線索API對接需要注意的是，廣告主需要先在百度廣告系統(tǒng)中創(chuàng)建自家的CRM系統(tǒng)應(yīng)用，并獲取相應(yīng)的API密鑰和參數(shù)。同時，廣告主還需要根據(jù)自己的需求選擇合適的對接方式和數(shù)據(jù)格式，并確保數(shù)據(jù)的準確性和安全性。