一、  产品介绍及功能更新

1.聚光开放平台（小红书广告平台）Marketing API 是什么？

 小红书 Marketing API 是一套投放平台功能的接口服务，通过 Marketing API 可以帮助广告客户构建数据闭环，客户可接入 Marketing API 将自有平台与小红书广告投放平台整合打通，并且实现广告投放过程中的各项功能。

2.当前聚光开放平台（小红书广告平台）提供哪些核心能力？

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

①有聚光（小红书广告平台）投放账号，在小红书聚光广告平台具有一定投放经验的行业重点客户

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

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

（1）对接步骤分2步

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

Step 2：拿到授权信息后可完成线上授权后，启动接口调用

完成邮件+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时，需提供调用方的隐私政策，证明客户有合理合法管理用户数据的能力

②客户需主动配合提交，附件形式添加（需加盖公章）or 网页链接 任选其一

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

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

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，是因为离线数据关键词合并了吗

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

以上就是小红书聚光广告平台推广白皮书的产品介绍及常见问题解答，大家在进行小红书广告投放时如果遇到这些情况的话可以根据以上内容解决。小红书是一个不错的广告投放平台，有许多的广告主在上面投放广告后都得到了不错的广告效果。如果有想要进行小红书广告投放的可以联系我们巨宣网络，小红书广告投放电话：4009602809。