Add components to the framework that gather the data to send to Adobe Analytics. Components that are designed to gather analytics data store the data in the appropriate CQ variable. When you add such a component to a framework, the framework displays the list of CQ variables so that you can each to the appropriate Analytics variable.
When the AEM view is open the Analytics variables appear in the content finder.
You can map multiple Analytics variables with the same CQ variable.
The mapped data is sent to Adobe Analytics when the page loads and the following conditions are met:
Use the following procedure to map CQ component variables with Adobe Analytics report properties.
In the AEM view, drag a tracking component from sidekick onto the framework. For example, drag the Page component from the General category.
There are several default component groups: General, Commerce, Communities, and Other. Your AEM instance may be configured to display different groups and components.
To map Adobe Analytics variables with variables that are defined in the component, drag an Analytics variable from the content finder onto a field on the tracking component. For example, drag Page Name (pageName)
to pagedata.title
.
The Report Suite ID (RSID) that is selected for the framework determines the Adobe Analytics variables that appear in the content finder.
Repeat the previous two steps for other components and variables.
You can map multiple Analytics variables (for example, props
, eVars
, events
) to the same CQ variable (for example, pagedata.title
)
It is highly recommended that:
eVars
and props
are mapped to CQ variables beginning with either pagedata.X
or eventdata.X
eventdata.events.X
To make the framework available on the publish instance of your site, open the Page tab of sidekick, and click Activate Framework.
AEM uses a convention for naming product-related variables and events that are meant to be mapped to Adobe Analytics product-related properties:
CQ Variable | Analytics Variable | Description |
---|---|---|
product.category |
product.category (conversion variable) |
The product category. |
product.sku |
product.sku (conversion variable) |
The product sku. |
product.quantity |
product.quantity (conversion variable) |
The number of products being purchased. |
product.price |
product.price (conversion variable) |
The product price. |
product.events.<eventName> |
The success event(s) to associate with the product in your report. | product.events is the prefix for events named eventName. |
product.evars.<eVarName> |
The conversion variable(s) ( eVar ) to associate with the product. |
product.evars is the prefix for eVar variables named eVarName. |
Several AEM Commerce components use these variable names.
Do not map the Adobe Analytics Products property to a CQ variable. Configuring product-related mappings as described in the table is effectively equivalent to mapping the Products variable.
Login to the Adobe Analytics website using the same credentials provided to AEM.
Make sure the RSID selected is the one used in the previous steps.
In Reports (on the left side of the page) select Custom Conversion, then Custom Conversion 1-10 and select the variable coresponding to eVar7
Depending on the version of Adobe Analytics that you are using, you need to wait on average 45 minutes for the report to be updated with the search term used; for example, aubergine in the example
Initially, when you open an Adobe Analytics framework the content finder contains predefined Analytics variables under:
When an RSID is selected all the variables belonging to that RSID get added to the list.
The cf#
is needed to map Analytics variables to the CQ variables present on the different tracking components. See Setting Up a Framework for Basic Tracking.
Depending on the view selected for the framework, the content finder will be populated by either Analytics variables (in AEM view) or CQ variables (in Analytics view).
The list can be manipulated in the following ways:
When in AEM view, the list can be filtered depending on what variable type is selected using the three filter buttons:
Only one filter button can be active at once.
When in Adobe Analytics view, the Content Finder displays all CQ variables belonging to the tracking components dragged in CQ view.
The variables can be dragged&dropped onto any Adobe Analytics variable belonging to either one of the three variable sections (Traffic, Conversion and Events).
When dragging a new tracking component onto the framework in CQ view, the CQ variables belonging to the component get automatically added to the Content Finder(cf#) in Adobe Analytics view.
Only one CQ variable can be mapped to an Adobe Analytics variable at any given time.
At any given time, users can switch between two ways of viewing the Adobe Analytics mappings when on a framework page. The two views provide a better overview of the mappings within the framework, from two distinct perspectives.
Taking the above image as an example, the AEM view has the following properties:
This is the default view when the framework opens.
Left side: the content finder(cf#) is populated by Adobe Analytics variables based on the RSID(s) selected.
Tab headers (AEM view and Analytics view): use these to switch between the two views.
AEM view:
If the framework has components that are inherited from its parent, they will be listed here, along with the variables mapped to the components.
Drag components here to include them in the analytics framework: Components can be dragged from the Sidekick and dropped here.
You can find all the components that are currently included in the analytics framework:
This view can be accessed by switching to the Analytics view tab on the framework.
Left side: Content Finder (cf#) populated by CQ variables based on the components dragged onto the framework in CQ view.
Tab headers (AEM view and Analytics view): use these to switch between the two views.
The three tables (Traffic, Conversion, Event) list all available Adobe Analytics variables. belonging to the RSID(s) selected. The mappings shown here should be the same as in the AEM view:
Traffic:
Traffic variable ( prop1
) mapped to a CQ variable ( eventdata.downloadLink
)
When the component has a Padlock next to it, this means it is inherited from a parent framework and thus cannot be edited
Conversion:
Conversion variable ( eVar1
) mapped to a CQ variable ( pagedata.title
)
Conversion variable ( eVar3
) mapped to a JavaScript expression added inline by double-clicking the CQ variable field and entering the code manually
Event:
event1
) mapped to a CQ event ( eventdata.events.pageView
)The CQ variable column of any table can be filled inline as well, by double-clicking the field and adding text to it. These fields accept JavaScript as an input.
For example, next to prop3
you can add:
'
* Adobe:'+pagedata.title+':'+pagedata.sitesection
to send the title of a page concatenated with its sitesection using : (colon) and prefixed with Adobe as prop3
Only one CQ variable can be mapped to an Adobe Analytics variable at any given time.