Migration › Knowledge Base
Knowledge Base
The “why” behind every step
Everything the migration steps lean on — concepts, decisions, and reference — organized so you can browse it directly, or reach any topic in context via a step's “Why?” link.
Concepts
Why Web SDK
Why the Adobe Web SDK replaces AppMeasurement — the shift from browser-side collection to the Edge Network, in plain terms.
The Edge Network
What the Adobe Edge Network is and why data is now assembled there instead of in the browser with the Web SDK.
Schema & XDM
What an XDM schema is and the shape all Web SDK data must take when migrating from AppMeasurement.
xdm vs data object
The xdm object versus the data object in the Web SDK — the decision that shapes your whole migration path.
Identity & ECID
How visitor identity and the ECID work in the Web SDK, and the continuity cliff to avoid during migration.
The consent model
How consent works in the Adobe Web SDK — gating an event queue rather than a single beacon — with your CMP.
Context data
The context data path in the Web SDK — sending Analytics context data through the Edge during migration.
Data-layer design
How to design a data layer the Web SDK can read cleanly when migrating from AppMeasurement.
Decisions
The strategic forks
Five decisions to make up front before migrating Adobe Analytics from AppMeasurement to the Web SDK.
The Full Extension
The Full Extension (ExperienceEvent) field group that auto-maps Analytics variables into your XDM schema.
The Profile lock
Why you don't enable the Profile dataset on your datastream yet when migrating to the Web SDK.
Validation report suite
Why to send Web SDK data to a validation report suite, not your live RSID, while proving the migration.
The datastream
What the datastream is and how it bridges the Edge Network to your Adobe Analytics report suite.
One library (alloy)
How the Web SDK library (alloy.js) is loaded and configured when migrating from AppMeasurement.
Reference
Variable groups & schema map
Where each AppMeasurement variable group lives in your XDM schema after migrating to the Web SDK.
Variable mapping catalog
A legacy-to-XDM lookup mapping AppMeasurement eVars, props, and events to Web SDK XDM fields.
Plugin cookbook
How to move doPlugins logic to onBeforeEventSend when migrating Adobe Analytics plugins to the Web SDK.
Cookie reference
Which cookies change with the Web SDK and how to re-teach your CMP after migrating from AppMeasurement.
Rule order & sendEvent
How to order tag rules and the sendEvent call to fix the race condition in a Web SDK migration.
Glossary
Key Adobe Web SDK migration terms — XDM, datastream, Edge Network, ECID, alloy — at a glance.
Program & strategy
Validation & parity
The side-by-side method for validating data parity between AppMeasurement and the Web SDK.
Rollout & decommission
Phasing, cutover, and rollback for rolling out the Web SDK and decommissioning AppMeasurement.
Governance & ownership
Who owns and maintains the Web SDK implementation, schema, and datastream after migrating from AppMeasurement.
The forward path
Where the Web SDK migration leads next — Customer Journey Analytics, Event Forwarding, and Target.