Map data layer objects to data elements

Once your organization has established and implemented a data layer on your site, you can map data layer objects to data elements within tags.


Adobe Experience Platform Launch has been rebranded as a suite of data collection technologies in Experience Platform. Several terminology changes have rolled out across the product documentation as a result. Please refer to the following document for a consolidated reference of the terminology changes.


Create a data layer: Make sure a data layer exists on your site. While you technically can map any JavaScript object or scrape CSS elements directly from the page, Adobe recommends this practice as a last resort. If your site layout changes, the CSS selectors used in tags stop working, causing data loss.

Use tags to create data elements

Data elements are components in the Data Collection UI that you can use across the tool. You can assign variable values in the Adobe Analytics extension using data elements.

  1. Log in to the Data Collection UI using your AdobeID credentials.

  2. Click the desired tag property.

  3. Click the Data Elements tab, then click Add Data Element.

    create data element

  4. Enter a name for your data element. It can be a simple label that corresponds to a JavaScript variable in your data layer that you want to track.

  5. Under the Extension dropdown, select Core.

  6. Under the Data Element Type dropdown, select JavaScript Variable. A text field appears to the right that allows you to enter the JavaScript variable to map to this data element.

  7. Enter the desired Javascript variable, typically within your data layer. For example, if your organization’s data layer closely matches Adobe’s recommended practice, a value could be You can use your browser’s console to validate JavaScript variable syntax and values.

  8. Click Save.

Next steps

Map data elements to Analytics variables: Assign data elements to Analytics variables so you can use them as dimensions in Analysis Workspace.

On this page