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

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

データの不一致

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

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

ネットワークエラー

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

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

インテグレーションサーバーがイベントの処理に失敗した

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

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

インテグレーションデータが不足している

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

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

インテグレーションの認証情報が不足している

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

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

イベントの有効期限が切れた

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

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

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

無効/未対応のイベントタイプ

原因: このインテグレーションでイベントがサポートされていないか、インテグレーションのセットアップ時に無効にされています。たとえば、access_level_updated イベントはほとんどのインテグレーションでサポートされていません。

解決策: インテグレーションのドキュメントで、そのインテグレーションがこのイベントタイプをサポートしているか確認してください。サポートされている場合は、Adapty ダッシュボードでそのイベントタイプがインテグレーション設定で有効になっていることを確認してください。