Siteimprove Adobe Analytics integration guide

Note: You need to be an Account Owner or Account Administrator to enable the Adobe Analytics integration in the Siteimprove Platform. Only an Adobe user with System Administrator or Product Administrator rights will be able to complete the steps in this guide within Adobe in the Adobe Admin Console and Adobe IO Console. See more details under the User Access Requirements for Setup section. Once integrated it can take up to 24 hours before you can see page views data from Adobe Analytics within the Siteimprove Platform.

The Siteimprove integration to Adobe Analytics (AA) allows AA users to have Traffic Analytics data on page views within the Siteimprove Platform.

If you have Siteimprove Analytics (SA) running on your websites, you can take advantage of Traffic Analytics data without this integration. This integration mostly benefits customers who do not have the Siteimprove Analytics Script running on their website. Learn more in the Siteimprove Traffic Analytics FAQ including information features and filtering crawler bot traffic.

Our Traffic Analytics data shows Page views over the last 30 days throughout the content modules (e.g. SEO, QA, Accessibility) and within the CMS Plugin.

This will supplement the data gathered by Siteimprove and give insights into how issues across your website can be prioritized and addressed.

• User Access Requirements for Setup
• Traffic provider integration
• Setup Connection to Adobe Analytics
  • Adobe Admin Console
    • Create the Product Profile
    • Configure the Product Profile
  • Adobe IO Console
    • Create the Project
    • Configure the API Service
• Connect Adobe Analytics within the Siteimprove platform
• Mapping a site to your data provider
• Confirming Setup
• Where can I see the Traffic Analytics Data?

User Access Requirements for Setup

You need to be an Account Owner or Account Administrator to enable the Adobe Analytics integration in the Siteimprove Platform. 

Only an Adobe user with System Administrator or Product Administrator rights can complete the steps in this guide within Adobe in the Adobe Admin Console and Adobe IO Console. Please see details on the roles and rights gathered from the Adobe's Documentation on this:

• AdminConsole: Create a product profile – System or Product Administrator; 
• AdminConsole: Manage configuration for product profile - System or Product Administrator; 
• AdobeIOConsole: Create project – System or Product Administrator, or Developer; 
• AdobeIOConsole:  Configure API service for project – System or Product Administrator, or Developer 
  • “As an administrator, the Admin Console enables you to create and manage developer accounts. When you add developers to product profiles on the Admin Console, you provide these developers with the access privileges to create integrations (on Adobe I/O). Also, on Adobe I/O, developers can associate the integrations they create with product profiles, but only the product profiles to which the developer has access.”

Traffic provider integration

The Traffic provider setup page is found under Settings > Content > Traffic Analytics data providers. (You can also reach this area via Settings > Integrations > Integrations Overview > Analytics > Adobe Analytics > Manage Traffic Analytics data providers).

Here you see two tabs:

• Integrations - you can connect and view the analytics services.
• Mappings - you can see and edit the Traffic Analytics data provider for each site.
  
  

Follow the steps below to connect to your analytics provider under the "Integrations" tab. Then follow the steps below to map your sites to your data provider under the "Mappings." 

Setup Connection to Adobe Analytics

Metrics from Adobe Analytics are retrieved by Siteimprove using the Adobe Analytics APIs. This section of the guide will take you through the required steps to open up Adobe API access for Siteimprove and provide Siteimprove with the necessary authentication information.  

Adobe Admin Console

An Adobe System Administrator will create and configure a Product Profile to manage Siteimprove’s access to Adobe Analytics 

Create the Product Profile

1. Sign in to https://adminconsole.adobe.com (note: this link opens in a new Tab) and verify that the correct Adobe Organization is selected in the upper right corner.
2. Click into the "Products" area and select the "Adobe Analytics Internal" item in the left menu.
   
   
   
3. Click the blue "New Profile" button on the right side.
   
   
   
4. Type the following Name for the Product Profile: "Siteimprove connection for Adobe Analytics."
5. Provide a Description (optional) then click "Next."
6. Click "Done" on the following screen to complete the Product Profile.
   
   
   

Configure the Product Profile

After clicking "Done" to create the Product Profile, you will be automatically launched into the configuration UI.  

1. Report Suite selection 
   1. Click "Auto Include" toggle which will turn it "On." Note: doing this will also include any report suites created in the future to automatically be accessible to this connector. We recommend this option as it will provide maximum flexibility on any future features and data included in the integration. 
   2. Alternatively, if you want just selected reports to be available, click the "+" icon next to each report suite that should be accessible to the connector. The report suite will then move to the right panel.
      
      
2. Metrics selection 
   1. Move to the Metrics area and click “Auto Include” toggle which will turn it “On”. Note: doing this will also include any metrics created in the future to automatically be accessible to this connector. We recommend this option as it will provide maximum flexibility on any future features and data included in the integration. 
   2. Otherwise, to make just specific metrics available, select the following metrics by clicking on the “+” icon next to each. Tip: use the search feature to quickly find your target metrics.  
      1. Page Views 
      2. Visits
         
         

