To track web data from your AEM pages in Adobe Analytics, create a Adobe Analytics Cloud Services configuration and a Adobe Analytics framework:
- Adobe Analytics Configuration: The information about your Adobe Analytics account. The Adobe Analytics configuration enables AEM to connect to Adobe Analytics. Create an Adobe Analytics configuration for each account that you use.
- Adobe Analytics Framework: A set of mappings between Adobe Analytics report suite properties and CQ variables. Use a framework to configure how your website data populates your Adobe Analytics reports. Frameworks are associated with a Adobe Analytics configuration. You can create multiple frameworks for each configuration.
When you assocate a web page with a framework, the framework performs tracking for that page and the descendents of that page. Page views can then be retrieved from Adobe Analytics and displayed in the Sites console.
To track AEM data in Adobe Analytics, you must have a valid Adobe Marketing Cloud Adobe Analytics account.
The Adobe Analytics account needs to:
- Have Administrator privileges
- Be assigned to the Web Service Access user group.
Providing Administrator privileges (within Adobe Analytics) is not enough to allow a user to connect from AEM to Adobe Analytics. The account must also have Web Service Access privileges.
Adobe Analytics data centers collect, process and store data associated with your Adobe Analytics report suite. You must configure AEM to use the data center that hosts your Adobe Analytics report suite. The following table lists the available data centers and their URL.
AEM uses the San Jose (https://api.omniture.com/admin/1.4/rest/) data center by default.
Use the Web Console to configure the OSGi bundle Adobe AEM Analytics HTTP Client. Add the Data Center URL for the data center that hosts a report suite for which your AEM pages collect data.
Create a Adobe Analytics configuration so that AEM can authenticate with the Adobe Analytics server. To create the configuration you provide the credentials for your Adobe Analytics account.
The Shared Secret can be seen in the Account Information in Adobe Analytics.
When the Edit Component dialog opens, specify values for the following properties:
- Company: your company's name as featured on Adobe Analytics
- Username: the name used to log in to Adobe Analytics
- Shared Secret: the Adobe Analytics shared secret for the above account
- Data Center: The location of the Adobe Analytics data center that your account is associated with.
- Do not add tracking tag to page: Select this option when you are using Adobe Analytics reports in the Content Insights feature, and you are also using Dynamic Tag Management (DTM) with AEM, and the DTM web property has the Adobe Analytics tool installed. In this case, selecting this option prevents two instances of the tracking code being added to pages.
- Do not track the page load event: as appropriate
- Use App Measurement: as appropriate
- Use ClientContext: as appropriate
- Additional context data: as appropriate
- Segment: as appropriate
Please contact your Adobe Analytics representative to confirm any details and make sure you fill in these credentials correctly.
For the Report Suite ID (RSID) that you are using, you can control which server instances (author, publish, or both) contribute data to the Report Suite:
- All: Information from both the author and the publish instance populates the Report Suite.
- Author: Only information from the author instance populates the Report Suite.
- Publish: Only information from the publish instance populates the Report Suite.
Selecting the type of server instance does not restrict calls to Adobe Analytics, it merely controls which calls include the RSID.
For example, a framework is configured to use the diiweretail report suite and author is the selected server instance. When pages are published along with the framework, calls are still made to Adobe Analytics, however these calls do not contain the RSID. Only calls from the author instance include the RSID.
In the Report Suites section of the side pod (right side of main panel), click Add Item. Then use the drop-down to select the Report Suite ID (for example, geometrixxauth) with which the framework will interact.
The content finder on the left is populated with Adobe Analytics variables (SiteCatalyst Variables) when you select a Report Suite ID.
These settings determine where your data is sent and how, so it is imperative that you do not tamper with these settings and let your Adobe Analytics representative set it up instead.
- Tracking Server
- contains the URL used to send Adobe Analytics calls
- cname - defaults to the Adobe Analytics account's Company name
- d1 - corresponds to the data center the information will be sent to (can be either d1, d2 or d3)
- sc.omtrdc.net - domain name
- contains the URL used to send Adobe Analytics calls
- Secure Tracking Server
- Has the same segments as the Tracking server
- This is used for sending data from secure pages (https://)
- Visitor Namespace
- The namespace determines the first part of the tracking URL.
- e.g. changing the namespace to CNAME will cause the calls made to Adobe Analytics to look like CNAME.d1.omtrdc.net instead of the default.
When a page is associated with a Adobe Analytics framework, the page sends data to Adobe Analytics when the page loads. Variable that the page populates are mapped and retrieved from Adobe Analytics variables in the framework. For example, page views are retrieved from Adobe Analytics.
Descendents of the page inherit the association with the framework. For example, when you associate the root page of your site with a framework, all pages of the site are associated with the framework.
- From the Sites console, select the page you wish to set up with tracking.
- Open the Page Properties, either directly from the console, or the page editor.
- Open the Cloud Services tab.
- Use the Add Configuration drop down to select Adobe Analytics from the available options. If inheritance is place you need to disable that before the selector becomes available.
- The drop down selector for Adobe Analytics will be appended to the options available. Use this to select the required framework configuration.
- Select Save & Close.
- Publish the page to activate the page and any connected configurations/files.
- The final step is to visit the page on the publish instance and search for a keyword (e.g. aubergine) using the Search component.
- You can then check the calls made to Adobe Analytics using an appropriate tool; for example, Adobe DigitalPulse Debugger or any web debugging tool.
- Using the example provided, the call should contain the value entered (i.e. aubergine) in eVar7 and the events list should contain event3.
When a page is associated with a Adobe Analytics framework, the number of page views can be shown in the List view of the Sites console.
See Seeing Page Analytics Data for further details.
Configure the appropriate instance of the Managed Polling Configurations service:
- Poll Interval:
The interval, in seconds, at which the service retrieves page view data from Adobe Analytics.
The default interval is 43200000 ms (12 hours).
Enable or disable the service. By default, the service is enabled.
As when creating an Adobe Analytics configuration or framework, navigate to the Cloud Services screen. Select Show Configurations, then click on the link to the specific configuration you want to update.
When editing an Adobe Analytics configuration, you also need to press the Edit button when on the configuration page itself in order to open the Edit Component dialog.
To delete an Adobe Analytics framework, first open it for editing.
Then select Delete Framework from the Page tab of the sidekick.