Connecting to Adobe Analytics and Creating Frameworks

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. Also, the Polling Data Importer service retrieves page impressions from Adobe Analytics. This information appears in the Impressions column of the Websites 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 be assigned to the Web Service Access user group.

Before proceeding, ensure your credentials allow you to log in to Adobe Analytics. ( https://sc.omniture.com/login/)

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.3/rest/) data center by default. Use the Admin Console to add the URL for each 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.

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.

The framework system lets you change the server settings within each Adobe Analytics framework.

Start by opening the panel. Press the downward arrow next to Servers:

1. 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
2. Secure Tracking Server
   • Has the same segments as the Tracking server
   • This is used for sending data from secure pages (https://)
3. 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. The data that is sent are any CQ variables that the page populates with data that are also mapped to Adobe Analytics variables in the framework. Also, the framework also causes AEM to retrieve page impresions 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.

1. From the Welcome screen, go to Websites and select the page you wish to set up with tracking. 
2. Double click on the page to open it for editing.
3. Go to the Page tab of the Sidekick (second from the left) and select Page properties.
4. On the Page Properties panel, go to the Cloud Services page and click the Add service button.
5. Select Adobe Analytics from the available options and click Ok.
6. Click on the dropdown menu and select the framework created in the previous section
   
   •  i.e. my-sc-framework.
7. Click Ok again to make the selection final.
8. In order to activate the page and any connected configurations/files, select Activate page from the Page tab of the Sidekick.
9. The final step is to visit the page on the publish instance and searching for a keyword (e.g. aubergine) using the Search component.
10. Check the calls made to Adobe Analytics using an appropriate tool, like Adobe DigitalPulse Debugger or any web debugging tool.
11. 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 impressions appears in the Impressions column of the Websites console. The association of the page with a framework causes the Adobe Analytics Impressions Importer service to automatically retrieve the information:

• Impressions information is retreived from Adobe Analytics and updated in the Websites console once a day by default. You can configure a different polling interval.
• Impressions data is available as soon as the simplest tracking calls to Adobe Analytics occur. No special reports are required on Adobe Analytics to enable the retrieval of the impressions data. 
• The Adobe Analytics Impressions Importer service calls Adobe Analytics asynchronously to minimize the use of AEM resources.
• Impressions are shown for a single page. For example, you cannot see the total number of impressions for all child pages.

Use of the Adobe Analytics Impressions Importer service requries no special licensing.

Configure the Day CQ Analytics SiteCatalyst Impressions Importer service:

• Change the interval at which the service retrieves page impressions data from Adobe Analytics. The default interval is 43200000 ms (12 hours).
• Disable or enable the service. By default, the service is enabled.

To delete a particular Adobe Analytics configuration or framework, do the following:

1. From the Welcome screen, go to Tools > Cloud Services Configurations > Adobe Analytics
   • To delete frameworks, go one node deeper by choosing the Adobe Analytics configuration the framework belongs to.
2. Choose the configuration or framework you want to delete from the panel on the right.
   
3. Right-click it and select Delete from the menu that pops up.
4. Confirm the deletion of the configuration or framework.

There are two possible ways to edit Adobe Analytics configurations and frameworks within AEM.

1. Go to Tools > Cloud Services Configurations > Adobe Adobe Analytics
2. Choose a configuration/framework from the panel on the right.
   • To open up a framework page for editing, you need to go at least one node deeper, by first choosing the Adobe Analytics configuration the framework belongs to.
3. Double click the configuration or framework in the panel to the right to open it for editing.

The other way is:

1. Go to the Cloud services dashboard from the Welcome screen
2. Select the Adobe Analytics menu item on the dashboard
3. Press the Show configurations button
4. Select one of the configurations or frameworks from the tree to open it for editing.