この記事では、App Store インテグレーションに関する一般的な問題を説明します。各セクションでは、症状・根本原因・解決方法を紹介します。

プロダクトが表示されない

以下の 2 つの症状は、同じ根本原因を示しています。

• App Store Connect の API キーは正しく設定されているのに、Adapty がプロダクトをまったく取得できない。
• App Store Connect にプロダクトが存在するのに Adapty に表示されない、または期待より少ない数しか表示されない。購入を試みると SDK が「Product Id not found」と報告する。

最も一般的な根本原因は Apple の契約が未署名 であることです — 有料契約・税務フォーム・銀行口座情報が保留中または未署名の状態になっています。契約が保留中の場合、App Store Connect API はプロダクト関連のエンドポイントに対してサイレントに 403 を返します。Adapty には明確なエラーが表示されず、プロダクトはサイレントに除外されます。

App Store Connect → Agreements, Tax, and Banking にアクセスして、保留中の契約にすべて署名してください。その後、Adapty の App settings → iOS SDK で再同期を行ってください。

App Store Server Notifications が「Delayed」と表示される

App Store Connect で、App Store Server Notifications のステータスが Delayed と表示されることがあります。これは、Apple がサブスクリプションイベントの通知（更新・キャンセル・請求エラーなど）の送信を遅延させており、キューに入れられた通知が遅れて届くことを意味します。

インストール統計には影響しません。Adapty はインストールをサーバー側の通知からではなく、アプリの初回起動時にカウントします。

更新やキャンセルのデータが遅れている場合、Delayed ステータスが最も可能性の高い原因です。Apple がバックログを処理するにつれて、通常は自動的に解消されます。

Adapty の価格が App Store と一致しない

Adapty のプロダクト編集ページの price フィールドは、プロダクトの追加方法によって動作が異なります。

Adapty でプロダクトを作成してダッシュボードからストアにプッシュする場合、この価格が初期ストア価格として使用されます。

すでにストアに存在するプロダクトを追加する場合、この価格はプレースホルダーです。Adapty のアナリティクス・インテグレーション・SDK は、App Store から取得した実際の価格を使用します。App Store の価格変更はプレースホルダーに同期されません。また、現時点ではダッシュボードからプレースホルダーを編集することもできません。

CSV の価格エクスポートが空になる

CSV の価格エクスポートに列ヘッダーしか含まれていない場合、App Store Connect の API キーが完全に設定されていません。ステップ 6 — App Store Connect API キーを追加する を参照してください。

新しいプロダクトを App Store にプッシュできない

Adapty はダッシュボードでプロダクトを作成したときに、App Store Connect にプッシュできます。App Store インテグレーションが完全に設定されていない場合、プッシュオプションはブロックされます。以下の 2 つの設定が必要です。

• Apple app ID: ステップ 1 — Bundle ID と Apple app ID を入力する で設定してください。
• App Store Connect API key: ステップ 6 — App Store Connect API キーを追加する で設定してください。