2026年のApp Store外部購入リンク
App Reviewガイドライン3.1.1は、App Storeアプリ内で販売するデジタル商品・サービスにアプリ内課金の使用を引き続き義務付けています。しかし例外のリストはさらに拡大し、2026年には準拠アプリが自社の決済ページへ顧客を誘導できる方法が3通りあります。ガイドライン3.1.1(a)の現行文にはこう明記されています。デベロッパーは、自社が所有または管理責任を負うウェブサイトへのリンクをアプリ内に設置するためのエンタイトルメントを申請できます。そして、米国のパブリッシャーにとって最も重要な一文は次のとおりです。「これらのエンタイトルメントは、米国のストアフロントアプリにボタン、外部リンク、その他のコールトゥアクションを含めるために必須ではありません」。その他のすべてのストアフロントでは、同じガイドラインにより、アプリおよびそのメタデータに、アプリ内課金以外の購入手段へ顧客を誘導するボタン、外部リンク、その他のコールトゥアクションを含めてはならないとされています。
ひと言でまとめると: 米国のストアフロントではエンタイトルメントは一切不要です。com.apple.developer.storekit.external-purchase-linkエンタイトルメントは、Appleがリンクアウトを認めているiOS/iPadOSのストアフロントをカバーします。また新しいカスタム購入リンクのエンタイトルメントは地域限定で、EUの国コードにブラジルと日本が加わりました。ExternalPurchaseLinkを使えば実行時に該当するかどうかが分かり、eligibleURLsとopen(url:)で実際にリンクを開けます。返ってくるすべてのトークンはExternal Purchase Server API経由で報告する必要があります。
ステップ1 — アプリが3つのルートのどれに該当するかを見極める
ルート1は米国ストアフロントです。エンタイトルメントなしでリンクアウトが許可されており、ガイドラインにも明記されています。ルート2はcom.apple.developer.storekit.external-purchase-link、すなわちStoreKit External Purchase Linkエンタイトルメントです。Appleの要約によれば「対象アプリが、アプリ利用者を外部購入のためにウェブサイトへ誘導するリンクを含めることを可能にする」もので、エンタイトルメント契約では、そのリンクの用途をアプリ内アイテムの購入場所と購入方法の案内に限定しており、比較的低価格で購入できる場合がある旨の記載も含まれます。ルート3はcom.apple.developer.storekit.custom-purchase-link.allowed-regionsです。「対象アプリが特定の地域においてアプリ内またはウェブサイトで外部購入を提供することを可能にする」エンタイトルメントで、値はブール値ではなく2文字のISO-3166-1コードの配列です。ドキュメントによると、カスタム購入リンクが許可される地域にはブラジル(br)、日本(jp)、およびEU各国コード(オーストリア、ベルギー、ブルガリア、クロアチア、キプロス、チェコ、デンマーク、エストニア、フィンランド、フランス、ドイツ、ギリシャ、ハンガリー、アイルランド、イタリア、ラトビア、リトアニア、ルクセンブルク、マルタ、オランダ、ポーランド、ポルトガル、ルーマニア、スロバキア、スロベニア、スペイン、スウェーデン)が含まれます。
コードを書く前に、実際に出荷しているストアフロントを洗い出してください。ストアフロントの境界を無視した単一のグローバルリンクは、この機能がリジェクトにつながる最も一般的な原因です。
ステップ2 — 署名プロファイルにエンタイトルメントを付与する
エンタイトルメントはアプリのストア掲載情報ごとではなく、デベロッパーアカウントごとに付与され、Appleはその制限を明記しています。エンタイトルメントは「特定のストアフロントにおいて、iOSまたはiPadOSのApp Storeでのみ使用に限定されます」。アカウントがStoreKit External Purchase Linkエンタイトルメントを受け取ったら、プロジェクトの.entitlementsファイルをXcodeで開き、キーcom.apple.developer.storekit.external-purchase-linkを追加して値をtrueに設定することで、アプリに追加します。地域限定のバリアントでは、キーはcom.apple.developer.storekit.custom-purchase-link.allowed-regionsで、値はその機能を提供する予定の小文字の国コードの配列です。Appleの表現では、「Appleがカスタム購入リンクのオプションをサポートする地域のみを含める必要があります」。
エンタイトルメントはプロビジョニングプロファイルに紐づくため、実務上の手順は次のとおりです。申請し、機能が反映されるのを待ち、プロファイルを再生成し、再署名してからアップロードします。古いプロファイルで署名されたビルドはリンクを開くことができず、その失敗はビルド時ではなく実行時に現れます。
ステップ3 — Info.plistで遷移先URLを設定する
作業を担うのは2つのプロパティリストキーで、どちらを選ぶかで呼び出すAPIが決まります。SKExternalPurchaseLinkは、キーが小文字のISO 3166-1 alpha-2国コードで、国コードごとに遷移先URLを1つ持つ辞書です。Appleに有効なコードが列挙されています。EU加盟27か国にアイスランド(is)、ノルウェー(no)、ロシア(ru)を加えたものです。SKExternalPurchaseMultiLinkはマルチリンク版で、辞書の形は同じですが、各国コードに1〜5個の遷移先URLの配列が対応します。
すべてのデスティネーションURLは4つの条件を満たす必要があり、4つ目が見落とされがちです。HTTPSスキームを使うこと、有効な絶対URLであること、クエリパラメータを含まないこと、1,000文字以下のASCII文字であること。さらにAppleは「プロパティリストのキーで指定するデスティネーションURLは、常に、App Reviewに提出するアプリバイナリ内の値と一致していなければなりません」と述べています。つまりURLは実質的に審査提出物の一部であり、変更は設定の編集ではなくリリースなのです。
MultiLinkは誰でも使えるわけではありません。Appleの説明どおりStoreKit External Purchase Linkのエンタイトルメントの対象となるアプリなら国コードごとに1つ以上のリンクを設定できますが、それ以外は国コードごとにちょうど1つのリンクのみ設定できます。
ステップ4 — 描画前にcanOpenでUIを制御する
canOpenは、「このアプリが現在のApp Storeストアフロントで設定された外部購入リンクを正常に開けるか」に答えるブール値です。Appleは、すべて満たす必要がある3つの条件を明記しています。現在のストアフロントが外部購入を許可し、その人物が外部購入を行う資格があること、アプリがcom.apple.developer.storekit.custom-purchase-link.allowed-regionsまたはcom.apple.developer.storekit.external-purchase-linkのエンタイトルメントを設定していること、アプリが現在のストアフロント用のリンクを設定していることです。それ以外はすべてfalseです。App Storeストアフロントが変わらない限り再確認は不要なので、起動時に一度評価し、その結果でペイウォールUIを制御できます。falseの場合は、canMakePaymentsを確認してアプリ内課金にとどまるのが、ドキュメントに記載されたフォールバックです。
ステップ5 — リンクを開く:open()またはopen(url:)
リンクを1つだけ設定した場合は、ExternalPurchaseLink.open()を呼び出す。マルチリンクキーの場合は、eligibleURLs(現在のストアフロント向けにアプリが設定したリンクの配列)を読み取り、ボタンのタップなどユーザーの意図的な操作に応じて、選んだリンクでopen(url:)を呼び出す。Appleは、eligibleURLsが次の3つの状況でnilを返すことを明言している。ストアフロントが外部購入を許可していない、または対象者でない場合、エンタイトルメントが欠けている場合、現在のストアフロント向けにリンクが設定されていない場合。nilかつSKExternalPurchaseLinkが設定されている場合はcanOpenにフォールバックし、nilで設定もない場合はcanMakePaymentsにフォールバックする。
open(url:)は非同期で、アプリが外部購入リンクを表示するかどうかをユーザーが選べる継続シートを表示します。このメソッドはシートが表示される前に戻り、エンタイトルメントがない、ストアフロントにリンクが設定されていない、ストアフロントが外部購入に対応していない、ユーザーが対象外である、ネットワークまたはシステムエラーが発生した、といった場合にStoreKitErrorをスローすることがあります。ユーザーが続行を選ぶと、StoreKitはデフォルトブラウザでURLを開き、外部購入トークンとアプリのバンドルIDを付加します。このトークンこそが、報告ステップが存在する理由そのものです。
ステップ6 — External Purchase Server APIを通じてすべてのトークンを報告する
External Purchase Server APIは、自社サーバーから呼び出すREST APIで、「外部購入トークンと、そのトークンに関連するお客様の取引を報告する」ためのものです。この指示は任意ではなく、成功した販売に限定されません。取引に至らなかったトークンも含め、すべてのトークンを報告してください。具体的には、Appleは報告が必要な4つのケースを挙げています。お客様が1件以上の取引を完了したときの明細付きトークン、お客様が1件も完了しなかったときの明細なしトークン、記録のないトークンについてApp Storeサーバー間通知が届いたときの未認識トークン、そして重複したACQUISITIONおよびSERVICESトークンです。認証には、App Store Connectで作成したAPIキーから生成するJSON Web Tokenを使用します。
すでにApp Store Server Notifications V2を運用しているなら、レポートパイプラインは自然な接続先です。通知でトークンの存在を把握し、ストアで取引を記録し、External Purchase Server APIレポートでループを閉じます。
ステップ7 — ストアフロントの境界を常に意識する
ここまでの内容はすべて、ガイドラインとエンタイトルメントに繰り返し登場する一文によって制限されています。エンタイトルメントは特定のストアフロントにおけるiOSまたはiPadOSのApp Storeに限定され、米国のストアフロント以外では、アプリおよびそのメタデータに、アプリ内課金以外の購入手段へ顧客を誘導するボタン、外部リンク、その他のコールトゥアクションを含めることはできません。この境界はメタデータにも適用されます。リンクが許可されていないストアフロントで外部決済画面を示すスクリーンショットは、マーケティング上の選択ではなくリジェクトのリスクです。
もう一度読み返す価値のある落とし穴
- クエリパラメータは禁止されています。遷移先URLにトラッキングパラメータを付けると、規定のURLルールに違反します。アトリビューションを担うのは、StoreKitが付与するトークンです。
- この権利は署名機能であり、サーバー設定ではありません。付与されたケイパビリティなしでキーを
.entitlementsに追加すると、それを使用できないプロビジョニングプロファイルが生成されます。 - URLは常にバイナリと一致していなければなりません。 リリースなしで新しい遷移先URLを起草することは、Appleが要件として(希望ではなく)明記している不一致です。
- 1か国につき1リンクです。MultiLinkの対象でない限り。1リンクしか許可されないストアフロントで5つのURL配列を使うのは審査上の問題になります。
- 米国のみのアプリには何も必要ありません。掲載情報が米国のみであれば、ガイドライン3.1.1(a)がすでにリンクアウトを認めています。不要なプロフィール機能を作らないでください。
始め方
ストアフロントの一覧を書き出し、それぞれをUS、権利付与リージョン、カスタム購入リンク対象リージョン、対象外のいずれかに分類したうえで、ゲートは一度だけ実装します。canOpen(複数リンクの場合はeligibleURLs)を確認し、trueが返ったときだけコントロールを表示し、それ以外のすべてのユーザーにはアプリ内課金を既定の経路として残します。サーバー側のトークン処理こそが、ローンチ後も機能がコンプライアンスを保てるかを左右する部分です。
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る