iOSとAndroidでサブスク権限を同期する設計ガイド
iPhoneで登録したサブスクリプションが、Androidタブレットでは反映されず再登録を求められる。ユーザーにとっては理不尽ですが、開発者から見れば両ストアは独立した課金システムであり、相互運用の仕組みを持っていません。本稿では、Google Play BillingとStoreKitがどこで噛み合わないのかを整理し、自前で同期基盤を作る場合の4ステップ、そしてapp user IDとCustomerInfoでその複雑さを吸収するアプローチを解説します。
1人のユーザー、2つの独立した課金エコシステム
フィットネスアプリの「Premium」を例に考えます。あるユーザーがiPhoneのApp Storeで登録し、1週間後にAndroidタブレットへ同じアカウントでログインしたとします。このときAndroidアプリは、そのユーザーが有効なサブスクリプションを持っていることを知りません。Google Play Billingが把握できるのはGoogle Play経由の購入だけで、Appleのサーバー上にあるApp StoreのレシートはAndroidアプリからは見えないからです。結果として、すでに支払い済みのユーザーに再登録を促すペイウォールが表示されます。
これはバグではなく、各課金システムが独立して設計されていることによる想定内の挙動です。両者を橋渡しするには、どちらのプラットフォームも提供していない同期基盤を自前で用意する必要があります。
Google Play BillingとStoreKitが噛み合わない4つの論点
両者の違いはAPIの細かな差異ではなく、購入情報の表現や信頼の置き方に関する設計思想の違いに由来します。以下の4点を押さえると、同期基盤で何を吸収しなければならないかが見えてきます。
レシート形式と検証:購入トークンか、署名付きトランザクションか
購入の証明方法からして両者は別系統です。Google Playでは、アプリが受け取る購入トークンが唯一の手がかりになります。この文字列はそれ自体に情報を持たず、Google Play Developer APIへ渡して初めて現在の状態が返ってくる、いわば照会用の鍵です。対するAppleは、StoreKit 2で購入情報をJSON Web Signature(JWS)として渡します。これはAppleの公開鍵で検証できる自己完結型の証明書であり、サーバーは自前で正当性を確かめられます。
片方は問い合わせて状態を教えてもらう方式、もう片方は受け取った証明を自分で検証する方式であり、同じ処理を別APIで書き換えれば済む話ではありません。
リアルタイム通知:配信経路もイベント名も異なる
更新や解約をサーバー側で追うための通知も、届き方が揃いません。Googleの通知はCloud Pub/Subを経由するため、トピックと購読、そして受け取ったメッセージを処理するサービスを用意する必要があります。Appleは登録したURLへHTTPS POSTを直接送りつけます。イベントの呼び名、ペイロードの形、各通知に載る項目も別々です。
結果としてバックエンドには、認証の仕方も、パースの仕方も、状態遷移の読み替えも異なる2つの通知処理を並べて持つことになります。さらにグレース期間の考え方、返金の流れ、そして「解約」が指す意味にもプラットフォームごとの差が残ります。
プロダクト設定:1対1で対応しない構造
Google Playは2022年にベースプランとオファーを導入し、階層型のプロダクトモデルへ移行しました。1つのサブスクリプションに複数のベースプランを含め、それぞれに異なる価格フェーズのオファーを設定できます。月額・年額、導入オファー、プロモーション価格を1つのプロダクトIDにまとめられる構造です。
Appleのモデルはよりフラットで、App Store Connectの各プロダクトIDは単一期間の1サブスクリプションを表します。月額と年額を用意するなら2つのプロダクトIDを作成し、サブスクリプショングループにまとめます。導入オファーやプロモーションオファーはプロダクト単位で設定され、ネスト構造にはなりません。この構造差のため、Google PlayとAppleのプロダクトに1対1の対応は存在せず、バックエンド側でプラットフォーム固有IDを統一されたエンタイトルメント概念へ変換するマッピング層が要ります。
自前で同期基盤を組む場合の4ステップ
サードパーティを使わずにクロスプラットフォーム同期を実装する場合、アーキテクチャは次の4段階に整理できます。最終的にマネージドなソリューションを選ぶ場合でも、この作業量を把握しておくと、なぜこの問題が本質的に難しいのかが理解できます。
ステップ1:プラットフォームをまたぐ統一ユーザーID
まず必要なのは、iOSとAndroidの両方から購入情報を紐づけられるサーバー側のユーザーアカウントです。各プラットフォームは独自の「ユーザー」概念を持ちますが、互いを認識しません。両クライアントは同じuserIdを付けて購入データをバックエンドへ送り、バックエンドは各購入を適切なプラットフォームAPIで検証したうえで、得られたエンタイトルメントを統一アカウントに記録します。
ステップ2:2系統のレシート検証
バックエンドはApple用とGoogle用の異なる検証APIに統合する必要があります。Google側はサービスアカウントの認証情報、Apple側はApp Store Connectの秘密鍵で署名したJWTが必要です。エラーハンドリングやレスポンス解析も別々に実装することになり、両レスポンス形式に共通構造はありません。
ステップ3:プラットフォーム非依存のエンタイトルメント保存
プラットフォーム固有のプロダクトを、プラットフォーム非依存のエンタイトルメントへマッピングするデータモデルを用意します。いずれかのクライアントが問い合わせた際、バックエンドはそのエンタイトルメントがどのプラットフォーム由来であっても、ユーザーに有効な権利があるかを確認して返します。
ステップ4:2系統の通知処理
エンタイトルメントをリアルタイムに保つには、両プラットフォームの通知を同時に処理する必要があります。イベント名・ペイロード構造・状態遷移の意味づけが異なるため、ハンドラーも別々に実装します。
内製に必要な工数の目安と、見落としやすいコスト
専用インフラに加えて、GoogleとAppleは課金システムを継続的に更新します。Googleは2022年のベースプランとオファー導入でバックエンドの大幅な変更を求め、AppleはStoreKit 2で新しいトランザクションモデルを持ち込みました。こうした変更のたびに適応のためのエンジニアリング時間が必要です。
専任のバックエンドエンジニアを抱える大規模チームなら対応可能かもしれませんが、小規模チームやインディー開発者にとっては、本業の開発から離れて数か月を費やす負担になり得ます。
app user IDとCustomerInfoで複雑さを吸収する
ここで紹介するのは、統一されたアイデンティティとエンタイトルメントの仕組みをマネージドサービスとして利用する場合のパターンです。提供事業者や契約条件はSubscription Platform側の設定に依存するため、導入時には{{OWNER_DOCS_URL}}で最新の仕様を確認してください。本節の内容は特定製品の保証ではなく、実装パターンの説明として読んでください。
このパターンの要はapp user IDという抽象化です。SDK設定時に独自のユーザーIDを指定することも、匿名IDを生成させることもできます。両プラットフォームで同じappUserIDを使えば、バックエンド上に単一のサブスクライバーレコードが作られ、どちらのプラットフォームで登録しても、もう片方のSDKがcustomer infoを問い合わせた際に完全なエンタイトルメント状態が返ります。
匿名ユーザーから認証ユーザーへの移行
ユーザーが最初は匿名で使い、後からアカウントを作るケースにも対応できます。初回起動時に生成される匿名IDにサブスクリプションが紐づいた状態で、ユーザーがログインすると、logInメソッドによって匿名ユーザーの購入が認証済みユーザーへ移行されます。createdブール値はそのユーザーが新規か既存かを示し、既存ユーザーの場合は購入履歴がマージされます。iOSで登録した後にAndroidアプリをインストールしたユーザーでも、同じユーザーIDでログインすればエンタイトルメントが引き継がれます。
CustomerInfoが返すもの、アプリが見るべきもの
CustomerInfoは、あらゆるプラットフォームのサブスクリプション状態を集約した単一のオブジェクトです。各エンタイトルメントのstoreプロパティはそのサブスクリプションの由来プラットフォームを示しますが、アクセスを付与する際に確認する必要はありません。見るべきはisActiveだけで、これは全プラットフォームで共通に機能します。
AndroidアプリがAppleのレシート検証方法を知る必要も、iOSアプリがGoogle Playのpurchase tokenを理解する必要もありません。プラットフォーム差異はバックエンド側で吸収され、アプリには統一された状態が届きます。
iOSで登録しAndroidで開いたときに起きること
iOS SDKがApp Storeのレシートをバックエンドへ送り、Appleのサーバーで検証されたうえでapp user IDにエンタイトルメントが記録されます。更新・解約・請求エラーを追うためにApple Server Notificationsへ登録します。その後Androidアプリが起動してgetCustomerInfoを呼ぶと、同じapp user IDが送られ、iOS由来のサブスクリプションを含む完全な状態が返ります。AndroidアプリはisActive == trueを確認してアクセスを付与するだけです。更新、グレース期間、解約、期限切れはサーバー側で処理され、両プラットフォームはプラットフォーム固有コードなしで最新状態を取得できます。
管理URLの振り分け:解約先を間違えさせない
クロスプラットフォームで実務上重要なのが管理URLの振り分けです。iOSで登録したユーザーはGoogle PlayではなくApp Storeで管理する必要があります。managementURLプロパティは、登録したストアに応じた正しい設定画面を指します。これがないと、ユーザーがGoogle Playで解約しようとして見つからず混乱する、という状況が起こります。
内製かマネージドか:判断チェックリスト
どちらの道を選ぶかを決める前に、次の項目を確認してください。
- バックエンドに2系統のレシート検証を実装・保守できる専任エンジニアがいるか
- Cloud Pub/SubとHTTPS POSTの両方の通知経路を運用できるか
- プラットフォーム固有プロダクトIDをエンタイトルメントへ変換するマッピング層を維持できるか
- ストアAPIの仕様変更を追い続ける時間を確保できるか
- 匿名ユーザーから認証ユーザーへの購入引き継ぎを自前で設計できるか
- 管理URLを登録ストアに応じて出し分けられるか
これらを自前で賄う余力がなければ、マネージドな仕組みに寄せる判断が現実的です。逆に、これらすべてを内製で回せる体制があるなら、自前構築も選択肢になります。
まとめ:同期の難しさは「橋渡し」の範囲にある
クロスプラットフォームのサブスクリプション状態管理が難しいのは、レシート形式、検証API、通知メカニズム、プロダクト構造という4層すべてでGoogle Play BillingとStoreKitが異なるからです。橋渡しには統一アイデンティティ、二重のレシート検証、プラットフォーム非依存のエンタイトルメント保存、2系統の通知処理が必要になります。
この範囲を把握しておけば、内製かマネージドかの判断も、見積もりの妥当性も判断しやすくなります。節約できた時間は、アプリの改善やペイウォールの最適化、プロダクトを差別化する機能の開発に振り向けられます。
| 項目 | Google Play Billing | Apple StoreKit |
|---|---|---|
| 購入証明 | 購入トークン(不透明な文字列) | 署名付きレシート(StoreKit 2のJWS) |
| 検証エンドポイント | purchases.subscriptionsv2.get REST API | App Store Server API ( /inApps/v1/subscriptions ) |
| 認証 | JSONキーを用いたGoogleサービスアカウント | App Store Connectの秘密鍵で署名したJWT |
| レスポンス形式 | SubscriptionPurchaseV2 JSONオブジェクト | JWSTransactionDecodedPayload (署名付きJSON) |
| サブスクリプションID形式 | productId:basePlanId | シンプルな productId 文字列 |
| 更新(リニューアル)管理 | サブスクリプションリソースの expiryTime フィールド | トランザクション情報内の expiresDate |
本表はGoogle Play BillingとStoreKitの仕様差を整理した参考情報です。API仕様やフィールド名は変更される可能性があるため、実装時は各プラットフォームの公式ドキュメントで最新情報を確認してください。
| 項目 | Google Play RTDN | Apple Server Notifications V2 |
|---|---|---|
| 配信方式 | Google Cloud Pub/Sub | あなたのエンドポイントへのHTTPS POST |
| 通知フォーマット | type enumを含む DeveloperNotification | notificationType を含む signedPayload (JWS) |
| イベント種別 | SUBSCRIPTION_RENEWED 、 SUBSCRIPTION_CANCELED など | DID_RENEW 、 DID_CHANGE_RENEWAL_STATUS など |
| ユーザー識別子 | 通知内の purchaseToken | 署名ペイロード内の originalTransactionId |
| セットアップ | Play ConsoleでPub/Subトピックを設定 | App Store ConnectでURLを登録 |
本表は両プラットフォームの通知仕様を比較した参考情報です。イベント名やペイロード構造は変更される可能性があるため、実装時は各プラットフォームの公式ドキュメントで最新情報を確認してください。
Frequently asked questions
iOSで登録したサブスクリプションがAndroidで反映されないのはなぜですか?
Google Play BillingはGoogle Play経由の購入しか把握できず、Appleのサーバー上にあるApp StoreのレシートはAndroidアプリから見えないためです。各課金システムは独立して動作しており、両者を橋渡しする同期基盤を別途用意する必要があります。
購入トークンとJWSは何が違うのですか?
購入トークンは意味を持たない不透明な文字列で、Google Play Developer APIに送ることで現在のサブスクリプション状態を取得します。JWSは暗号学的に署名された自己完結型の記録で、Appleの公開鍵を用いてサーバー側で検証できます。信頼の置き方が根本的に異なります。
匿名ユーザーが登録したサブスクリプションは、後からアカウントを作成しても引き継げますか?
はい。初回起動時に生成される匿名IDに購入が紐づき、ユーザーがログインするとlogInメソッドによって認証済みユーザーへ購入が移行されます。既存ユーザーの場合は購入履歴がマージされ、iOSで登録後にAndroidアプリをインストールしたユーザーでも同じユーザーIDでログインすればエンタイトルメントが引き継がれます。
iOSで登録したユーザーがAndroidで解約しようとするとどうなりますか?
実際の契約はApple側にあるため、Google Playの設定には表示されません。managementURLプロパティを使えば、登録したストアに応じた正しい管理画面へ誘導できます。
自前で同期基盤を構築する場合、どのくらいの期間が必要ですか?
2系統のレシート検証、2系統の通知処理、ユーザーアイデンティティ、エンタイトルメントデータベース、クライアント側コードの構築・維持が必要になります。初期開発だけで10〜18週間を要し、さらに両プラットフォームの進化に合わせた継続的なメンテナンスも必要です。