小红书广告聚光表单投放的线索管理——获取线索列表 API 对接开发说明（对外）

1. 小红书广告对接流程

首先，于落地页的数据推送功能处，填写有效的 POST 消息接收地址。

其次，发送测试消息展开联调测试，只有 response code 为 200 方能联调成功。

最后，运用联调成功的落地页进行投放，API 会实时回传表单数据。

2. 小红书广告平台功能截图

3. 小红书广告消息发送

当用户提交表单时，会以 POST 请求的形式，并采用 JSON 数据格式，将信息推送至在落地页配置页面填写的消息接收地址。若 response code 为 200，则视为推送成功。对于推送失败的情况，会每隔 30 秒重试一次，最多重试 3 次。

地址格式要求：必须是对外开放的、能够接受 PSOST 请求的 http 服务 URL 。

4. 小红书广告签名验证

为保障消息来源确为小红书，可选择对 POST 数据的来源进行安全认证（非强制），验证方式如下：

① 解析 POST 消息 header 中的 X-Red-Signature 参数（格式为 sha1= 5bf9f4192d049dfe442edbcd533223673bb188e4）

② 解析 POST 消息的 request body（未经反序列化的原始 body 数据）

③ 以落地页配置页面获取的 token 作为 secretKey，结合 body 数据生成签名，并与 header 中的 signature 进行校验。

5.

小红书广告

常见问答

Q1、小红书广告投放

在表单的 API 回传中，是否存在默认的用户提交表单的地域数据，还是必须由客户定义字段对用户信息进行收集后才回传？

A：

仅支持通过地址或门店组件之类的方式进行记录或传递，不存在默认情况。

Q2、 用户在小红书广告推广表单落地页表单成功提交手机号等信息，但 api 回传到客户 crm 系统却查询不到信息？

A： 可能性 1：小红书广告对外传时有基于用户 id 与落地页 id 的去重机制，同一页面多次提交相同手机号仅传一次；通常发生于客户内部员工测试链路时，建议客户先更换手机号再进行测试。可能性 2：是否在测试数据发送时页面上未配置 API；若是，建议客户更换用户账号重新提交。如仍存在问题，需按照排查模板提交排查。

Q3、小红书广告 api 回传是否支持上传加密文件？

A： 不支持。

Q4、 回传是否支持区分搜索和信息流？

A： 支持，通过字段 channel 区分。

Q5、 url 字段是投放的落地页 url 吗？存在编码吗？

A： 是发送地址，并非落地页地址，与编码无关。

Q6、 表单数据里面的 label 值，是表单里定义什么就传什么吗？

A： 是的。

Q7、小红书广告文档里的参数中没有渠道号信息，如果想在 url 里埋渠道号来区分数据，应如何操作？

A： 不支持定制参数。

Q8、 A 落地页的 token 是每个表单都不同还是一个账户下共用一个 token？

A： 为专业号下的唯一 token 。