数据接入说明

本文档说明棱镜数据基座如何接入第三方平台数据、相关协作主体的职责,以及数据安全保障。覆盖小红书平台范围内的所有接入方式。

适用对象 销售 品牌方 代理商 技术对接人
文档全貌

棱镜数据接入全景

从数据范围到安全保障的完整链路。点击任一区块跳转对应章节。

01 · 接入范围

棱镜通过 API 和 RPA 接入两类数据

API 通过平台官方接口获取,适用于时效敏感场景;RPA 通过模拟用户登录后台获取,适用于 API 未开放的字段或回溯数据。数据按所属权分为「私有」与「开放」。

私有数据 需品牌方授权

数据类型 来源平台 接入方式 说明
广告投放 聚光 + 乘风 API + RPA API 用于看板等时效敏感场景;RPA 用于回溯数据、小红星等 API 未开放字段
达人合作 蒲公英 RPA 博主报价、订单、表现趋势、跨域项目、组件趋势
电商种草 淘宝星河 RPA 内容数据、电商转化数据;需客户淘宝店铺授权

开放数据 无需授权

数据类型 来源 接入方式 说明
笔记 / 评论 / 达人信息 小红书公开页面 RPA 页面公开可见内容;接入过程受平台风控约束
原则
API 与 RPA 互补,不互相替代。同一字段在同一数据实体内仅采用一种方式获取。API 主时效,RPA 主字段完整性与回溯。
02 · 接入主体

数据接入涉及四方主体

私有数据的接入需在四方协议框架下完成。各方职责清晰,不可省略。

平台方

小红书

数据的产出方。提供 API 接口、后台界面、应用注册机制及风控规则。

品牌方

客户

数据的所有方。私有数据接入须由品牌方明确授权,可选择范围、可随时撤回。

广告代理商

卓尔数科 / 上海卓薯 / 苏州数科

协助品牌方完成投放的执行方。默认拥有线下查看与分析品牌方数据的权限。

技术服务商

智投 / 棱镜

提供数据接入与加工能力的独立企业。须在品牌方授权下与代理商协作。

四方协作关系
品牌方
数据所有者
授权
代理商 + 技术服务商
合作共同体 · 共同为品牌方提供数据服务
监督 / 支持
平台方
规则与能力
品牌方授权后,广告代理商与技术服务商作为合作共同体,共同为品牌方提供数据服务。整体协作受到平台方的监督与能力支持
03 · API 接入

私有数据 API 的三条接入路径

按"在小红书开放平台创建应用的主体身份"分为三条路径。下方默认展示三条路径的能力对比,可切换查看每条路径的详细说明。

功能 / 场景 路径一
品牌方
路径二
代理商
路径三
技术服务商
聚光 - 报表 / 查询计划/单元/创意读取投放结构与效果数据
聚光 - 创编计划/单元/创意新建、修改广告投放结构
蒲公英 - 博主报价/授后/订单/评论达人合作全链路
乘风 - 数据报表
私信三方工具客户与用户的私信能力
千帆推广 - 数据报表电商推广投放数据
关键差异
  • 路径三独占:私信三方工具、千帆推广数据,仅技术服务商应用可获取。
  • 创编能力:路径三不含;涉及代客创编需走路径一或路径二。
  • 代理商创编:2024-06-06 起开放,老合作可能基于旧规则,需视情况复核。
路径一

品牌自建应用

品牌方自行在小红书开放平台注册技术身份并完成资质审核,创建自建应用后获取 APPID 与 Secret,将凭证提供给棱镜。棱镜通过该应用为品牌方完成数据接入。数据所有权归品牌方。

应用创建方
品牌方
应用归属
品牌方
账号覆盖
品牌名下所有账号 + 代子账号,自动覆盖
含创编能力
客户配合度
高(需技术对接)
权限范围
最高

覆盖能力

  • 聚光 - 报表
  • 聚光 - 查询
  • 聚光 - 创编
  • 蒲公英 - 全套
  • 乘风 - 数据报表

