Troubleshoot Adobe Experience Platform Assurance
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.
App does not open link
-
Verify the deep link implementation is configured correctly in the app.
-
Android: Deep Links (App Links)
-
iOS: Custom URL Scheme or Universal Links
-
startSession 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
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.
React Native MobileCore and AEPAssurance compatibility
npm install @adobe/react-native-aepassurance@^2.0.0npm install @adobe/react-native-acpcorenpm install @adobe/react-native-aepassurance@^3.0.0npm install @adobe/react-native-aepcoreIf 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.