官方动态
Daiying CMS Affiliate Hub 联盟 Provider 配置总教程
介绍 Daiying CMS Affiliate Hub 联盟 Provider 的配置思路、字段检查、连接验证和上线前注意事项。
这篇教程面向 Daiying CMS 站长，说明 Affiliate Hub 的统一 Provider 配置思路、当前 11 个联盟平台的凭据字段、商品导入链路、前台展示规则和安全合规边界。
适用于 Daiying CMS Core 1.2.51+ 与 official.affiliate-hub 0.1.0-alpha.12 及后续兼容版本。
一、这套功能是什么
Affiliate Hub 是 Daiying CMS 的统一联盟商品插件。当前采用“一个 Affiliate Hub 插件 + 多个 Provider 模块”的方式，而不是把 CJ、Walmart、Amazon、Awin 等平台分别做成多个 CMS 插件。
Provider 负责连接各联盟平台，并把平台商品转换成统一 Affiliate DTO。之后 Affiliate Hub 通过 AffiliateCommerceBridge 同步到 Commerce Product Layer，由前台主题展示商品，并通过 /go/affiliate/{offer_id} 执行点击统计和安全跳转。
统一链路：Adapter / Provider → Affiliate Hub → AffiliateCommerceBridge → Commerce Product → /go/affiliate/{offer_id}。
二、安装前提
- Daiying CMS Core 版本建议为 1.2.51 或更高。
- 安装并启用 official.affiliate-hub。
- Provider 没有 API 凭据时也可以安装和启用，后台会显示“未配置”。
- 联盟商品不进入 Daiying CMS 本地购物车、Stripe、本地订单、库存或物流。
- 购买按钮通过 /go/affiliate/{offer_id} 跳转到联盟商家，由商家完成付款、发货和售后。
三、后台入口与基本操作
进入 Daiying CMS 后台 → Affiliate Hub → Provider 管理。Provider 页面会显示启用状态、配置状态、连接状态、缺少字段，以及“配置 / 搜索 / 启用（或禁用）”操作。
- 打开对应 Provider 的“配置”页面并填写凭据。
- 保存配置。
- 启用 Provider。
- 执行连接测试。
- 连接成功后点击“搜索”获取真实商品。
- 确认商品进入 Commerce Product Layer 后检查前台详情页和购买跳转。
四、当前 11 个 Provider 配置字段
| Provider | 后台 ID | 主要凭据 | 当前状态/说明 |
| CJ Affiliate | affiliate.cj | Personal Access Token、Company ID、Website ID / PID | 已有真实连接基础 |
| Walmart Affiliate | affiliate.walmart | API Key，或 Consumer ID + Private Key；可选 Publisher ID | 待真实凭据验证 |
| Amazon Associates | affiliate.amazon | PA-API Access Key、Secret Key、Partner Tag、Marketplace | 待真实凭据验证 |
| Awin | affiliate.awin | Publisher ID、Access Token；可选 Advertiser ID | 待真实凭据验证 |
| Impact | affiliate.impact | Account SID、Auth Token；可选 Campaign ID | 待真实凭据验证 |
| Rakuten Advertising | affiliate.rakuten | Access Token；可选 Advertiser ID | 待真实凭据验证 |
| eBay Partner Network | affiliate.ebay | Client ID + Client Secret，或 Application Access Token；可选 Campaign ID | 待真实凭据验证 |
| Taobao / Alimama | affiliate.taobao | App Key、App Secret、Adzone ID；可选 TOP Session | 待真实凭据验证 |
| JD Union | affiliate.jd | App Key、App Secret；可选 Access Token / Site ID / Position ID | 待真实凭据验证 |
| Pinduoduo / Duoduo Jinbao | affiliate.pdd | Client ID、Client Secret；可选 PID | 待真实凭据验证 |
| Vipshop | affiliate.vipshop | App Key、App Secret；可选 PID / Channel Tag | 待真实凭据验证 |
五、各 Provider 配置说明
CJ Affiliate
准备 Personal Access Token、Company ID 和 Website ID / PID。在 affiliate.cj 配置页填写并保存，然后执行连接测试。成功后 Provider 应显示已配置和连接成功。
进入搜索页面时优先搜索已加入（joined）的广告主商品。未加入、待审批、过期或没有 Tracking URL 的商品，不应作为有效购买商品发布。
Walmart Affiliate
准备 Walmart Affiliate API Key；如果账户采用 Walmart I/O 签名认证，则准备 Consumer ID、Key Version、Private Key；Publisher ID 可用于跟踪。保存后执行连接测试，再验证商品搜索接口和真实 Tracking URL。
Amazon Associates
准备 PA-API Access Key、Secret Key、Partner Tag，并选择 Marketplace。连接后使用 PA-API SearchItems 搜索商品。联盟购买地址应使用 PA-API 返回的 DetailPageURL，不应自行拼普通 Amazon 商品 URL。
Awin / Impact / Rakuten / eBay
这些平台通常需要 Publisher/Account ID、Access Token、Auth Token、Client ID/Secret 或 Advertiser/Campaign ID。连接后要重点确认平台返回的是正式 tracking/deep link，而不是普通商品页链接。
淘宝联盟、京东联盟、多多进宝、唯品会
国内联盟平台通常需要 App Key、App Secret、推广位 ID、PID、渠道标识或平台 Session。真实 API 权限、字段名称、推广链接生成接口和账户审核状态，需要用实际联盟账号进行 Live Test。
六、商品发布与安全规则
- Provider 商品必须包含稳定 provider_id 和 external_product_id。
- 公开商品信息统一映射标题、图片、品牌、商家、分类、价格、币种、destination URL 和 affiliate URL。
- 可用时映射 color、size、material、brand、merchant、audience 等 Facet。
- 只有 joined 状态且具备有效 HTTPS 商品地址与 Affiliate Tracking URL 的商品才可激活购买。
- pending、unjoined、expired、declined、inactive 或缺少 Tracking URL 的商品只能保持草稿或不可购买状态。
- 重复导入必须更新同一个 Affiliate Product / Commerce Action，不得制造重复商品。
- 主题只能看到 /go/affiliate/{offer_id}，不得直接暴露真实 Tracking URL 或 API Secret。
七、建议的真实接通顺序
- CJ Affiliate
- Taobao / Alimama
- Walmart Affiliate
- Amazon Associates
- JD Union
- Pinduoduo / Duoduo Jinbao
- Awin
- Impact
- Rakuten Advertising
- eBay Partner Network
- Vipshop
八、常见状态说明
| 状态 | 含义 |
| 未配置 | Provider 已安装，但缺少必要 API 或联盟凭据。 |
| 尚未测试 | 配置尚未执行连接测试。 |
| 连接失败 | 通常为凭据错误、权限不足、API endpoint/签名不匹配，或联盟账号尚未获得相应权限。 |
| 已配置 / ok | 凭据已保存且最近一次连接测试成功。 |
| 搜索不到商品 | 可能是广告主未加入、API 权限/区域限制、关键词无结果，或商品没有可用联盟 Tracking URL。 |
九、后续独立图文教程
本总教程用于解释 Affiliate Hub 的统一配置方式。正式运营时，建议继续制作 11 篇独立教程，并在真实申请过程中补充注册页面截图、审核步骤、API Key 获取位置和 Daiying CMS 后台填写截图。
- 《Daiying CMS 如何申请并配置 CJ Affiliate》
- 《Daiying CMS 如何申请并配置 Walmart Affiliate》
- 《Daiying CMS 如何申请并配置 Amazon Associates》
- 《Daiying CMS 如何申请并配置 Awin》
- 《Daiying CMS 如何申请并配置 Impact》
- 《Daiying CMS 如何申请并配置 Rakuten Advertising》
- 《Daiying CMS 如何申请并配置 eBay Partner Network》
- 《Daiying CMS 如何申请并配置 Taobao / Alimama》
- 《Daiying CMS 如何申请并配置 JD Union》
- 《Daiying CMS 如何申请并配置 Pinduoduo / Duoduo Jinbao》
- 《Daiying CMS 如何申请并配置 Vipshop》
给站长的提醒
联盟商品的核心不是把商品越堆越多，而是选择一个清晰垂直领域，稳定接入少量可靠 Provider，发布有价值的选品、比较、教程和导购内容。Daiying CMS Affiliate Hub 负责把 Provider、商品、跳转和前台展示链路统一起来，站长仍然需要做好内容质量、合规披露和流量运营。
免责声明：本文是 Daiying CMS Affiliate Hub 使用教程，不构成法律、税务或收益保证。各联盟平台和广告主政策可能变化，请以实际后台、平台文档和最新条款为准。
评论
0 条还没有评论。