渠道商品配置

本指南说明如何配置渠道特定的商品绑定，允许不同渠道拥有不同的商品可用性和定价。

概述

渠道商品配置允许您：

• 将特定商品绑定到分发渠道
• 配置渠道特定的定价
• 按渠道控制商品可用性
• 管理区域商品变体

为什么需要渠道商品配置？

不同渠道可能需要不同的商品：

前置条件

• 已有 商品档位
• 已配置 渠道
• 了解您的分发策略

访问渠道商品配置

1. 登录 OpenDev 平台
2. 点击侧边栏的 渠道商品配置
3. 查看和管理所有配置

创建配置

1. 点击 创建配置 按钮
2. 填写配置详情：

配置字段

1. 点击 创建

绑定商品

创建配置后：

1. 点击配置进入详情
2. 点击 绑定商品
3. 选择要包含的商品档位
4. 点击 绑定所选

绑定示例

渠道：google_play_global
├── pro_monthly
├── pro_yearly
├── coins_100
└── coins_500

渠道：app_store_global
├── pro_monthly
├── pro_yearly
├── coins_100
└── coins_500

渠道：wechat_china
├── pro_monthly_cny
├── pro_yearly_cny
└── coins_100_cny

管理绑定

查看已绑定商品

1. 打开渠道商品配置
2. 查看已绑定商品档位列表
3. 每个商品显示：

• 商品名称
• 商品类型
• 平台 ID

解绑商品

1. 在列表中找到商品
2. 点击 解绑 按钮
3. 确认操作

注意： 解绑不会删除商品档位，只是从该渠道移除关联。

商品排序

商品可按特定顺序显示：

1. 拖拽商品进行排序
2. 顺序影响客户端应用中的显示
3. 完成后保存更改

配置策略

按平台

google_play_config
├── 所有 Android 商品

app_store_config
├── 所有 iOS 商品

web_stripe_config
├── 所有 Web 商品

按区域

global_config
├── USD 定价商品

china_config
├── CNY 定价商品

japan_config
├── JPY 定价商品

按级别

free_channel
├── 仅基础功能

premium_channel
├── 所有高级商品
├── 独家功能

最佳实践

配置命名

推荐：
- google_play_global
- app_store_us
- web_stripe_premium
- china_wechat_pay

避免：
- config1
- test
- my_config

商品组织

1. 一致的商品集 — 尽可能跨平台使用相同的商品
2. 明确差异 — 记录商品按渠道不同的原因
3. 版本控制 — 跟踪配置变更
4. 测试 — 验证商品按渠道正确加载

渠道特定注意事项

与应用集成

获取渠道商品

应用根据渠道获取商品：

const channelKey = getChannelKey();

const response = await fetch('/api/products', {
  headers: {
    'X-Channel-Key': channelKey,
  },
});

const products = await response.json();
// 仅返回绑定到该渠道的商品

配置包

商品包含在配置包中：

{
  "channel": "google_play_global",
  "products": [
    {
      "productId": "pro_monthly",
      "name": "Pro Monthly",
      "platformId": "pro_monthly_subscription",
      "price": "$9.99"
    }
  ]
}

高级配置

条件商品

某些商品可能仅在特定条件下可用：

{
  "productId": "enterprise_yearly",
  "conditions": {
    "minAppVersion": "2.0.0",
    "countries": ["US", "CA", "UK"],
    "userTier": ["pro", "enterprise"]
  }
}

A/B 测试

测试不同的商品集：

channel_a_test:
├── pro_monthly
├── pro_yearly（33% 折扣）

channel_b_test:
├── pro_monthly
├── pro_yearly（标准价格）

促销渠道

为促销活动创建渠道：

black_friday_2024:
├── pro_monthly（8 折）
├── pro_yearly（6 折）
├── lifetime_access（限量）

故障排查

商品未加载

可能原因：

• 请求中的渠道 Key 错误
• 商品未绑定到渠道
• 配置未激活

解决方案：

1. 验证渠道 Key 完全匹配
2. 检查商品绑定
3. 通过下载配置包测试

显示错误的商品

可能原因：

• 缓存的配置
• 环境错误（dev/prod）
• 多个匹配的配置

解决方案：

1. 清除客户端缓存
2. 验证环境设置
3. 检查配置优先级

工作流示例

设置新渠道

1. 创建渠道 — 在渠道管理中
2. 创建商品档位 — 包含所有平台 ID
3. 创建渠道配置 — 为该渠道
4. 绑定商品 — 到配置
5. 生成配置包 — 验证
6. 在应用中测试 — 使用渠道 Key

添加新商品

1. 创建商品档位 — 填写所有详情
2. 绑定到渠道 — 在需要的渠道中
3. 更新配置包 — 为受影响的应用
4. 部署更新的配置 — 到客户端

相关文档

• 商品档位
• 发行主体与渠道
• 应用配置