Create a data layer

A data layer is a framework of JavaScript objects on your site that contain the variable values used in your Analytics implementation. It allows greater control and easier maintenance when assigning values to Analytics variables.


Create a solution design document - It is important for your organization to align on tracking requirements. Make sure that you are prepared with a solution design document before approaching development teams in your organization.


Implementing Adobe Analytics using a data layer typically follows these steps:

  1. Work with your site development team to implement a data layer: Your site development team is primarily responsible for making sure the data layer object populates with correct values. Review this page with your site development team to make sure expectations are aligned between teams.

    note note
    Following Adobe’s recommended data layer specifications is optional. If you already have a data layer, or otherwise choose not to follow Adobe’s specifications, make sure that your organization aligns on what specification to follow.
  2. Validate your data layer using a browser console: Once a data layer is created, you can validate that it is working using any browser’s developer console. You can open the developer console in most browsers using the F12 key. An example variable value would be

  3. Use Adobe Experience Platform Data Collection to map data layer objects to data elements: This step varies based on your organization’s implementation method:

    • If using the Web SDK: Map the desired data layer objects to the desired XDM fields in Adobe Experience Platform Edge. See Analytics XDM variable mapping to determine the desired data layer mapping.
    • If using the Analytics extension: Create data elements under Tags in Adobe Experience Platform Data Collection, and assign them to the desired data layer objects. Then within the Analytics extension, assign each data element to the appropriate Analytics variable.


Adobe recommends using the Adobe Client Data Layer for new or restructured implementations.

Your organization is free to use other data layer specifications, such as the Customer Experience Digital Data Layer, or another custom specification entirely. Aligning to a consistent data layer that meets your organization’s needs is the most important.

Data layers are extensible; if you have requirements specific to your organization, you can include objects in your data layer to accommodate those needs.

Setting data layer values

Data layers typically generate server-side, referencing the same objects used to build the site content. Establish the site’s data layer based on tracking requirements set in your organization’s solution design document.

Next steps

Map data layer objects to data elements: Use your site’s data layer in Adobe Experience Platform.