ÃÛ¶¹ÊÓƵ

DocumentationAEM 6.4Administering Guide

Connecting to ÃÛ¶¹ÊÓƵ Analytics and Creating Frameworks connecting-to-adobe-analytics-and-creating-frameworks

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our . Find the supported versions here.

To track web data from your AEM pages in ÃÛ¶¹ÊÓƵ Analytics, create a ÃÛ¶¹ÊÓƵ Analytics Cloud Services configuration and a ÃÛ¶¹ÊÓƵ Analytics framework:

  • ÃÛ¶¹ÊÓƵ Analytics Configuration: The information about your ÃÛ¶¹ÊÓƵ Analytics account. The ÃÛ¶¹ÊÓƵ Analytics configuration enables AEM to connect to ÃÛ¶¹ÊÓƵ Analytics. Create an ÃÛ¶¹ÊÓƵ Analytics configuration for each account that you use.
  • ÃÛ¶¹ÊÓƵ Analytics Framework: A set of mappings between ÃÛ¶¹ÊÓƵ Analytics report suite properties and CQ variables. Use a framework to configure how your website data populates your ÃÛ¶¹ÊÓƵ Analytics reports. Frameworks are associated with a ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Analytics and displayed in the Sites console.

Prerequisites prerequisites

ÃÛ¶¹ÊÓƵ Analytics Account adobe-analytics-account

To track AEM data in ÃÛ¶¹ÊÓƵ Analytics, you must have a valid ÃÛ¶¹ÊÓƵ Marketing Cloud ÃÛ¶¹ÊÓƵ Analytics account.

The ÃÛ¶¹ÊÓƵ Analytics account needs to:

  • Have Administrator privileges
  • Be assigned to the Web Service Access user group.
CAUTION
Providing Administrator privileges (within ÃÛ¶¹ÊÓƵ Analytics) is not enough to allow a user to connect from AEM to ÃÛ¶¹ÊÓƵ Analytics. The account must also have Web Service Access privileges.

chlimage_1-316

Before proceeding, ensure your credentials let you sign in to ÃÛ¶¹ÊÓƵ Analytics using either one of the following methods:

Configuring AEM to Use Your ÃÛ¶¹ÊÓƵ Analytics Data Centers configuring-aem-to-use-your-adobe-analytics-data-centers

ÃÛ¶¹ÊÓƵ Analytics collect, process and store data associated with your ÃÛ¶¹ÊÓƵ Analytics report suite. You must configure AEM to use the data center that hosts your ÃÛ¶¹ÊÓƵ Analytics report suite. The following table lists the available data centers and their URL.

Data Center
URL
San Jose
https://api.omniture.com/admin/1.4/rest/
Dallas
https://api2.omniture.com/admin/1.4/rest/
London
https://api3.omniture.com/admin/1.4/rest/
Singapore
https://api4.omniture.com/admin/1.4/rest/
Oregon
https://api5.omniture.com/admin/1.4/rest/

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 ÃÛ¶¹ÊÓƵ 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.

aa-07

  1. Open the Web console in your web browser. ()

  2. Enter your credentials to access the console.

    note note
    NOTE
    Contact you site administrator to find out if you have access to this console.

  3. Select the Configuration item named ÃÛ¶¹ÊÓƵ AEM Analytics HTTP Client.

  4. To add the URL for a data center, press the + button next to the Data Center URLs list, and type the URL in the box.

  5. To remove a URL from the list, click the - button next to the URL.

  6. Click Save.

Configuring the Connection to ÃÛ¶¹ÊÓƵ Analytics configuring-the-connection-to-adobe-analytics

CAUTION
Due to security changes within the ÃÛ¶¹ÊÓƵ Analytics API, it is no longer possible to use the version of Activity Map that is included within AEM.
The ActivityMap plugin provided by ÃÛ¶¹ÊÓƵ Analytics should now be used.

Configuring for the Activity Map configuring-for-the-activity-map

CAUTION
Due to security changes within the ÃÛ¶¹ÊÓƵ Analytics API, it is no longer possible to use the version of Activity Map that is included within AEM.
The ActivityMap plugin provided by ÃÛ¶¹ÊÓƵ Analytics should now be used.

