小红书之友
行业资讯
上一页 1 2 3
...
下一页

小红书广告推广表单API 对接

发表时间:2023-12-07 19:39

小红书广告推广表单API 对接

1. 表单数据 API 对接文档

1.1 对接流程

第一步:在落地页-数据推送功能处填写有效的POST消息接收地址
第二步:发送测试消息进行联调测试(response code必须为200才可联调成功)
第三步:使用联调成功的落地页进行投放,API实时回传表单数据

1.2 平台功能截图

小红书广告推广


1.3 消息发送

小红书广告推广当用户提交表单时,会将信息以 POST 请求的方式,JSON数据格式推送到在落地页配置页面中填写的消息接收地址。对于response code为200即认为推送成功,对于推送失败的情况,会每隔 30s重试一次,最多重试 3 次。


地址格式要求:对外开放的,可接受PSOST请求的http服务URL

e.g. http://example.com/leads

1.4 签名验证

为了确保消息来源是小红书,可以选择对POST数据的来源进行安全认证(非必须),验证方法如下:

● 解析POST消息header中的X-Red-Signature参数(格式为sha1=5bf9f4192d049dfe442edbcd533223673bb188e4)

● 解析POST 消息的request body(未经反序列化的原始body数据)

● 以落地页配置页面获取的token为secretKey,和body数据生成签名,与header中的signature进行校验

Java示例代码:Java示例代码

Python示例代码:Python示例代码

推送消息示例:直接提供代码示例,包含姓名,电话,邮箱,性别,地址,单选,多选,文本,数值等类型的代码示例   推送消息示例

签名验证 demo(Java):签名验证

2. 有效表单回传 API 对接文档

目前,若客户在落地页-数据推送功能处填写了有效的POST消息接收地址,则用户提交的表单数据会通过小红书广告推广表单数据API回传给客户。有效表单是指,用户通过广告点击,跳转建站落地页后进行留资,客户收到线索后通过电话、微信等形式回访用户,确认用户转化意向的,当做有效表单。本API解决的是有效表单回传的问题。

2.1 操作流程

1) 小红书广告推广在落地页 - 数据推送功能处填写有效的 POST 消息接收地址

2) 发送测试消息进行联调测试(response code 必须为 200 才可联调成功)

3) 使用联调成功的落地页进行投放,API 实时回传表单数据

4) 通过接口回传表单相关数据,回传的表单数据会默认为有效表单

2.2 接口说明

请求地址:https://www.xiaohongshu.com/api/hawking/leads/return

请求方法:POST

请求头:Content-Type:application/json

2.3 参数解释

小红书广告推广



2.4 请求示例

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/json' -d '{

"campaignId": 1834295,

"creativityId": 9725765,

"leadsId": "61935e4f2e299c0001fea6e8",

"unitId": 2244696

}' '
https://www.xiaohongshu.com/api/hawking/leads/return'


正确返回:

{

"result": 0,

"success": true,

"msg": "success"

}


广告投放
 
 

18971576794

小红书渠道活码.png

免费开户中


需求提交>>