聚光 – Marketing API 推广白皮书 | 小红书广告

聚光开放平台的数据 API 已于 2023 年 11 月正式启用。如何申请接入流程？接入过程中又会遇到哪些常见问题？通过搜索关键词(Command/Ctrl+F)，为您解决 API 接入的相关困扰。

一、产品介绍与功能更新

1. 聚光开放平台究竟是什么？

小红书的 Marketing API 是一套关于投放平台功能的接口服务。借助 Marketing API，广告客户能够构建数据闭环。客户能够接入 Marketing API，将自有平台与小红书广告投放平台相融合，实现广告投放过程中的各类功能。

2. 当下聚光开放平台提供的核心能力有哪些？

当前提供数据接口能力，预计在 2024 年 1 – 2 双月提供小红书广告管理接口，以提升您在小红书的广告投放效率。

3. 聚光数据 API 的接入门槛

①拥有聚光投放账号，且在小红书聚光平台有一定投放经验的行业重点客户。

②具备成熟的 API 对接经验，同时拥有技术能力和技术资源来进行合作对接。

4. 聚光数据 API 接入流程

对接步骤分为以下几步：

Step 1：注册成为开发者，注册流程由小红书销售内部发起审批。注册完成后，我们将提供相应的授权信息，由销售转发给品牌/代理。

Step 2：获取授权信息后完成线上授权，便可启动接口调用。

小红书广告开发者注册 – 使用全流程

5. 开发者注册 – 资料准备：

客户协助提供资料，由小红书销售发起内部审批，入驻分为三种不同身份类型：

①公司主体名称

②回调地址：（调用聚光 API 的地址 ）

③申请授权的聚光账号 ID

④代理商主账号 id 申请人和聚光账号的关系：本人账号

⑤申请功能权限：（数据接口）

⑥数据调用方的隐私政策：（以附件形式添加数据调用方的用户隐私政策，需加盖公章）/网页链接

①公司主体名称：

②回调地址：（调用聚光 API 的地址）

③申请授权的聚光账号 ID：品牌主账号

④申请人和聚光账号的关系：本人账号

⑤申请功能权限：（数据接口）

⑥数据调用方的隐私政策：（附件形式添加数据调用方的用户隐私政策，需加盖公章）/网页链接

①公司主体名称：

②回调地址：（调用聚光 API 的地址 ）

③申请授权的聚光账号 ID（广告主账号）

④申请人和聚光账号的关系：服务商

⑤申请功能权限：（数据接口）

⑥数据调用方的隐私政策：（附件形式添加数据调用方的用户隐私政策，需加盖公章）/网页链接

⑦授权协议：以附件形式添加（需加盖公章）“聚光”平台开放 API 授权承诺函（线下签署）

⑧API 使用协议：“聚光”平台开放 API 使用协议下载后以附件形式添加（需加盖公章）

⑨营业执照：（附件形式添加）

6. 客户技术对接：销售侧审批完成后，小红书将为您提供授权信息，获取授权信息后即可开启您的 API 能力对接（对接流程如下）

①API 申请通过后的使用有效期为一年，一年后自动失效，届时需要您重新发起申请。

②API 接口文档：API 接口文档 – token 管理

二、 近期上线功能

1. 获取单元列表接口及获取账号余额接口全新上线！

（已获得授权的客户可直接请求调用，处于对接中或有意向的客户需完成 API 申请流程后使用）

（1）获取单元列表接口，支持获取计划单元维度字段，例如商品 id、笔记 id、直播用户 id、落地页 URL、外链 URL 等

接口地址：单元列表接口

（2）获取账号余额接口，支持实时请求查看小红书广告账户余额、现金余额、可用金额等金额字段信息

接口地址：账号余额接口

三、接入及使用常见问题

1. 离线数据和实时报表的差异何在？

①更新频率存在区别：离线报表每天 10 点后提供；实时报表实时更新。

②查询范围不同：离线报表的查询范围为 T – 1 及之前，实时报表的查询范围为当前时间及之前。

③数据用途不同：离线报表适用于长期趋势分析和比较。您能够依据广告活动在较长时间内的表现，进行整体评估和决策。实时报表适合短期决策，您可以了解小红书广告投放的即时数据，比如小红书广告展示次数、点击率、转化率等，从而对小红书广告投放进行实时优化和调整。

2. 关于授权：

（1）“一对多”时能否一次授权？需要哪些证明？

①同一品牌下涉及多个主体时，品牌方、代理商同学均可联系小红书对应的销售同学，提供相应的授权证明来调用全部小红书聚光广告账户数据。

②一个主体下有多个专业号的情况，申请授权的聚光账号 ID 需要提供全部聚光品牌主账户的 ID。

③对于由服务商接入的品牌/代理，不支持服务商通过主账号一次授权，必须通过聚光品牌主账户维度 1v1 授权。

（2）新开专业号是否需要重新按流程申请？

新开专业号在原邮件基础上提报即可。

3. 关于回调：

（1）目前聚光的回调能力支持哪些功能？

目前支持报表数据能力回调，预计 2024 年 1 – 2 双月上线广告管理接口，如果您有新的需求，欢迎随时反馈~

（2）回调地址能够更改吗？

回调地址不支持更改。

（3）回调地址的有效期是多久？

客户点击授权时，小红书聚光平台会携带 auth_code 请求回调地址，auth_code 有效期为 10 分钟。

（4）什么是回调地址，需要关注入参和出参吗？

回调地址是小红书聚光平台侧授权完成后请求广告主的地址，请求时会在回调地址后面携带 auth_code

以上便是精准获客为大家分享的《聚光 – Marketing API 推广白皮书 | 小红书广告》，有意向投放小红书广告的可以联系我们精准获客。小红书广告投放电话：点击右下角按钮获取联系方式。