Debug Overlay
Built-in debugging tools for development
Version:
A built-in debug overlay helps troubleshoot SDK integration during development.
Enable Debug Overlay
- Go to AudienceLab SDK > Debug tab
- Check Enable Debug Overlay
- Configure options:
- Max Events: Number of recent events to display
- Show Raw Identifiers: Display full device IDs
- Toggle Key: Keyboard shortcut (default: F8)
On-Device Toggle
In development builds, use a five-finger tap to toggle the overlay on mobile devices.
Overlay Information
The debug overlay displays:
- Token status and last fetch attempt
- Device identifiers (IDFV, GAID, App Set ID)
- Recent requests with success/failure status
- Request payloads and responses
Configuration Options
| Option | Description |
|---|---|
| Max Events | Number of recent events to display in the overlay |
| Show Raw Identifiers | Display full device IDs instead of truncated versions |
| Toggle Key | Keyboard shortcut to toggle overlay visibility |
Availability
The debug overlay is only available in Editor and Development builds. It is automatically excluded from release builds.
Troubleshooting with the Overlay
Use the overlay to verify:
- Token Status: Ensure the token is valid and has been fetched
- Device Identifiers: Check that expected identifiers are being collected
- Request Status: Monitor success/failure of event requests
- Payloads: Inspect the exact data being sent to the server