記事

App Store サーバー通知の有効化

アプリ内購入イベントと報告されていない外部購入トークンに関する通知を受信するには、あなたのサーバーを構成して HTTPS URL を指定します。

概観

App Store サーバー通知は、アプリ内購入イベントに関するリアルタイム通知と、報告されていない外部購入トークンに関する通知を送信するサーバー間サービスです。通知を有効にするには、サーバーに HTTPS URL を設定し、App Store Connect で設定を構成してください。

通知の解析と解釈について詳しくは、App Store サーバー通知の受信をご覧ください。

あなたのサーバーと App Store Connect を設定

App Store からサーバー通知を受信するには、あなたのサーバーが Transport Layer Security (TLS) 1.2 プロトコル以降をサポートしていなければなりません。

App Store サーバー通知を有効にするには、以下の手順に従って下さい。

製品環境で通知を受信するためのあなたのサーバー上の HTTPS URL を特定します。

オプションとして、通知をテストするために、サンドボックス環境で通知を受信するためのサーバー上の HTTPS URL を特定します。製品環境とサンドボックス環境の両方で同じ URL を使用できます。

App Store Connect では、環境ごとにバージョン 2 またはバージョン 1 の通知を受信するオプションがあります。バージョン 2 を選択するには、エンドポイントを App Store Server Notifications V2 として設定してください。

App Store Connect であなたの URL を構成してください。詳しくは、App Store サーバ通知の URL の入力をご覧ください。

重要

あなたの URL でポートを指定する場合、ポートは 443 または 1024 以上でなければなりません。たとえば、URL https://example.com:1234/notifications はポート 1234 を指定します。

App Store サーバー通知の POST が成功したかどうかを示す HTTP ステータスコードで応答するようにあなたのサーバーを構成してください。詳細については、App Store サーバー通知への応答を参照してください。

新規実装の場合は、App Store Server Notifications V2 を使用してください。バージョン 1 の通知からバージョン 2 に移行するには、製品環境をバージョン 2 に更新する前に、サンドボックス環境でバージョン 2 の通知をテストしてください。

App Store サーバー通知の変更については、App Store サーバー通知の変更履歴を参照してください。

許可リストの構成

あなたのサーバーの IP アドレスを許可リストに登録する必要がある場合は、IP アドレスのサブネット 17.0.0.0/8 を追加して、あなたのサーバーが App Store サーバーからの通知を受信できるようにしてください。このサブネットは、サンドボックス環境と製品環境の両方に適用されます。

あなたのサーバーの設定をテストする

あなたのサーバーが通知を受信しているかどうかを確認するには、App Store Server API 内のテスト通知の要求エンドポイントを呼び出します。このエンドポイントは、App Store Server に notificationType TEST の通知を送信するよう要求します。受信した testNotificationToken を使用してテスト通知状況の取得エンドポイントを呼び出し、あなたのサーバーがテスト通知にどのように応答するかを確認します。

App Store Server は、バージョン 2 の通知形式で TEST 通知を送信します。ただし、App Store Connect でバージョン 1 とバージョン 2 通知のどちらの通知 URL を構成したかに関係なく、あなたのサーバーに送信されます。