Adobe Analytics extension overview

Use this reference for information about configuring the Adobe Analytics extension, and the options available when using this extension to build a rule.

Configure the Adobe Analytics extension

This section provides a reference for the options available when configuring the Adobe Analytics extension.

If the Adobe Analytics extension is not yet installed, open your property, then select Extensions > Catalog, hover over the Adobe Analytics extension, and select Install.

To configure the extension, open the Extensions tab, hover over the extension, and then select Configure.

Library Management

Select an option from the Library Management section of the configuration page. The following configuration options are available:

Manage the library for me

Report Suites

Specify one or more report suites for each of the following environments:

Use the library already installed on the page

Set the following report suites on tracker

If you select this option, specify one or more report suites for each of the following environments:

Using the activity map module

The activity map is loaded as a separate module (like the AAM module). By default activity map is turned on, but if you would prefer to turn it off you can do so by unchecking the box in the configuration.

Tracker is accessible on the global variable named

Checking this box allows the tracker object to be used globally. For example, you could define the variable window.s.pageName anywhere on your site.

Load the library from a custom URL

HTTP URL

Specify the URL where the library is located.

HTTPS URL

Specify the URL where the library is located.

Set the following report suites on tracker

If you select this option, specify one or more report suites for each of the following environments:

Tracker is accessible on the global variable named

Specify the tracker object to be used globally.

Let me provide custom library code

Open Editor

Lets you insert core AppMeasurement.js code. This code is populated automatically when using the automatic configuration method.

Set the following report suites on tracker

If you select this option, specify one or more report suites for each of the following environments:

Tracker is accessible on the global variable named

Specify the tracker object to be used globally.

General

Select an option from the General section of the configuration page. The following configuration options are available:

Enable EU compliance for Adobe Analytics

Enables or disables tracking based on the EU privacy cookie.

When you check the EU Compliance check box, the Tracking Cookie Name field appears. The Tracking Cookie overrides the default tracking cookie name. You can customize the name that tags uses to track your opt-out status for receiving other cookies.

When a page is loaded, the system checks to see if a cookie called sat_track is set (or the custom cookie name specified on the Edit Property page). Consider the following information:

You are responsible for setting the sat_track (or custom named) cookie to false if a visitor opts out. You can accomplish this using custom code:

_satellite.cookie.set("sat_track", "false");

You must also have a mechanism to set that cookie to true if you want a visitor to be able to opt in later:

_satellite.cookie.set("sat_track", "true");

Character Set

Determines how the image request is encoded. If your implementation or site uses non-ASCII characters, it is important to define character set here. You can select a preset character set or specify a custom character set. Adobe recommends using the same character coding as your site. Typically this value is UTF-8.

Character Set can be set in Analytics custom code using the variable s.charSet.
For more information about character sets, see the charSet documentation.

Currency Code

Determines the conversion rate to be applied to revenue and currency events. If your site allows visitors to purchase in multiple currencies, setting the currency code ensures the monetary amount is converted and stored correctly.

For more information about the supported currency codes, see currencyCode.

Tracking Server

Used for first-party cookie implementations to dictate where the first-party cookie is stored. If you use the Experience Cloud ID Service, Adobe advises against populating this field.

Tracking Server can be set in Analytics custom code using the variable s.trackingServer.

See trackingServer in the Adobe Analytics Implementation guide.

SSL Tracking Server

Used for SSL first-party cookie implementations to dictate where the first-party cookie is stored. If you use the Experience Cloud ID Service, Adobe advises against populating this field. If not defined, SSL data uses Tracking Server.

SSL Tracking Server can be set in Analytics custom code using the variable s.trackingServerSecure.

See trackingServerSecure.

Global Variables

Use this section to set up eVars and Props, and to create hierarchies.

Global variables are variables that are set on the Analytics tracking object when that object is initialized on the page. Any variables you set here will be set when the tracking object is created on each page. Once these variables are set, they are just like any other variables set any other way. Specifically, this means that a rule can modify, change, or clear these variables.

