Client-SideUnity SDKReference

Troubleshooting

Common issues and how to resolve them

Version:

SDK Not Sending Events

  1. Verify isSDKEnabled and SendStatistics are enabled in SDK settings
  2. Check that your token is verified
  3. Enable ShowDebugLog to see console output
  4. Use the Debug Overlay to inspect request status

Missing Device Identifiers

  1. Check Privacy tab settings in the SDK configuration
  2. For GAID: Ensure Play Services is available on the device
  3. For manual mode: Verify SetAdvertisingId() is called early

Events Not Appearing in Dashboard

  1. Check internet connectivity on the device
  2. Verify token is valid in SDK settings
  3. Events may take a few minutes to process
  4. Check for errors in Debug Overlay

ProGuard Issues (Android)

If you see ClassNotFoundException or NoSuchMethodError in release builds:

  1. Verify ProGuard rule is added:
-keep class com.Geeklab.plugin.** { *; }
  1. Rebuild the project
  2. Test all SDK features in the release build

Token Verification Fails

  1. Check your internet connection
  2. Verify the token in your AudienceLab dashboard
  3. Ensure the token hasn't expired
  4. Try restarting Unity after saving the token

Events Queuing But Not Sending

  1. Check network connectivity
  2. Verify the token is valid
  3. Check queue limits (max 200 events, 24-hour expiration)
  4. Use Debug Overlay to monitor queue status

Debug Overlay Not Appearing

  1. Verify Enable Debug Overlay is checked in SDK settings
  2. Check the toggle key (default: F8)
  3. On mobile: Use five-finger tap
  4. Confirm this is a development build (not release)

Getting Help

If you're still experiencing issues:

  1. Enable debug logging and capture the console output
  2. Note the SDK version (AudiencelabSDK.GetSDKVersion())
  3. Describe the steps to reproduce the issue
  4. Contact AudienceLab support with this information