Troubleshooting
Common issues and how to resolve them
Version:
SDK Not Sending Events
- Verify isSDKEnabled and SendStatistics are enabled in SDK settings
- Check that your token is verified
- Enable ShowDebugLog to see console output
- Use the Debug Overlay to inspect request status
Missing Device Identifiers
- Check Privacy tab settings in the SDK configuration
- For GAID: Ensure Play Services is available on the device
- For manual mode: Verify
SetAdvertisingId()is called early
Events Not Appearing in Dashboard
- Check internet connectivity on the device
- Verify token is valid in SDK settings
- Events may take a few minutes to process
- Check for errors in Debug Overlay
ProGuard Issues (Android)
If you see ClassNotFoundException or NoSuchMethodError in release builds:
- Verify ProGuard rule is added:
-keep class com.Geeklab.plugin.** { *; }- Rebuild the project
- Test all SDK features in the release build
Token Verification Fails
- Check your internet connection
- Verify the token in your AudienceLab dashboard
- Ensure the token hasn't expired
- Try restarting Unity after saving the token
Events Queuing But Not Sending
- Check network connectivity
- Verify the token is valid
- Check queue limits (max 200 events, 24-hour expiration)
- Use Debug Overlay to monitor queue status
Debug Overlay Not Appearing
- Verify Enable Debug Overlay is checked in SDK settings
- Check the toggle key (default: F8)
- On mobile: Use five-finger tap
- Confirm this is a development build (not release)
Getting Help
If you're still experiencing issues:
- Enable debug logging and capture the console output
- Note the SDK version (
AudiencelabSDK.GetSDKVersion()) - Describe the steps to reproduce the issue
- Contact AudienceLab support with this information