インテグレーションのエラーを処理する

アトリビューション、メッセージング、またはアナリティクスのインテグレーションを使用する際に、いくつかの一般的なエラーが発生することがあります。トラブルシューティングのケースについては、このガイドを参照してください。

データの不一致

原因: Adapty SDK が含まれているアプリバージョンを使用していないユーザーが存在するために発生する可能性があります。

解決策: データの一貫性を確保するために、ユーザーに Adapty SDK が含まれているバージョンへのアップデートを促すことができます。

原因: Adapty サーバーとインテグレーションサーバー間のインターネット接続が途切れた可能性が高いです。

解決策: このような問題は通常長く続かず、影響を受けるイベントの数もごく少数です。

原因: インテグレーションが正しく設定されていません。

解決策: ドキュメントのインテグレーションに関する記事を参照してください。Adapty ダッシュボード、サードパーティツール側、およびアプリコードの両方で、すべてのセットアップ手順を完了していることを確認してください。

原因: プロファイルにインテグレーション固有の ID が含まれていません。これはアプリコードでインテグレーションが正しく設定されていない場合に発生することがあります。

解決策: ドキュメントのインテグレーションに関する記事を参照してください。アプリコードにコードスニペットのメソッドを実装し、それらのメソッドが実際にユーザープロファイルと連携していることを確認してください。

原因: インテグレーションの一部の認証情報が不足しているか、正しくありません。

解決策: Adapty ダッシュボードでそのインテグレーションの認証情報をすべて確認してください。バージョンまたは環境の不一致が原因で問題が発生することがあります。

原因: インテグレーション設定で Exclude historical events オプションが有効になっており、イベントの作成日がシステム内のプロファイル作成日より前になっています。

これは、数年前に開始されたトランザクションのチェーンが、最近作成されたプロファイルのレシート検証を通じて Adapty に届いた場合に発生することがあります。

解決策: 新しいイベントでこれが発生しないようにしてください。過去のイベントをインテグレーションに送信したい場合は、Exclude historical events を無効にしてください。

理由: このインテグレーションではイベントがサポートされていないか、インテグレーション設定時に無効にしています。

解決策:

そのインテグレーションがこのイベントタイプをサポートしているか確認してください。以下のイベントはすべてのインテグレーションに届くわけではありません。
- access_level_updated: Webhook のみ。
- 合成イベント（trial_active、subscription_active）：Adjust、Amplitude、AppMetrica、AppsFlyer、Branch、Facebook Analytics、Firebase、Mixpanel、OneSignal、PostHog、Singular、SplitMetrics、および Webhook。
インテグレーションがサポートされている場合、インテグレーション設定でそのイベントが有効になっていることを確認してください。

原因: 合成イベントはタイマーで一度だけ発火しますが、エラーなしにイベントが停止される状況が4つあります：

トライアルまたはサブスクリプションが遅延期間の終了前に終了した場合。変換済み、期限切れ、または返金済みの購入では何も生成されず、Adapty は再確認しません。代わりに trial_converted、trial_expired、subscription_expired、または subscription_refunded を確認してください。
遅延期間の終了前にユーザーが自動更新をオフにした場合。ユーザーのアクセスは有料期間の終了まで継続しますが、Adapty は送信をスキップします。代わりに trial_renewal_cancelled または subscription_renewal_cancelled を確認してください。
購入が開始された後にイベントを有効にした場合。Adapty は trial_started または subscription_started が届いたときにタイマーを開始するため、イベントを有効にした後に行われた購入のみが生成されます。
購入が開始された後に遅延を変更した場合。既にスケジュールされた送信は、作成時の遅延をそのまま使用します。

解決策: これらはいずれも配信失敗ではないため、再試行は不要であり、イベントフィードには何も表示されません。設定が正しく機能しているかどうかは、イベントをオンにしてからその後に発生した購入を確認することで検証できます。