Skip to documentation
AdQuestDocs

Troubleshooting

Trace integration failures from platform configuration through participant settlement.

On this page

The widget loads but no quests appear

  1. Confirm the platform is accepted and active, and that the API key belongs to it.

  2. Check the quest is active, within its schedule and visible to this platform.

  3. Check targeting, funding and delivery caps. Test with an eligible participant who has not already completed the quest.

  4. Confirm the API base URL ends in /api/v1 and the request reaches the correct environment.

Look up an error code

The iframe or WebView stays at initialization

  • Verify the public UUID in the embed URL and that the listener was installed before the iframe navigated.
  • Wait for adquest:ready and send a version 1 adquest:init envelope with the correct public key, external user ID and participant token.
  • Check the exact target origin and native bridge name. Parse JSON strings when your host receives them.
  • Check that your Content Security Policy allows the SDK frame and required network / media resources.

Send a useful support report

Include the platform ID, quest ID, approximate timestamp, integration type, request path, HTTP status, error code and steps to reproduce. For webhooks, include the event ID and delivery status. Redact credentials and participant personal data.

Something unclear, missing or wrong here? Tell us