Weekly live AEP workshops every Friday - reserve your seat →
Student question · Web SDK

Web SDK troubleshooting: events not reaching AEP

Step-by-step Web SDK troubleshooting when alloy.js events do not appear in AEP: network calls, datastream ID, services, schema, identity and ingestion.

Quick answer

When a website sends Web SDK events but nothing appears in AEP, work from the browser to the platform: confirm interact requests reach the Edge Network, check the datastream ID and that the datastream is active with the Experience Platform service enabled, then verify the dataset mapping, XDM schema, identity namespaces and ingestion monitoring for failures.

Checklist from browser to platform

  1. Network tab — are interact requests sent to the Edge Network?
  2. AEP Debugger — inspect the payload and the Edge trace.
  3. Datastream ID — the edgeConfigId in the request must match the datastream you configured.
  4. Datastream status — active, with the Experience Platform service enabled.
  5. Dataset mapping — the event dataset is selected in the datastream.
  6. XDM schema — payload fields match the schema.
  7. Identity — namespaces exist and identityMap is valid.
  8. Ingestion monitoring — look for failed batches or errors.

Datastream ID does not match

If a debugger shows a different datastream than the one you configured, the page is usually loading a different Tags property or environment, or the extension is configured for another environment. Check the embed code on the page, the library build and the Web SDK extension settings for each environment.

ECID missing from the request

Confirm the Web SDK extension is configured to manage identity, consent has not blocked collection, and the first request completed. Then read ECID with getIdentity (see the ECID data element guide).

Frequently asked questions

Which tool should I start with?

The browser network tab and the Adobe Experience Platform Debugger; they show whether the problem is on the page or in the platform.

Can consent block Web SDK?

Yes. If default consent is pending or out, events may be held or dropped.

Last updated:

Ready to move your Adobe MarTech program forward?

Consulting for enterprise teams, training for professionals. Tell us where you are today.

WhatsApp