小红书广告事件管理 API 回传的技术接入步骤-精准获客

3.20 版本更新：对接文档已更新，过往对接成功的客户不受任何影响；新客户对接时鉴权取消，对接效率得以提升

一、接入流程

小红书广告回传数据的接入流程

二、接入准备

1. 通过聚光平台（小红书广告平台）获取投放账号 id（advertiserId）

2. 开展聚光回传联调

小红书广告投放账户的获取

三、

回传数据接口

1. 通信协议

支持通过 HTTPS 通道进行请求通信。出于安全性考虑，建议使用 HTTPS 通道发送请求。

2. 请求方法

支持以 HTTPS POST 方法发送请求，在此方式下，请求参数需包含在请求的 Body 中。

3. 请求参数

上报字段	字段名称	格式	是否必须	样例及说明
广告主 id	advertiser_id	string	是	“1233223”
转发方法	method	string	是	固定为”aurora.leads”
token	access_token	string	是	“38F06A2B7207377EF379388F2A896DA501” 获取方式详见【获取 accessToken】章节
转化事件类型 id	event_type	string	是	“101”，具体情况详见【转化事件详细说明】
转化发生时间	conv_time	long	是	1687683565558，时间戳格式，毫秒
click_id	click_id	string	是	事件对应的 click_id，与页面跳转的 click_id 相同

转化事件详细说明：

事件名称	事件类型 id	事件描述
表单提交	101	用户在页面内完成表单填写并提交，可作为优化目标
有效表单	102	提交线索的用户进一步完成了一次有价值的行为，具体行为取决于广告主的业务模式，例如预约到店等
电话拨打	111	用户点击给商家拨打电话，可作为优化目标
电话接通	112	商家给用户拨打电话并接通
微信复制	121	用户完成个人或公众号复制行为，引导用户加粉，可作为优化目标
微信加好友	122	用户完成个人或公众号加粉
负向样本	200	不可直接作为广告的优化目标使用，但回传后有利于优化整体的小红书广告效果
身份认证	131	用户完成身份认证，比如金融类可能会使用身份证号、人脸识别进行身份认证
付费	141	用户完成商品购买行为，可作为优化目标

四、附录

1. 异常情况排查

每个请求在返回的 httpResponseHeader 中都会返回 Cat-Msg-Id，如果请求出现异常，可将此 Cat-Msg-Id 发送至群中，以便排查。

示例：

Cat-Msg-Id

karen-gateway-openapi-ac190997.27624-464187-1023

2. 错误码

特殊情况

若传递的 body 无法解析，则 httpcode 为 400

（1）成功

code	msg	描述
0	成功	成功

（2）通用