Adobe Experience Platform Assuranceのトラブルシューティング

Assuranceの動作に問題がある場合は、次の問題トピックの推奨事項を参照して、一般的に発生する問題を解決してください。

実装をよりスムーズに行い、潜在的な問題を検出するには、「はじめに」セクションの「​ デバッグログを有効にする」ごとにSDK ログがオンになっていることを確認します。

SDK ログレベルは、setLogLevel APIを使用して変更できます。

オンデバイス、アプリの問題

QR コードでアプリが開かない

  • 直接リンクにアクセスします。 セッションの詳細​からリンクをコピーします。 デバイスのブラウザーのアドレスバーに貼り付けて開きます。 開かない場合は、「​ アプリはリンク ​を開きません」のセクションを参照してください。
  • 別のQR リーダーを使用する。 IOS 11以降の場合は、Photo アプリを使用してQR コードを読み取ります。

アプリがリンクを開きません

INFO
Androidの場合、startSession APIを明示的に呼び出す必要はありません。 IOSの場合は、Adobe Experience Platform Assuranceに記載されているAPIを使用します。

認証オーバーレイが表示されますが、アプリは接続できません

  • デバイスのweb ブラウザーを介したデバイスのインターネット接続を確認します。
  • アプリがAssurance サービスに正常に接続されていない場合は、Assuranceに正しく設定されていることを確認してください。 Adobe Experience Platform Assurance SDK ライブラリのインストール手順を参照してください。
  • セッションがリンクと一致し、想定されるセッションに対して正しく入力されていることを確認します。 ​ ログメッセージ「OrgID情報は利用できません」 ​を参照してください(これは一般的ではなく、複数のORG インスタンスにアクセスできる場合にのみ関連します)。

Adobe Analyticsのデバッグ

後処理ステータス – デバッグフラグなし

Analytics イベントビューで、後処理ステータス「デバッグフラグなし」でイベントが失敗した場合、現在のAdobe AnalyticsまたはAssurance SDKのバージョンでAnalytics デバッグ機能がサポートされていない可能性があります。
この問題を解決するには、Adobe AnalyticsとAssurance SDKの拡張機能を最新バージョンにアップグレードしてください。

最小バージョン要件
iOS
Android
Adobe Analytics
> 2.4.0
> 1.2.6
Assurance
> 1.0.0
> 1.0.0

React Native MobileCoreとAEPAssuranceの互換性

AEP Assurance版
モバイルコアバージョン
インストールの指示
react-native-aepassurance v2.x.x
react-native-acpcore
npm install @adobe/react-native-aepassurance@^2.0.0
npm install @adobe/react-native-acpcore
react-native-aepassurance v3.x.x
react-native-aepcore
npm install @adobe/react-native-aepassurance@^3.0.0
npm install @adobe/react-native-aepcore

Assuranceでreact-native-acpcoreを使用している場合、React Native アプリケーションは次のいずれかのエラーメッセージでビルドに失敗する可能性があります。

RCTAEPAssurance:  Fatal error: Module 'AEPAssurance' not found

または

AppDelegate: AEPAssurance.h file not found

ソリューション

そのような場合は、次のnpm コマンドを使用してreact-native-aepassuranceをダウングレードしてください。

npm install @adobe/react-native-aepassurance@^2.0.0

このエラーは、react-native-acpcore拡張機能が​ のみ ​とreact-native-aepassurance バージョン 2.x.x以前との互換性があるために発生します。

recommendation-more-help
experience-platform-help-assurance