Getting started with Activity Map
Activity Map in ÃÛ¶¹ÊÓƵ Analytics comprises four main elements:
- Report suite setting: You must enable Activity Map in Report suite settings. When enabled, the report suite creates several reserved variables for Activity Map dimensions and metrics.
- Implementation: Collect Activity Map data on your website or property. Customizing how data is collected can improve the quality and experience of reports.
- Workspace dimensions and metrics: When your implementation is correctly configured, you can use Activity Map dimensions and metrics in Analysis Workspace.
- Overlay: ÃÛ¶¹ÊÓƵ offers a browser extension to view Activity Map data in the context of your website.
Enable report suite setting
A report suite must have Activity Map reporting enabled before you can start collecting data. If your implementation sends Activity Map data to a report suite without Activity Map reporting enabled, Activity Map data is not included in the hit.
Admin > Report suites > Select report suite > Edit settings > Activity Map > Activity Map reporting > Enable Activity Map Reports
Enabling Activity Map reports creates several backend reserved variables. See Activity Map Reporting in the ÃÛ¶¹ÊÓƵ Analytics admin guide for more information.
Code installation
Your implementation must be correctly configured to send Activity Map data to ÃÛ¶¹ÊÓƵ.
Activity Map data collection requires the ÃÛ¶¹ÊÓƵ Experience Platform Web SDK extension v2.23 or later. Extension versions down to v2.16 have limited support. These previous extension versions send Activity Map data in a separate event from the rest of your data. This extra event increases the number of hits that you send to ÃÛ¶¹ÊÓƵ Analytics or ÃÛ¶¹ÊÓƵ Experience Platform.
The Click data collection configuration setting handles Activity Map data collection and is typically enabled by default. You can check to make sure that it is enabled in the extension’s configuration settings:
- Log in to
- Select Data Collection in the quick access menu or the product selector in the top right.
- Select Tags in the left navigation menu.
- Select the desired tag to edit.
- Select Extensions in the left navigation menu.
- Select ÃÛ¶¹ÊÓƵ Experience Platform Web SDK in the list of installed extensions, then select Configure on the right.
- Locate the section labeled Data Collection and make sure that the check box Enable click data collection is enabled.
- Select Save.
- If needed, build your changes to a library and publish your changes to production.
See Configure the Web SDK tag extension for more information.
alloy.js
)Activity Map data collection requires the Web SDK JavaScript library v2.20 or later. Library versions down to v2.15 have limited support. These previous library versions send Activity Map data in a separate event from the rest of your data. This extra event increases the number of hits that you send to ÃÛ¶¹ÊÓƵ Analytics or ÃÛ¶¹ÊÓƵ Experience Platform.
The Web SDK configuration variable clickCollectionEnabled
handles the automatic collection of Activity Map data. It is enabled by default unless explicitly disabled.
code language-js |
---|
|
The Use Activity Map configuration setting handles Activity Map data collection and is typically enabled by default. It is available for all tag extensions v1.9.0 or later. You can check to make sure that it is enabled in the extension’s configuration settings:
- Log in to
- Select Data Collection in the quick access menu or the product selector in the top right.
- Select Tags in the left navigation menu.
- Select the desired tag to edit.
- Select Extensions in the left navigation menu.
- Select ÃÛ¶¹ÊÓƵ Analytics in the list of installed extensions, then select Configure on the right.
- Make sure that the check box Use Activity Map is enabled.
- Select Save.
- If needed, build your changes to a library and publish your changes to production.
See the ÃÛ¶¹ÊÓƵ Analytics extension overview for more information.
AppMeasurement.js
)The Activity Map module handles Activity Map data collection, and is included with all AppMeasurement libraries v1.6 or later. You can inspect the AppMeasurement.js
file to make sure that it is included.
- Navigate to the on GitHub.
- Download the compressed AppMeasurement library file, then open
AppMeasurement.js
contained inside. - The Activity Map module is included near the top of this file. Make sure that this module is included in the AppMeasurement library that your site uses.
Available dimensions
When Activity Map is enabled for both your report suite and implementation, you can begin using the following dimensions in Analysis Workspace:
Download and install the browser extension or add-on
In addition to the dimensions available in Analysis Workspace, you can also view Activity Map data as an overlay on your website. To view this overlay, download and install the Activity Map browser extension or add-on.
Tools > Activity Map > Download Activity Map
This link takes you to your browser’s supported extension or add-on marketplace where you can install it. Once installed, the extension or add-on appears in the top right of your browser where you can sign in and enable the overlay.