小红书聚光广告平台推广的白皮书之产品介绍与常见问题答疑

一、产品介绍与功能更新

1. 聚光开放平台（小红书广告平台）的 Marketing API 定义

小红书的 Marketing API 属于一套投放平台功能的接口服务。通过此 API，广告客户能够构建数据闭环。客户能够接入该 API，将自有平台与小红书广告投放平台加以整合打通，进而实现广告投放过程中的各项功能。

2. 当下聚光开放平台（小红书广告平台）提供的核心能力

3. 聚光（小红书广告平台）API 的接入门槛

① 拥有聚光（小红书广告平台）投放账号，且在小红书聚光广告平台具有一定投放经验的行业重点客户。
② 具备成熟的 API 对接经验，同时拥有技术能力和技术资源来进行合作对接。

4. 聚光（小红书广告平台）API 的接入流程

（1）对接步骤分为两步
Step1：注册成为开发者，注册流程由小红书销售内部发起审批。注册完成后，我们将提供相应的授权信息，由销售转发给品牌/代理。
Step2：拿到授权信息后可完成线上授权，然后启动接口调用。
完成邮件+OA 申请后，请在表格中登记需要接入 API 的账号信息，研发同学将定期处理您的申请。
小红书 API 使用全流程

开发者注册 – 资料准备：客户协助提供资料，小红书销售发起内部审批，分为三种不同身份类型入驻：
注意：小红书广告平台不直接对接第三方服务商，服务商入驻需由客户发起。例如品牌 A 通过服务商 B 接入开放平台，需客户 A 发起申请流程。

5. 聚光（小红书广告平台）数据 API 接口文档

API 申请通过后使用有效期为一年，一年后自动失效，需要您重新发起申请。
客户技术对接：销售侧审批完成后，小红书将会为您提供授权信息，拿到授权信息后您可参考接口文档，启动您的 API 能力对接。

二、近期上线功能

1. 获取单元列表接口及获取账号余额接口全新上线！
2. 获取单元列表接口，支持获取计划单元维度字段，如商品 id、笔记 id、直播用户 id、落地页 URL、外链 URL 等。
3. 获取账号余额接口，支持实时请求查看账户余额、现金余额、可用金额等金额字段信息。

三、接入及使用常见问题解答（FAQ）

1. 关于申请流程

Q：品牌/代理有多主体、多账号的场景如何进行申请？

（1）同一品牌下涉及多个主体，品牌方、代理商均可联系小红书对应的销售同学，提供对应的授权关系/关联证明（年框关联等）来调用全部聚光账户数据，销售同学在帮助客户进行邮件及 OA 申请时也需上传关联证明。
例如：品牌有 A1，A2 两个主体，若要使用相同的接口一次性查询 A1，A2 主体的账户数据，需要提供 A1 和 A2 的授权关系/关联证明，如年框合同关联关系等，销售同学在帮助客户进行邮件及 OA 申请时也需上传关联证明。
（2）一个主体下有多个专业号的情况，申请授权的聚光账号 ID 需要提供全部聚光品牌主账户的 ID。
例如：
①品牌有 b1,b2,b3 等多个专业号，申请 API 调用时需要写明全部的聚光品牌主账户的 ID。
②品牌有新增专业号的场景，销售同学在原申请邮件基础上提报即可，无需重复审批。
（3）对于通过服务商接入的品牌/代理，不支持服务商通过主账号一次授权，必须通过聚光品牌主账户维度 1v1 授权。
客户 R 有 r1,r2 两个专业号，通过服务商接入，授权时客户 R 需要分别登录 r1,r2 的聚光主账号进行授权。

Q：新开专业号需要重新按流程申请吗？

新开专业号在原邮件基础上提报后，表格填写账号信息，研发定期处理。

Q：注册申请开放 API 时，数据调用方的隐私政策是什么？如何提供？

①申请聚光平台（小红书广告平台）API 时，需提供调用方的隐私政策，证明客户有合理合法管理用户数据的能力。
②客户需主动配合提交，附件形式添加（需加盖公章）或网页链接任选其一。

Q：品牌/代理商通过第三方服务商接入 API，授权协议（小红书聚光平台（小红书广告平台）开放 API 授权承诺函）中【委托方】和【受托方】分别填写什么？

①委托方指品牌/代理商，可写多个主体。盖章处委托方有几个，就盖几个章。
②受托方指实际调用 API 的服务商/公司主体。

