微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 优选联盟

    # 开发前准备

    # 推广体系说明

    优选联盟是微信小店的商品推广分销平台，商家通过接口管理带货者合作关系和商品推广计划。整体分为带货者管理和商品推广两大模块。

    推广类型对比：

    对比项 普通推广 定向推广 专属推广
    适用场景 面向全平台带货者的公开推广 面向指定带货者的定向合作 为特定带货者定制的独家推广
    带货者范围 所有带货者均可推广 需指定带货者列表 需指定带货者列表
    佣金设置 统一佣金比例 按计划设置佣金 按计划设置佣金
    互斥规则 与专属推广互斥 依赖普通推广先上架 与普通/定向推广互斥
    type 枚举值 1 2 3

    多个接口同时支持 finder_id 和 promoter_id 两个参数，finder_id 已标注待废弃，开发者应优先使用 promoter_id（带货者 ID）

    # 接入流程

    # 一、带货者管理流程

    商家通过接口查询带货者信息，并对合作关系进行管理：

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["[API] 获取带货者列表<br/>getpromoterlist"] --> B["[API] 获取带货者详情信息<br/>getpromoter"] B --> C{需要操作?} C -- 管理合作关系 --> D["[API] 编辑带货者<br/>updpromoter"] C -- 查看商品数据 --> E["[API] 获取带货者商品数据列表<br/>getproductdatalist"] D --> A style C fill:#ffffff,stroke:#0ab8a6,color:#666666

    带货者管理要点：

    # 二、商品推广管理流程

    商家将商品添加到优选联盟进行推广，支持批量操作：

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR P["获取 product_id<br/>（商品管理接口）"] --> A Q["[API] 获取带货者列表<br/>getpromoterlist<br/>（获取 promoter_ids）"] --> A A["[API] 批量新增联盟商品<br/>batchadditem"] --> B["[API] 获取联盟商品推广列表<br/>getitemlist"] B --> C["[API] 获取联盟商品详情<br/>getitem"] C --> D{调整推广?} D -- 修改佣金/上下架 --> E["[API] 更新联盟商品信息<br/>upditem"] D -- 删除推广 --> F["[API] 删除联盟商品<br/>deleteitem"] E --> B F --> B style D fill:#ffffff,stroke:#0ab8a6,color:#666666 style P fill:#ffffff,stroke:#0ab8a6,color:#666666

    商品推广管理要点：

    • 调用 [API] 批量新增联盟商品 / batchadditem 前需准备两类参数：
      • product_id：通过商品管理接口获取商品 ID
      • promoter_ids（定向/专属推广时必填）：通过 [API] 获取带货者列表 / getpromoterlist 获取带货者的 talent_appid → promoter_id
    • [API] 批量新增联盟商品 / batchadditem 每次最多添加 20 个商品，佣金比例范围为 0~90%
    • 推广类型通过 type 字段区分：1-普通推广、2-定向推广、3-专属推广
    • 定向推广和专属推广需指定带货者列表（promoter_ids），每次不超过 30 个带货者
    • 普通/定向推广与专属推广互斥（错误码 10023105），定向推广要求普通推广先上架（错误码 10023106）
    • [API] 更新联盟商品信息 / upditem 的 operate_type 支持：1-编辑并上架、2-下架、4-上架
    • 商品需为已上架状态才可添加推广（错误码 10023104），被运营处罚或类目禁售的商品无法上架推广

    # 三、联盟机构推广流程（按需接入）

    联盟带货机构（headsupplier）可通过商家授权，为商家批量设置机构推广计划：

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A[商家授权机构] --> B["[API] 批量新增联盟机构推广<br/>batchaddheadsupplieritem"] B --> C[机构推广生效] style A fill:#ffffff,stroke:#0ab8a6,color:#666666 style C fill:#ffffff,stroke:#0ab8a6,color:#666666
    • [API] 批量新增联盟机构推广 / batchaddheadsupplieritem 需传入 headsupplier_appid（机构开放唯一凭证）
    • 机构计划类型通过 commission_type 区分：0-商家指定带货者佣金、1-机构指定带货者佣金（总包计划）
    • 需同时设置推广佣金（ratio）和推广服务费（service_ratio），范围均为 0~90%

    # 四、商品推广状态流转

    %%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#0ab8a6', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#089e8d', 'lineColor': '#0ab8a6', 'secondaryColor': '#07827a', 'secondaryTextColor': '#ffffff', 'secondaryBorderColor': '#055f59', 'tertiaryColor': '#0ab8a6', 'tertiaryTextColor': '#ffffff', 'tertiaryBorderColor': '#089e8d', 'edgeLabelBackground': '#888888', 'fontColor': '#888888'}}}%% flowchart LR A["待生效(10)"] --> B["已上架推广(1)"] B --> C["已下架推广(2)"] C --> B B --> D["已删除(4)"] C --> D E["未达到准入标准(5)"] --> B

    状态码说明：10-待生效、1-已上架推广、2-已下架推广、4-已删除、5-未达到准入标准

    # 接口全览

    # 带货者操作

    中文名 / 英文名 请求方式 功能说明
    获取带货者详情信息 / getpromoter POST /channels/ec/league/promoter/get 获取带货者基础信息、销售数据和等级
    获取带货者列表 / getpromoterlist POST /channels/ec/league/promoter/list/get 分页获取商家合作的带货者列表
    获取带货者商品数据列表 / getproductdatalist POST /channels/ec/league/promoter/product/datalist/get 查询带货者推广商品的销售和佣金数据
    编辑带货者 / updpromoter POST /channels/ec/league/promoter/upd 取消邀请或结束合作

    # 商品操作

    中文名 / 英文名 请求方式 功能说明
    批量新增联盟商品 / batchadditem POST /channels/ec/league/item/batchadd 批量添加商品到联盟推广，最多 20 个
    删除联盟商品 / deleteitem POST /channels/ec/league/item/delete 删除联盟推广商品
    获取联盟商品详情 / getitem POST /channels/ec/league/item/get 获取推广状态、佣金、绑定带货者列表
    批量新增联盟机构推广 / batchaddheadsupplieritem POST /channels/ec/league/item/headsupplier/batchadd 机构为商家批量设置推广计划
    获取联盟商品推广列表 / getitemlist POST /channels/ec/league/item/list/get 分页获取联盟推广商品列表
    更新联盟商品信息 / upditem POST /channels/ec/league/item/upd 修改佣金、上下架推广商品

    官方完整接口列表：优选联盟 接口列表

    # 常见问题 FAQ

    Q：普通推广和定向推广可以同时存在吗？ A：可以。普通推广面向全平台带货者，定向推广是在普通推广基础上为指定带货者设置差异化佣金。但定向推广要求普通推广已上架（否则返回错误码 10023106）。普通/定向推广与专属推广互斥。

    Q：finder_id 和 promoter_id 应该用哪个？ A：优先使用 promoter_id（带货者 ID）。finder_id（视频号 finder_id）已标注待废弃，后续将不再支持。两个参数二选一传入即可。

    Q：批量操作的数量限制是多少？ A：[API] 批量新增联盟商品 / batchadditem 每次最多 20 个商品；定向/专属推广绑定带货者每次不超过 30 个；[API] 获取联盟商品推广列表 / getitemlist 单页最多 100 条，page_size × page_index 不超过 5000，超出时建议使用 last_buffer 顺序翻页。

    Q：联盟带货机构接入优选联盟有独立文档吗？ A：有。带货机构（headsupplier）有独立的文档站，与本文商家端接口为不同体系。机构端接入请参阅：联盟带货机构开发指南

    文档变更日志（1条）
    2026 年 05 月 06 日
    新增 优选联盟 开发指南