README：
当下，小红书聚光广告平台在进行线索拉取与回传时，所涉及的链路颇为复杂，而且 API 对接本身属于技术对接范畴，沟通成本颇高。特此提供一份文档，助力大家明晰当前的流程以及客户可能面临的问题，期望客户的疑问在此都能找到答案。
一、产品认知
|
场景 |
链路 |
是否需要加白 |
使用场景 |
特殊说明 |
适合客户 |
|
线索 |
API 推送：有表单有私信 |
否 |
运用小红书聚光广告落地页（表单场景）时，需通过 API 对接的方式获取用户数据 |
无 |
技术能力完备 |
|
使用私信场景，需通过 API 对接获取私信数据 |
无 |
||||
|
老链路 API 回传：仅表单，无私信 老链路不再支持，全部迁移至新链路 |
否 |
—— |
无 |
||
|
使用自研落地页且选择【表单提交】优化目标，需通过 API 对接的方式将用户提交的表单数量回传给小红书聚光广告平台，便于模型归因学习 |
无 |
||||
|
新链路 API 回传：仅表单，无私信 全量新链路 |
是 |
使用落地页时，需通过 API 对接的方式将【用户提交的表单数量】或【高意向数据量】回传给聚光平台，以利模型更深入地学习探索 |
无 |
||
|
口令码 |
口令码 API 回传，仅 app 口令码 |
是 |
【app 平台类客户】采用口令码模式进行数据对接 |
仅适用于【app 平台类客户】 |
小红书广告创编
二、回传链路 API 更新缘由
在小红书广告场景中，数据回传与模型优化存在必然关联。
当前客户可选的优化目标尚处于较浅层次，难以满足客户对更高意向人群优化及获取更优效果的需求。为此，针对线索场景推出深度转化优化目标，以实现更后端的效果优化。
若要达成更深度的优化，必然要求客户进行更深入的数据回传，并且这些数据需进行意向性区分，比如：表单提交、表单可接通、表单有意向、表单加为好友等，切不可混杂回传给模型，否则模型无法学习更深层次的人群，还会对浅层目标产生负面影响。
浅层优化目标和老链路 API 无法满足客户回传不同意向的表单并进行学习，于是新链路 API 和深度转化优化目标一一对应，相应地衍生出【事件管理】产品，用于查看客户回传的不同意向数据。
深度转化优化目标—事件管理—新链路 API，这三个产品紧密绑定。
由于近期部分客户已加白新链路 API，会涉及新老链路交替，必然会产生一些问题，所以：
①若使用自研落地页的客户采用老链路 API 回传，且未出现任何使用问题，建议暂时无需进行任何变动和操作，也不必立即切换为新链路 API 回传；
②若客户已在对接新链路 API 回传，依照文档继续对接即可，也无需切换为老链路 API。
三、FAQ：
此部分能够解决您遇到的 90%的新老链路问题。
1.新链路
（1）若新链路 API 已加白，能否直接使用深度转化优化目标？
a. 可以，当下新链路 API 和新创编加白已合并为一个入口。
（2）若小红书广告账户新链路 API 已加白，是否必须使用新链路 API 和深度转化优化目标？
a. 并非如此，加白后可不使用深度转化目标，但必须使用新链路 API 回传。
（3）客户使用新链路 API 联调，一直显示“检测中”，为何？
a. 客户转化事件 ID 回传有误。
（4）客户使用新链路 API 联调，显示“回传超时”，为何？
a. 客户回传时间超过 1 小时；
b. 客户通过老链路回传接口回传数据，链路使用错误。
（5）客户能否一个资质获取一个 token 进行对接？
a. 目前获取 token 的能力尚未产品化，每个广告主 ID 匹配一个 token。
（6）新链路联调、预览数据和聚光报表数据对不齐，而老链路可以对齐，为何？
a. 新链路 API 联调和预览的数据均不计入报表的转化数据；老链路联调的数据不计入报表，但预览数据计入报表。
（7）客户如何辨别当前链路是新还是老？
a. 老链路获取 trackID，新链路获取 clickID。
（8）新链路 click_id 这个参数如何获取？以及格式是怎样的？
a.用户点击广告时，每次点击广告服务都会生成一个 clickId，在跳转到落地页时，会将 clickId 作为参数传入对应的 URL 中；
当前不支持下发其他宏参数，仅拼接 clickID，广告主回传自动拼接好 clickID 的参数，小红书聚光广告平台依据 clickID 进行归因显示
（9）新版 API 联调环境和生产环境格式不一致，导致 ClickID 兼容性问题在联调环境无法暴露
（10）客户使用外链落地页，加白新链路 API 后，在创编页面的资产事件中为何无法选择事件？
a. 事件管理【新链路 API 联调成功后】，创编页面才会出现资产和事件的选择入口
小红书广告资产事件
（11）客户加白新创编后，在创编页面无法在资产事件中勾选【有效表单】，为何？
a. 【新链路 API 联调成功后】且【事件中必须要有有效表单】，其他微信复制资产并非有效表单。
（12）若客户极其期望使用深度转化，具备技术能力且拥有庞大的数据量，能否加白新创编？
![图片[1]-小红书广告后台【客资收集 API 对接】的产品说明文档-精准获客](https://cos.jingzhunhuoke.net/tu/suolue/3.jpg)
a. 可以线索深度转化&API 对接白名单
（13）若历史上使用小红书聚光落地页广告并回传有效表单数据，且在小红书聚光广告报表的有效表单字段中显示数据，想使用深度转化是否仍需更新新链路 API 回传？
a. 需要，老创编中通过聚光落地页回传的有效表单数据不能作为深转的模型使用，必须通过新链路 API 回传。
（14）联调成功后，客户测试留资成功但线索在聚光无显示或显示延迟？
a.联调过程中回传参数回传后会变为联调成功，联调数据不会在报表中体现。
b.客户使用小红书聚光广告预览链路进行留资测试链路会影响实时回传，建议联调成功后开始正式投放。正式留资路线为开启计划投放后在小红书 APP 刷到笔记进行留资。
c.资产事件联调成功，有回传数据但是聚光报表仍然无显示，请检查回传的 clickID，clickID 在联调环境下开头为 atestXXX,联调数据不会在报表中体现。
（15）何为预览链路？
a.扫描聚光落地页二维码，点击笔记广告进行留资即使用预览链路。
（16）表单/私信线索推送缺少推送字段（如广告计划 ID 等任何字段）
a.私信线索会反复推送，请检查看到的不完整线索是否为反复推送的后几条。
b.C 端客户未通过该计划投放的笔记点击进入私信/落地页进行留资，线索来源即为空，可与主账号线索管理下的线索信息再次核对。
（17）客户有多个账号时，应使用哪个小红书广告投放账号 ID 进行数据回传？
a.请客户使用品牌账号 ID 进行数据回传
（18）想取消私信/表单 API 推送如何操作？
a.在私信/表单 API 对接处点击编辑然后直接删除 post 消息接收地址即可。
（19）私信/表单推送 API 对接后，之前的线索还会有推送吗？
a.目前未配置 api 之前的线索无法补推
四、老链路 【2024 年 2 月 29 日后将不再有老链路回传】
1. 客户回传数与小红书聚光广告后台报表数对不齐，原因何在？
a. 客户可能将不同的账户 ID 数据混在一起回传。
2. trackID 字段参数如何获取？
a. 用户点击广告，每次点击广告服务都会生成一个 trackId，在跳转到落地页时，会将 trackId 作为参数传入对应的 URL 中。
b.广告主回传 trackId 与转化行为，小红书广告平台会通过 trackId 关联到该次转化对应的广告，从而得到点击与转化的关联。
3. 发送请求时为何会出现如下情况？
a. 客户跨域，需客户进行技术处理
4. click_id 是 default，为何返回值是成功？
a. clickid 的校验在下游处理数据时进行，未在接口侧进行，不影响客户后续会优化。
5. 客户有 N 个账户 ID，回传时给 a 账户回传 3 条，给 b 账户回传 10 条，但最后发现小红书广告账户 a 展示 10 条数据，为何？
a. 客户回传的数据和平台归因账户不一致，以平台归因为准。只要客户的所有小红书广告账户数据和客户回传的数据保持一致即可。
以上内容源自精准获客为大家分享的《小红书广告后台【客资收集 API 对接】产品文档》，阅读完以上内容若有不解之处，可联系我们精准获客对接小红书平台的工作人员。若有企业主想要进行小红书广告投放，也可联系我们！小红书广告投放电话：点击右下角按钮获取联系方式。
2 本站部分内容来源于网络，仅供学习与参考，如有侵权，请联系网站管理员删除
3 本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
4 精准获客感谢您的访问！希望本站内容对您有所帮助！
暂无评论内容