Adobe has developed Excel tools that help you monitor the health of your organization's Analytics implementation.
- The Analytics Health Dashboard dives deep into a single report suite and provides a view into data collected in every component (eVar, prop, and event). This can help point out if data has stopped collecting into a component so you can take action to correct the issue.
- The Marathon Dashboard runs across all report suites in your organization and reports on component settings to help you ensure you are measuring consistently cross-suite.
The dashboards are maintained by Adobe Consulting. For assistance beyond the content of this page, please reach out to your Adobe Customer Success Manager (CSM) to request consulting support.
Where can I find the latest versions?
Adobe is constantly evolving these tools to meet additional use cases & needs of our customers. To ensure you have the latest version, click below:
Using the Dashboards
Auditing happens both upstream on inbound data collection and downstream once report suites have been implemented. Here's where Adobe sees these dashboards fitting into your process:
- Upstream Audit: Debugging tools, like Adobe Experience Cloud debugger, can help ensure data is sound upon ingest. However, these tools typically do not reflect processing that occurs after the hit is collected.
- Downstream Audit: The Analytics Health & Marathon Dashboards aide in conducting an exhaustive audit of the health of your components (eVars, props, and events) after all hit processing has been completed. They give an accurate depiction of the data you will see in Adobe reporting UIs, e.g. Analysis Workspace, Report Builder, etc.
Customers use these dashboards in many ways; some run the dashboards the day after releases, while others run them once a week/month to keep a pulse on collected data.
Typical data collection & auditing workflow
The dashboards can be run on Windows machines and Macs that run VMWare Fusion. They need to be run with Excel 2013 (32-bit or 64-bit) or later in order to have the correct VBA plug-in libraries.
To use the the dashboards, you need access to Adobe's Analytics APIs. If you do not have the access outlined below, please reach out to an Adobe Analytics administrator at your organization.
Analytics Health Dashboard
To use the Analytics Health Dashboard v3.0+, you need 1) an Experience Cloud login with System Admin OR Developer access, and 2) Adobe I/O OAuth credentials established to connect to the 2.0 Analytics API. Read more about the 2.0 API, and watch this video on how to establish OAuth credentials.
In cases where your browser does not return JWT token when you attempt to authenticate, there is an option to manually generate a JWT Token and use it to run the Analytics Health Dashboard. The steps to do so are as follows:
- Obtain the Client ID and Client Secret from console.adobe.io for the project that was setup for your AHD integration.
- Navigate to the Adobe OAuth 2.0 Playground
- Enter your Client ID and Client Secret. For Scopes, enter: openid,AdobeID,read_organizations,additional_info.job_function,additional_info.projectedProductContext
- Click “Generate”, and copy the value for the Access Token on the Tokens tab.
- Within the Health Dashboard, select the Developer menu, then open Macros.
- Run the displayManualAuthTokenForm macro, and paste the playground token into the form. Upon clicking “Save”, the AHD will proceed with retrieving your login company credentials – at which point you can run the dashboard normally.
To use the Marathon dashboard (and Analytics Health Dashboards prior to v3.0), you need to have a Web Services API 1.4 user name & shared secret.