Mapping Component Data with Adobe Analytics Properties
- Topics:
- Administering
CREATED FOR:
- Admin
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:
- The page is associated with the framework.
- The page uses the components that are added to the framework.
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 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)
topagedata.title
.NOTE
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.
NOTE
You can map multiple Analytics variables (e.g.props
,eVars
,events
) to the same CQ variable (e.g.pagedata.title
)CAUTION
It is highly recommended that:eVars
andprops
are mapped to CQ variables beginning with eitherpagedata.X
oreventdata.X
- whereas events should be mapped to variables starting with
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.
Mapping Product-Related Variables
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.categor y (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.
Checking reports on Adobe Analytics
-
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; e.g. aubergine in the example
Using the Content Finder (cf#) with Adobe Analytics frameworks
Initially, when you open an Adobe Analytics framework the content finder contains predefined Analytics variables under:
-
Traffic
-
Conversion
-
Events
When an RSID is selected all the variables belonging to that RSID get added to the list.
The cf#
is needed in order 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 3 filter buttons:
- If no button is selected, the list shows the full list.
- If the Traffic button is selected, the list will only show the variables belonging to the Traffic section
- If the Conversion button is selected, the list will only show the variables belonging to the Conversion section.
- If the Events button is selected, the list will only show the variables belonging to the Events section.
NOTE
Only one filter button can be active at once.- The list also has a search feature, which filters the elements according to the text entered in the search field.
- If a filter option is activated while searching for elements in the list, the results displayed will be filtered according to the active button as well.
- The list can be reloaded at any time using the swirly-arrows button.
- If multiple RSIDs are selected on the framework, all variables in the list will be displayed using all labels used within the RSIDs selected.
-
When in Adobe Analytics view, the Content Finder displays all CQ variables belonging to the tracking components dragged in CQ view.
- e.g. in case the **Download component **is the only one dragged in CQ view (which has two mappable variables eventdata.downloadLink and eventdata.events.startDownload), the Content Finder wil look like this when switching to Adobe Analytics view:
- The variables can be dragged&dropped onto any Adobe Analytics variable belonging to either one of the 3 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.
NOTE
Only one CQ variable can be mapped to a Adobe Analytics variable at once
Using AEM view and Analytics view
At any given time, users have the option to switch between 2 ways of viewing the Adobe Analytics mappings when on a framework page. The 2 views provide a better overview of the mappings within the framework, from 2 distinct perspectives.
AEM View
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.
- Inherited components are locked.
- To unlock an inherited component, just double-click on the padlock next to the component’s name
- In order to revert the inheritance you must delete the unlocked component; after which it will regain its locked status.
-
Drag components here to include them in the analytics framework: Components can be dragged from the Sidekick and dropped here.
-
You can find all of the components that are currently included in the analytics framework:
- To add a component drag one from the sidekick’s Components tab
- To delete a component and all of its mappings, select Delete from the component’s context menu then accept the deletion on the confirmation dialogue.
- Keep in mind that a component can only be deleted from the framework it was created in, and cannot be deleted from child frameworks in the traditional sense (they can only be overwritten).
-
Analytics View
-
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
- Traffic variable (
-
Conversion:
- Conversion variable (
eVar1
) mapped to a CQ variable (pagedata.title
) - Conversion variable (
eVar3
) mapped to a javascript expression added inline by double-clicking on the CQ variable field and entering the code manually
- Conversion variable (
-
Event:
- Event variable (
event1
) mapped to a CQ event (eventdata.events.pageView
)
- Event variable (
-
- e.g. 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 asprop3
Experience Manager
- Administering User Guide overview
- Sites Features
- Website Administration
- Reusing Content: Multi Site Manager and Live Copy
- Live Copy Overview Console
- Configuring Live Copy Synchronization
- Creating and Synchronizing Live Copies
- MSM Rollout Conflicts
- MSM Best Practices
- Translating Content for Multilingual Sites
- Managing Translation Projects
- Identifying Content to Translate
- Preparing Content for Translation
- Creating a Language Root Using the Classic UI
- Connecting to Microsoft Translator
- Configuring the Translation Integration Framework
- Language Copy Wizard
- Translation Enhancements
- Translation Best Practices
- Configurations and the Configuration Browser
- AEM FAQs
- Operations
- Dashboards
- Operations Dashboard
- Backup and Restore
- Data Store Garbage Collection
- Monitoring Server Resources Using the JMX Console
- Working with Logs
- Configure the Rich Text Editor
- Configure the Video component
- The Bulk Editor
- Configuring Email Notification
- Configuring RTE for Producing Accessible Sites
- The Link Checker
- Troubleshooting AEM
- Audit Log Maintenance in AEM 6
- Editor
- Managing Access to Workflows
- Using cURL with AEM
- Configuring Undo for Page Editing
- Proxy Server Tool (proxy.jar)
- Configuring for AEM Apps
- Administering Workflows
- Configuring Search Forms
- Tools Consoles
- Reporting
- Administering Workflow Instances
- Configuring Layout Container and Layout Mode
- Enabling Access to Classic UI
- Starting Workflows
- Configure the Rich Text Editor plug-ins
- Admin Consoles
- Security
- User Administration and Security
- User, Group and Access Rights Administration
- Security Checklist
- OWASP Top 10
- Running AEM in Production Ready Mode
- Identity Management
- Adobe IMS Authentication and Admin Console Support for AEM Managed Services
- Creating a Closed User Group
- Mitigating serialization issues in AEM
- User Synchronization
- Encapsulated Token Support
- Single Sign On
- How to Audit User Management Operations in AEM
- SSL By Default
- SAML 2.0 Authentication Handler
- Closed User Groups in AEM
- Granite Operations - User and Group Administration
- Enabling CRXDE Lite in AEM
- Configuring LDAP with AEM 6
- Configure the Admin Password on Installation
- Service Users in AEM
- Encryption Support for Configuration Properties
- Handling GDPR Requests for the AEM Foundation
- Content Disposition Filter
- Personalization
- eCommerce
- Integration
- Integrating with Third-Party Services
- Integrating with Salesforce
- Integrating with Adobe Target
- Integrating with Adobe Analytics
- Connecting to Adobe Analytics and Creating Frameworks
- Configuring Link Tracking for Adobe Analytics
- Mapping Component Data with Adobe Analytics Properties
- Configuring Video Tracking for Adobe Analytics
- HTTP2 Delivery of Content FAQ
- Troubleshooting your Adobe Campaign Integration
- SharePoint Connector Licenses, Copyright Notices, and Disclaimers
- SharePoint Connector
- DHTML Viewer End-of-Life FAQs
- Integrating with Adobe Campaign Classic
- Related Community Articles
- Integrating with Adobe Campaign Standard
- Flash Viewers End-of-Life Notice
- Integrating with Adobe Creative Cloud
- Integrating with Adobe Dynamic Tag Management
- Opting Into Adobe Analytics and Adobe Target
- AEM Portals and Portlets
- Integrating with Dynamic Media Classic
- Troubleshooting Integration Issues
- Integrating with BrightEdge Content Optimizer
- Best Practices for Email Templates
- Catalog Producer
- Integrating with Silverpop Engage
- Integrating with Adobe Campaign
- Integrating with ExactTarget
- Analytics with External Providers
- Integrating with the Adobe Marketing Cloud
- Manually Configuring the Integration with Adobe Target
- Prerequisites for Integrating with Adobe Target
- Adobe Classifications
- Solutions Integration
- Target Integration with Experience Fragments
- Best Practices
- Content Management