Troubleshoot Assurance

🚨 Documentation has moved! 🚨

Documentation for Adobe Experience Platform Mobile SDKs now has a new home!
⚠️ This site will no longer be maintained ⚠️
Visit for the latest documentation.

Project Griffon will be Assurance!

We're pleased to announce that Project Griffon will be generally available to all Adobe Experience Cloud customers as Assurance. To learn more about this transition see here.
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 Enable Debug Logging in the Getting Started section.
You may change SDK log levels using the setLogLevel 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.
For Android, thestartSession API does not need to be explicitly called. For iOS, use the API as described in Adobe Experience Platform Assurance.

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 Adobe Experience Platform Assurance SDK library.
  • Verify the session matches the link and is input correctly for the expected session. See Log message "OrgID information is not available" (this is uncommon and relevant only if you have access to more than one ORG instance).

Adobe Analytics Debugging

  1. 1.
    Post Processing Status - No Debug Flag
In your Analytics Events view, if events fail with the Post-Processed Status "No Debug Flag", your current Adobe Analytics or Assurance SDK version might not support the Analytics Debugging feature. Please upgrade the Adobe Analytics and Assurance SDK extensions to the latest versions to resolve this problem.
Minimum Version Requirement
Adobe Analytics
> 2.4.0
> 1.2.6
> 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/[email protected]^2.0.0 npm install @adobe/react-native-acpcore
react-native-aepassurance v3.x.x
npm install @adobe/[email protected]^3.0.0 npm install @adobe/react-native-aepcore
If you are using react-native-acpcore with AEPAssurance, the React Native application can fail to build with one of the following error messages:
RCTAEPAssurance: Fatal error: Module 'AEPAssurance' not found
AppDelegate: AEPAssurance.h file not found
If that occurs, please downgrade your react-native-aepassurance using the following npm command:
npm install @adobe/[email protected]^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.