首页 › 功能
应用内SKU联动
📝 本页为参考译文（简体中文）。如与日文原版有出入，以日文版为准。
应用内SKU联动可将在 Apple App Store Connect / Google Play Console 中注册的应用内购买（IAP）信息通过官方API导入 Game8 Store，并作为 Game8 Store 的销售商品进行上架与管理。
无需逐个手动输入商品，导入的商品数据可在仪表盘上单独编辑，可针对 Game8 Store 调整价格、加赠数量等后进行销售。
本功能可以实现的内容
- 简便的商品登记: 只需设置一次认证信息，即可批量导入 Apple / Google 的 IAP 信息。
- 灵活的商品运营: 导入的商品可在仪表盘上单独编辑。可按每个商品调整运营方式，如调整价格、选择是否上架等。
- 支持的平台: Apple App Store Connect / Google Play Console
关于提供范围
本功能将分阶段提供。
| 提供时期 | 内容 |
|---|---|
| 发布初期 | 可将 Apple / Google 中已登记的 IAP 信息（商品 ID、价格、名称等）导入仪表盘。导入的商品可在仪表盘上单独编辑，也可切换上架状态（公开中·非公开）。 |
| 未来实现计划 | 计划实现当在 Apple / Google 一侧新增或更新道具时，自动同步到 Game8 Store 的机制。最终目标是以 Apple / Google 为准，Game8 Store 一侧免维护地跟随更新。 |
使用流程
- 事前准备: 在 Apple / Google 的各控制台中获取用于关联的认证信息（参见下一章）。
- 登记连接: 在「应用内 SKU 获取（In-app SKU Import）」界面创建新连接并登记认证信息。
- 执行同步: 使用已登记的连接执行「执行同步」，从 Apple / Google 导入 IAP 信息。
- 商品上架: 在「应用内 SKU 一览（In-app SKU Catalog）」界面编辑导入的道具，并作为 Game8 Store 的商品上架。也可从「应用内 SKU 获取（In-app SKU Import）」界面右上方的【查看目录（View Catalog）】进入。
需事前准备的内容
关联设置需要在各平台发行的认证信息。
Apple App Store Connect 的情况
| 项目 | 内容 | 获取·确认位置 |
|---|---|---|
| API 密钥（.p8 文件） | 在 Apple App Store Connect 中发行的 API 密钥。权限请选择最小权限的「Read Only」。 | Users and Access → Integrations → App Store Connect API → 通过「＋」按钮发行 |
| Key ID | 与 .p8 文件一同显示的 10 位英数字符。 | API 密钥发行界面（同上） |
| Issuer ID | 团队通用的 UUID。 | API 密钥发行界面上部 |
| Bundle ID | 目标应用的 Bundle ID（无需新发行）。 | 对应应用 → App Information |
Google Play Developer 的情况
| 项目 | 内容 | 获取·确认位置 |
|---|---|---|
| Service Account JSON 密钥 | 在 Google Cloud 中创建的服务账号的 JSON 密钥。 | Google Cloud Console → IAM 与管理 → 服务账号 → 从密钥标签页下载 JSON |
| Package Name | 目标应用的 Package Name（无需新发行）。 | Google Play Console → 对应应用 → 仪表盘 |
同时，请完成以下设置。
- 启用 Google Play Developer API: 请确认在对应的 GCP 项目中「Google Play Android Developer API」处于 enabled 状态。
- 在 Play Console 中授予权限: 从 Google Play Console 的「用户和权限」中邀请上述服务账号的邮箱地址，并仅授予「查看应用信息」（无需写入权限）。
应用内 SKU 获取（In-app SKU Import）：关联连接的管理
用于登记与 Apple / Google 的关联连接并获取（同步）IAP 信息的界面。
主要功能与可实现的内容
- 关联连接的管理 ◦ 可新建、编辑、删除与 Apple / Google 的连接。
- 执行同步 ◦ 从已登记的连接导入最新的 IAP 信息。
- 确认同步状态 ◦ 可在一览中确认各连接的同步状态。
界面项目说明（一览）
| 项目 | 说明 |
|---|---|
| 名称（Name） | 用于识别连接的名称。显示登记时设置的名称。 |
| PF 类别（Platform） | 显示连接目标平台（Apple / Google）。 |
| 应用 ID（App ID） | Apple 显示 Bundle ID，Google 显示 Package Name。 |
| 认证信息（Credentials） | 以「已设置」「未设置」显示认证信息的登记状态。 |
| 同步状态（Sync Status） | 显示同步的状态。为「待机中」「同步中」「成功」「错误」之一。 |
| 操作（Actions） | 可进行「执行同步」「编辑」「删除」。 |
新连接的登记
通过一览右上角的「＋ 新建连接」登记关联连接。输入项目如下。
| 项目 | 说明 |
|---|---|
| 连接名称（Connection Name） | 输入用于识别连接的任意名称（例：iOS 正式环境）。 |
| PF 类别（Platform） | 选择关联目标平台（Apple App Store Connect / Google Play Developer）。 |
| Bundle ID / Package Name | 根据所选平台，Apple 输入 Bundle ID，Google 输入 Package Name。 |
| 认证信息（Credentials） | Apple 输入 Key ID / Issuer ID / Private Key（.p8），Google 输入 Service Account JSON。 |
执行同步
按下一览中的「执行同步」，将从 Apple / Google 获取最新的 IAP 信息。获取的道具将同步到「应用内 SKU 一览（In-app SKU Catalog）」界面。
应用内 SKU 一览（In-app SKU Catalog）：导入商品的管理
用于确认从 Apple / Google 导入的道具一览，并作为 Game8 Store 商品进行上架与管理的界面。
主要功能与可实现的内容
- 浏览导入的道具 ◦ 可在一览中确认通过同步获取的道具。
- 筛选功能 ◦ 可按「全部」「已上架」「未上架」进行筛选。
- 上架到 Game8 Store ◦ 可编辑未上架的道具，将其登记为 Game8 Store 的商品。
- 上架状态的管理 ◦ 可进行停止上架、重新公开、以最新值重新获取。
界面项目说明（一览）
| 项目 | 说明 |
|---|---|
| PF 类别（Platform） | 以徽章显示道具的获取来源平台（Apple / Google）。 |
| 商品名称（Name） | 从 Apple / Google 获取的道具名称。已上架时会成为指向 Game8 Store 商品编辑界面的链接。 |
| PF 商品 ID（Platform Item ID） | 在 Apple / Google 一侧管理的商品 ID（产品 ID）。 |
| 价格（Price） | 从 Apple / Google 获取的价格。 |
| 上架状态（Status） | 显示在 Game8 Store 的上架状态。为「未上架」「公开中」「非公开」之一。 |
| 最后获取（Last Fetched） | 最后一次获取该道具的日期时间。 |
| 操作（Actions） | 可根据上架状态执行「编辑（Edit）」「掲載をやめる（Unpublish）」「公開する（Publish）」「最新で更新（Reimport）」。 |
关于上架状态
| 状态 | 说明 |
|---|---|
| 未上架（Not Published） | 已导入，但尚未登记为 Game8 Store 商品的状态。 |
| 公开中（Live） | 已登记为 Game8 Store 商品并正在销售（可显示·可购买）的状态。 |
| 不公开（Hidden） | 已登记为 Game8 Store 商品，但已停止销售的状态。 |
关于各项操作
| 操作（Actions） | 说明 |
|---|---|
| 编辑（Edit） | 编辑未上架的道具，将其登记（上架）为 Game8 Store 的商品。将打开「Game8 Store に掲載（Publish to Game8 Store）」界面。 |
| 停止上架（Unpublish） | 停止公开中商品的销售，将其设为「非公开」。商品数据不会被删除。 |
| 公开（Publish） | 将非公开的商品重新设为「公开中」。 |
| 更新至最新（Reimport） | 导入 Apple / Google 的最新商品名称·销售价格，并同步到上架中的商品。缩略图等已编辑的项目将被保留。 |
上架到 Game8 Store（Publish to Game8 Store・上架编辑界面）
按下「编辑（Edit）」后，将打开「Publish to Game8 Store」界面。界面上部的「Apple / Google から取得した情報（Source info from Apple / Google）」中会显示 PF 商品 ID（Platform Item ID） / PF 商品名称（PF Name） / PF 价格（PF Price） ，请参考其内容输入 Game8 Store 的商品信息。
输入项目与道具管理的新建（New Item）相同（基本信息 / 价格设置 / 购买上限・库存 / 购买限制间隔 / 公开・排期 / 分类 / 标签 / 赠品道具 / 捆绑道具）。其中显示名称、商品ID、销售价格会以获取到的值作为初始值。
输入完成后，按下界面下方的「Publish to Game8 Store」即可上架。
| 项目 | 说明 |
|---|---|
| 显示名称（Display Name） | 在 Game8 Store 上显示的商品名称（必填）。初始值为获取的商品名称。 |
| 商品ID（Item ID） | 用于 API 联动的 ID。初始值为 PF 商品 ID。 |
| 缩略图（Thumbnail） | 商品的缩略图图片（必填）。 |
| 销售价格（Sales Price） | 在 Game8 Store 上的销售价格（日元）（必填）。JPY 的道具会将获取价格作为初始值填入。 |
| 分类（Category） | 选择用于分类商品的分类。带有「共通（Global）」徽章的分类为全部游戏通用。也可以新建分类。 |
注意事项
- 支持的币种: 价格的自动导入·自动更新仅支持日元（JPY）。其他币种仅同步商品名称。
- 同步所需时间: 同步可能会根据道具件数花费数十秒至数分钟。即使处理过程中连接中断，后端也可能仍在继续处理。请稍等片刻后重新加载一览进行确认。
- 关于权限: 仅具有浏览权限的账号无法进行连接的登记·编辑·删除、执行同步、上架等操作（可浏览一览）。
- 关于认证信息: 关联所需的权限仅为浏览专用（只读）。请勿授予写入权限。