Q：报错“品牌授权给服务商开发者时广告主 id 不能为空”

①请确认当前聚光平台（小红书广告平台）登录的账号类型是否为该子账号的品牌主账号（投放账号 ID 下显示为品牌账户）。
②需要品牌主账号登陆聚光（小红书广告平台），然后点击提供的授权链接进行授权。

2. 关于接口调用

Q：调用 api 获取 token 时，返回的 approval_advertisers 会同时包含哪些账户？

①approval_advertisers 指授权广告主账号，代表 token 能操作的账号，会一次性返回该授权账号下的所有推广账户列表。作为品牌方及通过第三方服务商进行接入时有返回值，返回主账户+代理子账户；作为代理商时无返回值。
②账户数量不会造成接口时延，且获取 token 接口不能重复调用。若想使用新创建的子账号，需要重新进行一遍账号授权，再进行操作。

Q：Token 为什么失效了？

①Token 时效到期，Token 有效期与续期详见。
②同一个主账户重新进行账号授权，老的 token 会失效。

Q：API 有调用频次的要求吗？

每个开发者账户维度，调用量不超过 6000 次/1min。

3. 关于回调

Q：目前聚光的回调能力支持哪些功能？

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

Q：回调地址可以更改吗？

回调地址不支持更改。

Q：回调地址有效期是？

客户点击授权的时候平台会带上 auth_code 请求回调地址，auth_code 有效期为 10min。

Q：什么是回调地址，需要关注入参和出参吗？

回调地址是平台侧授权完请求广告主的地址，请求时会在回调地址后面带上 auth_code。

4. 关于数据报表和余额接口

Q：余额接口的数据更新频率？

每次请求都是实时数据。

Q：账户、计划、单元、创意层级返回的汇总数据/列表数据有哪些？

①账户层级：时间范围内，广告主维度汇总的一条数据。
②计划层级：时间范围内，一条汇总数据和所有计划数据 list。
③单元层级：时间范围内，一条汇总数据和所有单元数据 list。
④创意层级：时间范围内，一条汇总数据和所有创意数据 list。

Q：离线数据和实时报表有什么区别？

①更新频率不同：离线报表每天 10 点后提供；实时报表实时（秒级）更新。
②查询范围不同：离线报表查询范围为 T – 1 及之前，实时报表查询范围为当前时间及之前。
③数据用途不同：离线报表适合长期趋势分析和比较。您可以通过广告活动在较长时间范围内的表现，进行整体评估和决策。
实时报表适合短期决策，您可以了解小红书广告投放的即时数据，如广告展示次数、点击率、转化率等，对小红书广告投放进行实时优化和调整。

Q：API 的参数为什么比平台数据报表页面的少很多？

目前仅支持部分数据。

Q：实时数据可获取的时间范围是什么？

可获取的时间跨度需要在一年以内，同时两个时间点也需要在一年以内。

Q：数据获取的时间参数 start_time 和 end_time 是什么意思，如何获取当天数据？

start_time 是从日期 0 点开始，end_time 是结束日期的 23 点，例如 start_time：”2024 – 01 – 22“，end_time 是”2024 – 01 – 23″，查询的就是从”2024 – 01 – 22 00:00:00″到”2024 – 01 – 23 23:59:59″数据。

Q：抓取的实时报表为什么没有今天的数据/抓取的离线报表为什么没有昨天的数据？

可能是因为：
①小红书广告账户今天/昨天没有消耗，因此没有数据。
②今天/昨天数据报表还没有产出，可以尝试等待 30min 后重试。

Q：计划层级报表，不同计划可以返回不同字段吗？

可以，如果部门间的报表数据有差异，是可以不同计划返回不同字段的。

Q：计划实时报表，campaign_dtos 和 total_data 都是汇总数据，区别是什么？

campaign_dtos 是所有的汇总，total_data 是按计划 id 维度的汇总。

Q：关键词离线数据里面没有 keyword_id 关键词 id，是因为离线数据关键词合并了吗

关键词离线报表数据，是按照关键词进行结果合并。

以上便是小红书聚光广告平台推广白皮书的产品介绍及常见问题解答，大家在进行小红书广告投放时若遭遇这些状况，可依据上述内容予以解决。小红书是一个出色的广告投放平台，众多广告主在此投放广告后都收获了理想的广告效果。若有想要进行小红书广告投放的，可联系我们精准获客，小红书广告投放电话：点击右下角按钮获取联系方式。