适用场景

具备技术对接能力的品牌方,特别是希望保有数据所有权、需要使用广告创编能力、对应用权限和数据范围有自主控制需求的客户。

路径二

代理商应用

代理商(如卓尔数科)在小红书开放平台创建代理商应用。品牌方同意代理商授权范围后,由代理商通过该应用获取数据并转交棱镜。代理商通过鉴权密钥管控数据获取范围。

应用创建方
代理商
应用归属
代理商
账号覆盖
代理名下所有代子账号,自动覆盖
含创编能力

(2024-06-06 起开放)
客户配合度
低(无需技术对接)
权限范围

覆盖能力

  • 聚光 - 报表
  • 聚光 - 查询
  • 聚光 - 创编
  • 蒲公英 - 全套
  • 乘风 - 数据报表

适用场景

广告账户已在卓尔代理体系内开户的客户。此路径无需客户介入技术对接,由代理商直接完成接入流程,简单高效。

路径三

技术服务商三方应用

棱镜以技术服务商身份在小红书开放平台上架审核通过的应用。品牌方接收授权链接后扫码确认,并选择需要授权的账户范围。账号需逐一勾选或批量添加,单批上限 1000 个。

应用创建方
技术服务商(棱镜)
应用归属
技术服务商
账号覆盖
需勾选授权
(单批 ≤ 1000)
含创编能力
客户配合度
低(扫码即可)
权限范围
聚焦特定场景

覆盖能力

  • 聚光 - 报表
  • 聚光 - 查询
  • 私信三方工具 · 独占
  • 千帆推广 - 数据报表 · 独占

适用场景

账户分散、未在卓尔代理体系内、且无技术对接资源的客户。或客户业务涉及私信三方、千帆推广等其它路径无法覆盖的场景。

04 · RPA 接入

RPA 通过两种通道执行

通道选择由是否提供专属取数账号决定。两种通道并行存在,互为补充。

品牌方完成项目级授权
品牌方或代理商
是否提供专属取数账号?
提供
服务器端 RPA

使用提供的账号
在棱镜服务器集中执行
速度快,适合数据量大的场景

不提供
浏览器插件 RPA

使用用户本地浏览器登录态
登录态不回传服务端
零账号交付门槛

说明
两种通道并行,不互相替代。提供账号 → 服务器端 RPA;不提供 → 浏览器插件 RPA。浏览器插件 RPA 下,用户登录态保留在本地浏览器,不会传到服务端存储。
05 · 数据安全

六位一体的数据安全保障

从授权、记录、撤回、登录态保护,到协议合规、风控约束,覆盖数据接入全链路的安全机制。

授权颗粒度

所有私有数据接入均需品牌方明确授权。当前颗粒度为项目级。

  • 当前:项目级(一次覆盖所有数据源)
  • 规划:项目 × 数据源(待开发)
  • 授权人需为项目创建者或管理员
操作留痕

每次授权与撤回操作均由系统记录,可追溯、不可篡改。

  • 签署人
  • 签署时间
  • 签署 IP
  • 协议版本号
随时撤回

品牌方可随时主动撤回授权。撤回操作同样被记录。

  • 撤回后停止后续数据采集
  • 历史数据按协议约定保留
  • 撤回操作可追溯
登录态本地化

浏览器插件 RPA 模式下,用户登录态完整保留在本地浏览器,不上传服务端、不集中存储。

  • 登录态不离开用户设备
  • 服务端无客户账号凭证
  • 关闭浏览器即终止当前任务
协议合规

所有数据接入均在「平台方—品牌方—代理商—技术服务商」四方协议框架内完成。

  • 数据所有权归品牌方
  • 数据用途限协议约定范围
  • 遵循平台开放平台规则
风控约束

RPA 接入受平台风控规则约束。棱镜结合技术经验降低风控触发概率。

  • 不对外承诺接入频率上限
  • 不对外承诺接入规模上限
  • 异常情况主动同步客户