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 Launch.


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 Launch stop working, causing data loss.

Use Adobe Experience Platform Launch to create data elements

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

  1. Go to Adobe Experience Platform Launch and log in if prompted.

  2. Click the desired Launch 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