Last updated Oct 24, 2023

Adobe Experience Platform

Installing the Rokt Adobe Launch extension

Add the Rokt extension

1. Sign in to Adobe Experience Platform.
2. From a property's overview page, open the Extensions tab.
3. Select the Catalog tab and search “Rokt”.
4. Choose to save the Rokt extension.

Configure the Rokt extension

Before you begin, please ensure you have your Rokt Account ID. To find yours, see the instructions here.

1. Navigate to the Installed tab and select Configure on the Rokt extension.

2. Add the Account Id and select Sandbox.

3. Connect the Attributes to your data elements.

   1. Select the add icon next to each attribute and choose the apropriate data layer for the field. See the list of Core Attributes here.

      note

      When using the attribute email, addresses may be hashed(#) or raw.

   2. Once connected, you will see your variable name appear eclosed in double brackets.

4. Select Save.

note

If the appropriate variable is not showing in your data layer see Setting up the variables in the Adobe Experience Platform data layer and check with your Rokt account manager for next steps.

Test the Rokt extension

1. Publish your Rokt tag configuration to the relevant Publishing Environment for testing. Retrieve the relevant adobe script tag via the Environment nav bar icon in adobe experience in the Install column.
2. Add the tag to a staging environment, then let your Rokt account manager know you have published the Rokt extension live to your staging site. Rokt will perform QA and testing on the integration.
3. Install, configure, and save the tag on your production site, by navigating to Tag properties and choosing your production tag.
4. Once the Rokt extension is configured and saved, let your Rokt account manager know in order to perform the final testing and QA.

Setting up the variables in the Adobe Experience Platform

Understanding the data layer

The data layer should have been implemented on your web page by your developers.

A data layer is an object that contains all of the information that you want to share with Adobe Experience Platform. Information such as events or variables can be shared to Adobe via the data layer, and triggers can be set up in Adobe Experience Platform based on the values of variables or based on the specific events.

Refer to the Adobe Experience developer guide for comprehensive details on how the data layer works.

Example of a data layer

window.dataLayer = window.dataLayer || []

window.dataLayer.push({  'email':'jenny.smith@rokt.com',  'consumer': {    'firstname' : 'Jenny',    'lastname' : 'Smith'  },  'ecommerce': {    'transaction': {      'amount' : '12.36'    }  },  'event':'gtm.transactionComplete'});

Identifying your variable name

Variables are set up in your Adobe Experience Platform and are matched to the data layer. Refer to the Adobe Experience developer guide for more details about variables.

The structure of your data layer on your page affects the data layer variable name in your Adobe Experience Platform. See the following examples.

Example data layer script 1

window.dataLayer.push({    'email':'jenny.smith@rokt.com'});

Data layer variable name: email

Example data layer script 2

window.dataLayer.push({    'consumer': {        'firstname' : 'Jenny'    }});

Data layer variable name: consumer.firstname

Example data layer script 3

window.dataLayer.push({    'ecommerce': {        'transaction': {            'amount' : '12.36'        }    }});

Data layer variable name: ecommerce.transaction.amount

Adding data elements

1. Navigate to the Data Elements tab and choose Add Data Element.
2. Name your variable and choose Core as the extension and Local Storage as the Data Element Type.
3. Enter the Local Storage Item Name that matches the variable name in your data layer setup by your developer.