小红书聚光 · 上报转化

POST

https://www.mxsd.com/openapi/v1/wecom/acquisition/adcallback/xiaohongshu/conversions

外部页面或服务端把发生在本平台链接上的转化（表单、注册、购买等）上报给平台，进入广告回传。链接必须属于当前账号；用 out_id 去重，购买类转化必须带 out_id。
调用接口需要所属主业务套餐允许调用API。

请求参数

Authorization

API Key

在 header 添加参数

X-API-Key

示例：

X-API-Key: ********************

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "chain": "string",
    "chain_id": 0,
    "clickid": "string",
    "conv_type": "string",
    "external_userid": "string",
    "out_id": "string",
    "value_cents": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.mxsd.com/openapi/v1/wecom/acquisition/adcallback/xiaohongshu/conversions' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "chain": "string",
    "chain_id": 0,
    "clickid": "string",
    "conv_type": "string",
    "external_userid": "string",
    "out_id": "string",
    "value_cents": 0
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "result": {
        "chain_id": 0,
        "conv_type": "string",
        "duplicate": true,
        "event_id": "string"
    },
    "status": 1
}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

修改于 2026-10-11 09:22:51

小红书聚光 · 转化明细

小红书聚光 · 广告平台凭据是否已配置