百度广告投放：线索API对接常见问题

1、Q：对接百度搜索广告推广或百度信息流广告推广，如何进行API联调？

A：可直接从账户后台对应的转化追踪里点击联调（会跳转至开发者中心），或者直接在开发者中心进行API接口联调。

2、Q：线索API联调状态一直是联调等待或联调失败，应该如何排查？

A：首先请排查API接口是否正确调用，返回status字段（状态码）为0，表示上传数据成功；其次，请排查是否回传了正确的logidUrl，logidUrl中需带有联调的bd_vid参数；接下来请排查回传的转化类型是否与创建联调的转化类型（convertType值）相符；最后，如果对接百度信息流广告推广，需判断下回传的联调数据是否超时。

3、Q：同时对接百度搜索广告推广和百度信息流广告推广，回传代码有区别吗？

A：回传接口没有区别，并且您可以用同一Token回传两种渠道的转化数据，百度后台可自动区分投放渠道，只要确保广告主回传接口具有回传两个渠道转化数据能力即可。

4、Q：PHP代码参考示例调用为什么返回结果不正确？

A：尝试在您的调用代码中加入下行代码，跳过证书校验 图片.png

5、Q：Ajax调用接口存在跨域问题，如何解决？

A：API接口由于涉及账户Token这类敏感信息，强烈建议不要使用Ajax接口调用，请将接口调用挪至服务端调用。

 6、Q：是否可以用Ajax调用API接口？

A：不可以，强烈建议不要使用Ajax接口调用，请将接口调用挪至服务端调用 

7、Q：调用回传接口时，显示的http状态码是415，是怎么回事？

A：http请求header中，设置Content-Type：application/json; charset=utf-8

 8、Q：发生转化后，转化数据最多可以延迟多久回传？

A：建议实时回传，最多延迟1小时，再长效果可能达不到预期。

9、Q：API调用接口返回「params error」，怎么回事？

A：请参考API接口文档，确认回传参数符合百度要求，尤其需注意回传数据是否可被解析为标准JSON格式，以及conversionTypes是否是标准的JSONArray。

10、Q：如何回传「有效线索」类转化？

A：首先，需确认广告主是否有通过第三方咨询平台收集有效线索，如果没有，那么广告主技术同学可在代码逻辑中自行判断，当该条转化数据为「有效线索」时，将数据回传；如果广告主是通过第三方咨询平台收集的线索数据，则需要广告主技术同学首先与第三方咨询工具对接，获取网民咨询数据，然后自行用程序判断数据是否为「有效线索」，是的话将数据回传。

11、Q：如何获取bd_vid？

A：

（1）对接搜索推广，请在「工具中心」-> 「优化工具」-> 「转化追踪」下，新建接入方式为「线索API」类的转化追踪，开通转化追踪后，在网民点击百度广告链接后，bd_vid参数会由百度自动添加到您该账户所推广的落地页Url后；

（2）对接信息流推广，请在「工具中心」-> 「优化工具」-> 「转化追踪」下，新建接入方式为「线索API」类的转化追踪，百度会自动在您URL后追加bd_vid=参数，数据回传时，需要您在推广URL找到bd_vid=XXXXX参数，连同转化数据一起回传给百度，用于转化数据拼接。

12、Q：开启转化追踪后，bd_vid多久会出现？

A：开通后一个半小时左右生效。

13、Q：bd_vid是否会重复？

A：bd_vid不会重复，网民每次点击广告产生的bd_vid均不同。

14、Q：进行联调扫描二维码一直显示“未发现有效二维码”，更换多个手机，均提示此问题，是什么原因导致？

A：使用最新版本的安卓百度营销 app扫描二维码能正常识别，请客户更新 app 到最新版本后重试。

15:、Q：转化发生在二跳后的页面，如何透传落地页url中的参数bd_vid？

A：转化页面是二跳页面，可以尝试从header的referer中获取 进入落地页后，将bd_vid存储在cookie中 跳转前从当前页面的url中获取bd_vid，拼接到跳转的url中。

16、Q：落地页中未带bd_vid参数，怎么排查？

A：如果全部数据都没有都没有bd_vid，请联系百度营销账户管理员查看相关账户是否开通了API的转化追踪； 如果部分数据没有bd_vid，首先判断这部分数据是否来自百度流量，查看回传是否是您开通转化追踪当天的数据，最后请查看是否存在二跳，多跳后的页面未透传bd_vid参数； 如果少量数据没有bd_vid并排查不属于上述原因造成，且数据量少于10%时，可忽略，有少部分流量未覆盖（如百度知道、动态创意抓取的链接等）。

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

A：不需要，百度会自动回传此参数。

18、Q：有多个推广账户，是否可以使用其中一个推广账户的Token回传所有账户的转化数据？

A：可以使用一个账户Token回传所有账户的转化数据，百度后台可根据bd_vid参数区分出具体的投放账号； 对于不同的投放渠道，百度搜索广告推广和百度信息流广告推广支持使用一个Token回传所有账户数据，百度后台可根据bd_vid参数区分投放渠道。

19:、Q：之前推广账户使用js回传，对接完API，需要下掉js吗？

A：可以不下掉，只需要在百度广告推广后台将数据来源设置为API回传。

20、Q：如何获取回传数据的权限码token？

A：开发人员需向您的百度广告营销账户管理员索要API数据回传需要的代码Token，需注意，如果您的百度广告营销账户管理员（SEM）同学点击了Token重置，为避免您的回传接口存在权限问题，您也需要在程序中更改成最新的Token。重置Token是实时生效的，请尽量减少更新频率。

21、Q：同时对接搜索推广和信息流推广，Token要如何配置？

A：百度搜索广告推广和百度信息流广告推广可以使用同一Token回传数据。

22、Q：同一主体多个账户是否可以用一个token？

A：可以多个推广账户用一个token传回数据。 

线索API对接是百度广告投放中的一项技术功能，它允许广告主将自家的客户关系管理系统（CRM系统）与百度广告系统进行数据对接。通过这个功能，广告主可以更方便地管理广告投放中的线索，提高转化率和客户满意度。使用线索API对接需要注意的是，广告主需要先在百度广告系统中创建自家的CRM系统应用，并获取相应的API密钥和参数。同时，广告主还需要根据自己的需求选择合适的对接方式和数据格式，并确保数据的准确性和安全性。

公司优势

开户流程

注意事项