Creating a ÃÛ¶¹ÊÓƵ Analytics Framework creating-a-adobe-analytics-framework

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.
NOTE
Selecting the type of server instance does not restrict calls to ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Analytics, however these calls do not contain the RSID. Only calls from the author instance include the RSID.

  1. Using Navigation, select Tools, Cloud Services, then Legacy Cloud Services.

  2. Scroll to ÃÛ¶¹ÊÓƵ Analytics and click [+] next to Available Configurations.

  3. Click the [+] link next to your ÃÛ¶¹ÊÓƵ Analytics configuration.

  4. In the Create Framework dialog:

    • Specify a Title.
    • Optionally you can specify the Name, for the node that stores the framework details in the repository.
    • Select ÃÛ¶¹ÊÓƵ Analytics Framework

    And click Create.

    The framework opens for editing.

  5. 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.

    note note
    NOTE
    The content finder on the left is populated with ÃÛ¶¹ÊÓƵ Analytics variables (SiteCatalyst Variables) when you select a Report Suite ID.

  6. Then use the Run Mode drop down (next to the Report Suite ID) to select the server instances that you want to send information to the Report Suite.

    aa-framework-01

  7. To make the framework available on the publish instance of your site, on the Page tab of sidekick, click Activate Framework.

Configuring Server Settings for ÃÛ¶¹ÊÓƵ Analytics configuring-server-settings-for-adobe-analytics

The framework system lets you change the server settings within each ÃÛ¶¹ÊÓƵ Analytics framework.

CAUTION
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 ÃÛ¶¹ÊÓƵ Analytics representative set it up instead.

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

server_001

  • Tracking Server

    • contains the URL used to send ÃÛ¶¹ÊÓƵ Analytics calls

      • cname - defaults to the ÃÛ¶¹ÊÓƵ 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

  • 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 ÃÛ¶¹ÊÓƵ Analytics to look like CNAME.d1.omtrdc.net instead of the default.

Associating a Page with a ÃÛ¶¹ÊÓƵ Analytics Framework associating-a-page-with-a-adobe-analytics-framework

When a page is associated with an ÃÛ¶¹ÊÓƵ Analytics framework, the page sends data to ÃÛ¶¹ÊÓƵ Analytics when the page loads. Variables that the page populates are mapped and retrieved from ÃÛ¶¹ÊÓƵ Analytics variables in the framework. For example, page views are retrieved from ÃÛ¶¹ÊÓƵ 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 Sites console, select the page you wish to set up with tracking.

  2. Open the Page Properties, either directly from the console, or the page editor.

  3. Open the Cloud Services tab.

  4. Use the Add Configuration drop down to select ÃÛ¶¹ÊÓƵ Analytics from the available options. If inheritance is place you need to disable that before the selector becomes available.

  5. The drop down selector for ÃÛ¶¹ÊÓƵ Analytics will be appended to the options available. Use this to select the required framework configuration.

  6. Select Save & Close.

  7. Publish the page to activate the page and any connected configurations/files.

  8. The final step is to visit the page on the publish instance and search for a keyword (e.g. aubergine) using the Search component.

  9. You can then check the calls made to ÃÛ¶¹ÊÓƵ Analytics using an appropriate tool; for example, ÃÛ¶¹ÊÓƵ Experience Cloud Debugger.

  10. Using the example provided, the call should contain the value entered (i.e. aubergine) in eVar7 and the events list should contain event3.

Page Views page-views

When a page is associated with a ÃÛ¶¹ÊÓƵ 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.

Configuring the Import Interval configuring-the-import-interval

Configure the appropriate instance of the ÃÛ¶¹ÊÓƵ AEM Managed Polling Configuration service:

  • Poll Interval:

    The interval, in seconds, at which the service retrieves page view data from ÃÛ¶¹ÊÓƵ Analytics.

    The default interval is 43200000 ms (12 hours).

  • Enable:

    Enable or disable the service. By default, the service is enabled.

To configure this OSGi service, you can either use the Web Console or an osgiConfig node in the repository (the service PID is com.day.cq.polling.importer.impl.ManagedPollConfigImpl).

Editing ÃÛ¶¹ÊÓƵ Analytics Configurations and/or Frameworks editing-adobe-analytics-configurations-and-or-frameworks

As when creating an ÃÛ¶¹ÊÓƵ Analytics configuration or framework, navigate to the (legacy) Cloud Services screen. Select Show Configurations, then click on the link to the specific configuration you want to update.

When editing an ÃÛ¶¹ÊÓƵ Analytics configuration, you also need to press the Edit button when on the configuration page itself in order to open the Edit Component dialog.

Deleting ÃÛ¶¹ÊÓƵ Analytics Frameworks deleting-adobe-analytics-frameworks

To delete an ÃÛ¶¹ÊÓƵ Analytics framework, first open it for editing.

Then select Delete Framework from the Page tab of the sidekick.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8