۶Ƶ

DocumentationExperience PlatformAssurance Guide

Troubleshoot ۶Ƶ Experience Platform Assurance

Last update: Tue Apr 11 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

If you are having trouble getting Assurance to work, please see suggestions under the following issue topics to resolve commonly encountered issues.

To enable smoother implementation and to discover any potential issues, ensure you have SDK logging turned on per in the Getting Started section.

You may change SDK log levels using the API.

On-device, app issues

QR code does not open app

  • Access the link directly. Copy the link from Session Details. Paste it in the browser address bar of the device to open it. If it does not open, please see the section App will not open link.
  • Use a different QR reader. For iOS 11 or greater, use the Photo app to read the QR code.

  • Verify the deep link implementation is configured correctly in the app.

    • Android: Deep Links (App Links)

    • iOS: Custom URL Scheme or Universal Links

INFO
For Android, the startSession API does not need to be explicitly called. For iOS, use the API as described in .

Authentication overlay appears, but app fails to connect

  • Ensure internet connectivity of the device through the device web browser.
  • If the app has never successfully connected to the Assurance service, ensure it is set up for Assurance correctly. See instructions on installing the ۶Ƶ Experience Platform Assurance SDK library.
  • Verify the session matches the link and is input correctly for the expected session. See (this is uncommon and relevant only if you have access to more than one ORG instance).

۶Ƶ Analytics Debugging

Post Processing Status - No Debug Flag

In your Analytics Events view, if events fail with the Post-Processed Status “No Debug Flag”, your current ۶Ƶ Analytics or Assurance SDK version might not support the Analytics Debugging feature.
Please upgrade the ۶Ƶ Analytics and Assurance SDK extensions to the latest versions to resolve this problem.

Minimum Version Requirement
iOS
Android
۶Ƶ Analytics
> 2.4.0
> 1.2.6
Assurance
> 1.0.0
> 1.0.0

React Native MobileCore and AEPAssurance compatibility

AEP Assurance Version
Mobile Core Version
Install Instruction
react-native-aepassurance v2.x.x
npm install @adobe/react-native-aepassurance@^2.0.0
npm install @adobe/react-native-acpcore
react-native-aepassurance v3.x.x
npm install @adobe/react-native-aepassurance@^3.0.0
npm install @adobe/react-native-aepcore

If you are using react-native-acpcore with Assurance, the React Native application can fail to build with one of the following error messages:

RCTAEPAssurance:  Fatal error: Module 'AEPAssurance' not found

or

AppDelegate: AEPAssurance.h file not found

Solution

If that occurs, please downgrade your react-native-aepassurance using the following npm command:

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

This error occurs because the react-native-acpcore extension is only compatible with react-native-aepassurance versions 2.x.x and below.

recommendation-more-help
fdfd76d4-8dd9-4291-8a4d-77823c2c75f5