アプリ内SKU連携
アプリ内SKU連携は、Apple App Store Connect / Google Play Consoleに登録されている課金アイテム(IAP)情報を、公式API経由でGame8 Storeに取り込み、Game8 Storeの販売商品として掲載・管理できる機能です。
アイテムを1件ずつ手入力する必要はなく、取り込んだ商品データはダッシュボード上で個別に編集して、価格や増量数などを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取得」画面で新規接続を作成し、認証情報を登録します。
- 同期の実行: 登録した接続で「同期実行」を行い、Apple / GoogleからIAP情報を取り込みます。
- 商品の掲載: 「アプリ内SKU一覧」画面で、取り込んだアイテムを編集してGame8 Storeの商品として掲載します。「アプリ内SKU取得」画面右上の【カタログを見る】からも遷移できます。
事前にご準備いただくもの
連携の設定には、各プラットフォームで発行した認証情報が必要です。
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取得(連携接続の管理)
Apple / Googleとの連携接続を登録し、IAP情報を取得(同期)する画面です。
主な機能とできること
- 連携接続の管理 ◦ Apple / Googleとの接続を新規作成・編集・削除できます。
- 同期の実行 ◦ 登録した接続から最新のIAP情報を取り込みます。
- 同期状態の確認 ◦ 各接続の同期ステータスを一覧で確認できます。
画面の項目説明(一覧)
| 項目 | 説明 |
|---|---|
| 名前 | 接続を識別するための名称です。登録時に設定した名前が表示されます。 |
| PF種別 | 接続先のプラットフォーム(Apple / Google)が表示されます。 |
| アプリID | AppleはBundle ID、GoogleはPackage Nameが表示されます。 |
| 認証情報 | 認証情報の登録状態を「設定済み」「未設定」で表示します。 |
| 同期ステータス | 同期の状態を表示します。「待機中」「同期中」「成功」「エラー」のいずれかです。 |
| 操作 | 「同期実行」「編集」「削除」を行えます。 |
新規接続の登録
一覧右上の「+ 新規接続」から、連携接続を登録します。入力項目は以下のとおりです。
| 項目 | 説明 |
|---|---|
| 接続名 | 接続を識別するための任意の名称を入力します(例:iOS本番環境)。 |
| PF種別 | 連携先のプラットフォーム(Apple App Store Connect / Google Play Developer)を選択します。 |
| Bundle ID / Package Name | 選択したプラットフォームに応じて、AppleはBundle ID、GoogleはPackage Nameを入力します。 |
| 認証情報 | AppleはKey ID / Issuer ID / Private Key(.p8)、GoogleはService Account JSONを入力します。 |
同期の実行
一覧の「同期実行」を押すと、Apple / Googleから最新のIAP情報を取得します。取得したアイテムは「アプリ内SKU一覧」画面に反映されます。
アプリ内SKU一覧(取り込み商品の管理)
Apple / Googleから取り込んだアイテムの一覧を確認し、Game8 Storeの商品として掲載・管理する画面です。
主な機能とできること
- 取り込みアイテムの閲覧 ◦ 同期で取得したアイテムを一覧で確認できます。
- フィルター機能 ◦ 「すべて」「掲載済み」「未掲載」で絞り込めます。
- Game8 Storeへの掲載 ◦ 未掲載のアイテムを編集し、Game8 Storeの商品として登録できます。
- 掲載状態の管理 ◦ 掲載の停止・再公開・最新値での再取得を行えます。
画面の項目説明(一覧)
| 項目 | 説明 |
|---|---|
| PF種別 | アイテムの取得元プラットフォーム(Apple / Google)がバッジで表示されます。 |
| 商品名 | Apple / Googleから取得したアイテム名です。掲載済みの場合はGame8 Storeの商品編集画面へのリンクになります。 |
| PF商品ID | Apple / Google側で管理されている商品ID(プロダクトID)です。 |
| 価格 | Apple / Googleから取得した価格です。 |
| 掲載状態 | Game8 Storeでの掲載状態を表示します。「未掲載」「公開中」「非公開」のいずれかです。 |
| 最終取得 | そのアイテムを最後に取得した日時です。 |
| 操作 | 掲載状態に応じて「編集」「掲載をやめる」「公開する」「最新で更新」を行えます。 |
掲載状態について
| 状態 | 説明 |
|---|---|
| 未掲載 | 取り込み済みですが、まだGame8 Storeの商品として登録されていない状態です。 |
| 公開中 | Game8 Storeの商品として登録され、販売中(表示・購入可能)の状態です。 |
| 非公開 | Game8 Storeの商品として登録済みですが、販売を停止している状態です。 |
各操作について
| 操作 | 説明 |
|---|---|
| 編集 | 未掲載のアイテムを編集し、Game8 Storeの商品として登録(掲載)します。「Game8 Store に掲載」画面が開きます。 |
| 掲載をやめる | 公開中の商品の販売を停止し、「非公開」にします。商品データは削除されません。 |
| 公開する | 非公開の商品を再び「公開中」にします。 |
| 最新で更新 | Apple / Googleの最新の商品名・販売価格を取り込み、掲載中の商品に反映します。サムネイルなど編集済みの項目は保持されます。 |
Game8 Store に掲載(掲載編集画面)
「編集」を押すと「Game8 Store に掲載」画面が開きます。画面上部の「Apple / Google から取得した情報」に PF商品ID / PF商品名 / PF価格 が表示され、その内容を参考にGame8 Storeの商品情報を入力します。
入力項目はアイテム管理の新規作成と同じ構成です(基本情報・価格設定・購入上限・在庫・購入制限インターバル・公開・スケジュール・カテゴリ・タグ・ボーナスアイテム・バンドルアイテム)。このうち表示名・商品ID・販売価格には、取得した値が初期値として入ります。
入力後、画面下部の「Game8 Store に掲載」を押すと掲載されます。
| 項目 | 説明 |
|---|---|
| 表示名 | Game8 Store上で表示する商品名です(必須)。初期値には取得した商品名が入ります。 |
| 商品ID | API連携で使用するIDです。初期値にはPF商品IDが入ります。 |
| サムネイル | 商品のサムネイル画像です(必須)。 |
| 販売価格 | Game8 Store上での販売価格(円)です(必須)。JPYのアイテムは取得価格が初期値に入ります。 |
| カテゴリ | 商品を分類するカテゴリを選択します。「共通」バッジが付くカテゴリは全ゲーム共通のものです。新規カテゴリの作成も可能です。 |
ご注意事項
- 対応通貨: 価格の自動取り込み・自動更新は日本円(JPY)のみ対応しています。それ以外の通貨は商品名のみが反映されます。
- 同期の所要時間: 同期はアイテム件数に応じて数十秒〜数分かかる場合があります。処理中に接続が切断されても、バックエンドでは処理が継続していることがあります。しばらく待ってから一覧を再読み込みしてご確認ください。
- 権限について: 閲覧のみの権限のアカウントでは、接続の登録・編集・削除、同期の実行、掲載などの操作は行えません(一覧の閲覧は可能です)。
- 認証情報について: 連携に必要な権限は閲覧専用(読み取り専用)のみです。書き込み権限は付与しないでください。