3. Dimensions selection

   1. Move to the Dimensions area and click “Auto Include” toggle which will turn it “On”. Note: doing this will also include any dimensions created in the future to automatically be accessible to this connector. We recommend this option as it will provide maximum flexibility on any future features and data included in the integration.

   2. Alternatively, select the following dimensions by clicking the “+” icon next to each.  

      1. Page

      2. Page URL
         
         

4. Report Suite Tools selection

   1. Move to the Report Suite Tools area and select the following tools by clicking on the “+” icon next to each.  

      1. Custom Data Warehouse Report
         
         

5. Analytics Tools selection

   1. Move to the Analytics Tools area and select the following tools by clicking on the “+” icon next to each.  

      1. Web Service Access
         
         

6. Click “Save” to complete the configuration process.  

Adobe IO Console

An Adobe System Administrator will create and configure an Adobe IO project to allow API authentication. This IO project will reference the previously created Product Profile.  

Create the Project

1. Sign in to https://console.adobe.io (note: this link opens in a new tab) and verify that the correct Adobe Organization is selected in the upper right corner. 
2. Click “Create new project.”
   
   
3. Click “Edit project.”
   
   
4. Give the project a new title "Siteimprove connector for Adobe Analytics" then click “Save.”
   
   

Configure the API Service

1. Click “Add to project” then choose “API.”
   
   
   
2. Click the “Experience Cloud” filter, then click on “Adobe Analytics,” then click “Next.” If you do not see Adobe Analytics available here, make sure you have all the correct rights as listed in the beginning of this Guide.
   
   
   
3. Click the “Server-to-Server Authentication” option, then click “Next.”
   
   
   
4. Select the OAuth “Server-to-Server” option and name the credentials, then click “Next.”
   
   
   
5. Select “Siteimprove connection for Adobe Analytics,” then click “Save configured API.”
   
   
   
6. You will now see the connected credentials. Click on the “OAuth Server-to-Server” title.
   
   
   
7. Then click the “Retrieve client secret” button as seen below.
   
   
   
8. You will now be able to copy both "Client ID" and "Client Secret" strings – the two values needed to connect Adobe Analytics within the Siteimprove platform in the next steps.
   
   
   

Connect Adobe Analytics within the Siteimprove platform

Enable the connection within Siteimprove by providing the Adobe Client ID and Client Secret gathered from the steps above to Setup the Connection in Adobe Analytics.  

1. In the Siteimprove Platform navigate to Settings > Content > Traffic Analytics data providers. (You can also reach this area via Settings > Integrations > Integrations Overview > Analytics > Adobe Analytics > Manage Traffic Analytics data providers).
2. Click “Connect” in Adobe Analytics line.
   
   
   
3. Place the "Client ID" and "Client Secret" you obtained from Adobe into the corresponding fields and click “Connect.”
   
   
   
4. If the credentials are correct, you will receive a success message and you can proceed to mapping the sites you want to see the data for. 

Mapping a site to your data provider

Once you have connected to your analytics account as outlined above, you can map your sites to your analytics provider.

1. In the Siteimprove Platform navigate to Settings > Content > Traffic Analytics data providers. (You can also reach this area via Settings > Integrations > Integrations Overview > Analytics > Adobe Analytics > Manage Traffic Analytics data providers).
2. Click on the "Mappings" tab.
3. Select the "Edit data provider" icon to the right of the site name.
   
   
   
   
4. Select the provider (e.g. Adobe Analytics) from the drop-down in the modal presented.
   
   
   
5. Click "Save."
6. Select the relevant Account details (Company, Report Suite, and Time zone) to map the site. (Note: the "Refetch Companies" button is a way to update the list of companies available in the dropdown in this screen. Companies are not automatically shown if new entities are added on the Adobe end.)
   
   
   
7. Click "Save" to finalize the mapping.

Confirming Setup

If you have setup the integration and mapped the Adobe Analytics data provider to the relevant sites you should start to see the data in the platform within 24 hours. 

You can confirm whether the data has mapped by checking under Quality Assurance > Inventory > Pages and seeing if the data in the Page View column there has updated to what you are seeing for the last 30 days of data in Adobe Analytics for Page Views. 

If it takes longer than 24 hours, you don't see that the data is matching, or you are not seeing as data coming through as expected for Page Views, please reach out to technical support. There could be issues with the Data Provider Analytics URLs matching with the Crawled URLs that may need configuration adjustments. 

Where can I see the Traffic Analytics Data?

Traffic Analytics data which is presented throughout the platform to help you prioritize which issues to address first. For more information on specifically where it is surfaced throughout the platform please review "Siteimprove Traffic FAQ."