If your web application typically sends one beacon per page, this section can help make it simple to set your variables in one place. If your application sends more than one beacon per page (such as in a single-page application), and you need to clear your variables and reset them using the same tracking object, it is simpler to rely on rules to set and clear your variables.

Link Tracking

Select an option from the Link Tracking section of the configuration page. The following configuration options are available:

Enable ClickMap

ClickMap is a plug-in for Internet Explorer and Firefox, and a module of Reports & Analytics.

Track download links

Tracks links to downloadable files on your site.

See s.trackDownLoadLinks.

Download Extensions

If the Track Download Links option is enabled, you can select the extensions of file links that are included in the Downloads Report If your site contains links to files with any of the listed extensions, the URLs of these links will appear in reporting.

See s.linkDownloadFileTypes.

Track outbound links

Determines whether any selected link is an exit link.

See s.trackExternalLinks.

Single-Page App Considerations: Because of the way some SPA websites are coded, an internal link to a page on the SPA site might look like it is an outbound link.

You can use one of the following methods to track outbound links from SPA sites:

For example, if you have a spa/#/about page, you could put “about” in the Always Track section.

The “about” page is the only outbound link that is tracked. Any other links on the page (for example, https://www.google.com) are not tracked.

Keep URL Parameters

Preserves query strings.

See s.linkLeaveQueryString.

Cookies

Configure field descriptions for the Cookies global settings used for deploying the Adobe Analytics extension. The following configuration options are available:

Visitor ID

Unique value that represents a customer in both the online and offline systems.

See visitorID.

Visitor Namespace

Variable to identify the domain with which cookies are set.

See visitorNamespace.

Domain Periods

The domain on which the Analytics cookie s_cc and s_sq are set by determining the number of periods in the domain of the page URL. This variable is also used by some plug-ins in determining the correct domain to set the plug-in’s cookie.

See s.cookieDomainPeriods.

First-Party Domain Periods

The fpCookieDomainPeriods variable is for cookies set by JavaScript (s_sq, s_cc, plug-ins) that are inherently first-party cookies, even if your implementation uses the third-party 2o7.net or omtrdc.net domains.

See s.fpCookieDomainPeriods.

Cookie Lifetime

Determines the life span of a cookie.

See s.cookieLifetime.

Secure Cookies

This variable allows AppMeasurement to write secure cookies.

See writeSecureCookies

Customize Page Code

Use the editor to customize your page code.

Adobe Audience Manager

Use this section of the extension configuration to specify how Audience Manager works with Analytics.

Enable Automatically share Analytics data with Audience Manager.

The following options appear:

The Audience Manager subdomain is assigned by Adobe Audience Manager. It is sometimes referred to as your “Partner Name” or “Partner Subdomain.” Contact your Adobe consultant or Customer Care if you do not know your Partner Name.

You can configure advanced settings by selecting Show advanced settings and entering your preferences.

For information about each setting, select the info icon, or refer to the Adobe Audience Manager documentation.

Analytics extension action types

This section describes the action types available in the Analytics extension.

The Analytics extension provides the following actions:

Set Variables set-variables

Important: Using a “set variables” action won’t send the beacon. You must use the “send beacon” action.

eVars

Set one or more eVars.

Props

Set one or more props.

Events

Set one or more events.

Hierarchy

Set the Analytics Hierarchy variable.

Specify each level in the hierarchy.

If desired, configure additional hierarchies.

Page name

This value refers to the name of a given page, and corresponds to the pageName variable in Analytics.

Other information

Specify other information used by your pages.

These settings include:

These settings can be found in the “Global Variables” menu by selecting the “Additional Settings” checkbox.

Custom Page Code

Description

Use the editor to specify your custom page code.

Settings

Send Beacon send-beacon

Increment a pageview - s.t()

Select if you want to increment a pageview.

Do not increment a pageview - s.tl()

Select if you do not want to increment a pageview.

Settings

Clear Variables clear-variables

There are no configuration options if the Clear Variables action type is selected.