Integrating Adobe Analytics

Metrics for News can easily connect with your Adobe Analytics account to help you analyze story metrics. Please follow the steps below to configure access for Metrics for News.

Estimated time to complete is 15 minutes.

Create a Project in Adobe Analytics for Metrics for News

1. Go to the Adobe Developer Console and log in with your Adobe ID: developer.adobe.com/console/projects.
   
2. Go to the Projects page. 
3. Choose an existing Project or create a new Project.
   1. If creating a Project, we recommend including “Metrics for News” or “MFN” in the title or description of the Project to help you and other staff remember the purpose of this project.
4. Click “Add API” to create a new integration for this Project.
5. On the Add an API page, select “Adobe Analytics."
   1. If the option for “Adobe Analytics” is disabled, you will need to contact your Adobe sales representative to activate it.
6. Click "Next."
   
   
   
   
7. For the Authentication Type,
   1. Select “Server-to-Server Authentication”
   2. Click "Next"
8. On the following Add a server-to-server authentication credential screen,
   1. Select the “OAuth Server-to-Server” option
   2. Enter a custom name for the credential, such as “Metrics for News keys.” 
   3. Click "Next"
9. For the Product Profile options,
   1. Select the “Reports & Analytics Access” option
   2. Click "Save Configured API"

You should be directed to a page with details of your project, including Connected Credentials. We'll need the credentials for the next part of this instruction. For now, please leave this Adobe account window as is and open a new tab or window in your browser for the next section. 

Add the Adobe Project Credentials to Metrics for News

1. Log in to your Metrics for News account.
2. Go to the publication’s Settings page: 
   
   
   1. Click the person icon at the top right of the page and select "Settings."
   2. Under the Content section, select "Publications."
   3. In the list of publications, click "Edit" for the publication you are modifying.  
3. Connect the Adobe data source: 
   
   
   1. Scroll to the Main Analytics Source section.
   2. Ensure "Adobe Analytics" is selected in the Analytics Provider field.
   3. In the Authorize Access to Adobe Analytics Source box, click “Edit.”
      
4. Add or update credentials from an Adobe Project.

1. 1. Under Selected Data Source, check that “Create a new source” is selected. 
   2. Under Name, enter a name for this data source.
   3. Copy the new Client ID from the Adobe Project and paste it here. The ID must be exact.
   4. Copy the new Client Secret from the Adobe Project and paste it here. The Secret must be exact. 
      
2. Validate the Adobe Analytics connection. 
   1. Click “Validate.”
      1. If validation passes, your account settings are ready to be saved.
         
      2. If validation fails, we recommend revisiting the steps above. Contact us if the validation problem persists.
         
   2. Click "Save." Do not close the panel before saving or you may need to re-enter the credentials.
      
3. After saving valid credentials, confirm or select a Report Suite in the Report Suite tab.
   
   
   1. Go to the Report Suite tab. 
   2. Confirm the Report Suite ID selected. 
   3. To select another Report Suite ID, click "Change."
   4. Select an ID from the dropdown menu.
   5. Click "Save."
4. (Optional) Confirm or select custom settings and segments.
    
   1. Go to the ID and Segments tab.  
   2. Confirm the selections. Leaving these fields blank or selecting “Default” or “None” is okay. 
   3. Click "Change" for each field you want to customize. A new window will appear with options to select an ID and save.
5. Click "Save" to save any changes you made.
   1. If the Update Data Source panel doesn't automatically close, click "Close."
6. Verify the new Adobe Analytics connection is saved and valid. 
   1. Back on the Publication settings page, in the Authorize Access to Adobe Analytics Source box, you should now see two green ✅ indicators. 
      
      
      1. ✅ Valid: This means the connection settings for the data source are valid. 
      2. ✅ Secure: This means the connection settings for the data source are secure. 
   2. If the indicator is red 🔴 and says Invalid, this indicates a connection error. Please go over the steps above again. Contact us if this error persists. 
      

Please contact us should you have questions or if issues arise.