Adobe Analytics Service Migration 2025

Adobe is migrating a service that impacts the connection between your Adobe Analytics and Metrics for News accounts. Use this guide to complete the migration today.

Adobe is migrating a service that impacts the connection between your Adobe Analytics (AA) and Metrics for News (MFN) accounts. If you use Adobe Analytics to pass data to Metrics for News, then action is required by Adobe’s deadline of June 30, 2025. (Adobe recently extended the deadline; previously the deadline was January 2025.)

Please refer to Adobe’s Migration Guide and Migration FAQs for the most up-to-date information. 

What is the Adobe Analytics migration about? 

Adobe is increasing security on the connection that shares your Analytics projects with your third parties, such as Metrics for News, by deprecating an existing service (Service Account (JWT)) and implementing a new service (OAuth Server-to-Server). 

Please note this migration impacts the connection between your AA projects and the third parties you allow to connect with it. The data within AA or MFN are not impacted. 

All MFN accounts using AA should complete this migration by no later than June 30, 2025 to ensure data continues to flow uninterrupted. Complete the migration now and bring modernized security protocols to your connection. (Adobe recently extended the deadline; previously the deadline was January 2025.)

Who should be involved? 

Adobe Analytics admins and the technical team at your organization who have access to the Adobe Developer Console and project credentials section should be involved. If you are not an admin, then your organization’s admin will need to complete the migration steps, or work with you to complete them. 

Please note that the migration impacts all third-party integrations using AA credentials to connect to your AA account. We can speak only to your integration with MFN, but keep in mind that you will likely need to work with the vendors for any other integrations you may have. 

What do I need to do? 

Estimated time to complete: 15 minutes

Follow the Quick Steps for a shortened version of the steps, or go further down to the Detailed Steps for a version with more details and visuals. Both sets will give you the same results and you need only do one set. 

Please refer to Adobe’s Migration Guide and Migration FAQs for the most up-to-date information.

Quick Steps

Follow these abbreviated steps to complete the migration process. If you run into issues or are interested in deeper explainers, please review the Detailed Steps section. 

1. In your Adobe Analytics account, complete the migration steps provided by Adobe.
2. In Metrics for News, go to the Publication settings page and click "Edit" for the publication you want to modify. 
3. Scroll to the Main Analytics Source section to make sure "Adobe Analytics" is selected.
4. Click "Edit" in the Authorize Access to Adobe Analytics Source box.
5. In the Update Data Source pop-up panel, validate the AA credentials on the Credentials tab.
   1. For an existing AA Project, confirm the credentials are correct. 
   2. For a new AA Project: 
      1. Click the dropdown menu at the top of the panel and select “Create a new source.” 
      2. Give the new set of credentials a name and enter the Client ID and Client Secret. 
   3. Click "Validate" to verify the credentials are accurate and set up correctly. 
   4. Click "Save."
6. Confirm or select an ID on the Report Suite tab. Click "Save." 
7. (Optional) Confirm or select an ID or segments on the ID and Segments tab. Click "Save." 
8. Close the Update Data Source panel. 
9. Back on the Publications settings page, confirm that you can see the green “Valid” and “Secure” indicators. If so, then you are finished! 

You may need to return to Adobe's instructions to finish with any remaining steps they require. 

Detailed Steps

Part 1: Upgrade project in Adobe Account

Follow Adobe’s instructions for your analytics Project first, then continue in Metrics for News for the second part. 

1. Log into your Adobe account.
2. Complete the migration steps provided by Adobe.
   1. If you were able complete the steps using the existing AA Project connected to MFN, then continue with Part 2 below.  
   2. If you found a Project but are unsure whether it is connected to Metrics for News, please go to your Publication’s settings page in MFN to compare the API Key.
   3. If you need to create a new AA Project for MFN:
      1. In AA, create a new Project.
      2. Click “Add API” for the Project.
      3. Select the “Adobe Analytics” API.
      4. For the Authentication Type, select “Server-to-Server Authentication.”
      5. Select the “OAuth Server-to-Server” option
      6. Enter a custom name for the credential, such as “Metrics for News keys.” 
      7. For the Product Profile options, select “Reports & Analytics Access.”

Part 2: Update Adobe Analytics connection in Metrics for News

Now that you have the upgraded credentials configured in Adobe Analytics, you will validate them in Metrics for News. Completing part two will switch and officially migrate the connection to Adobe’s upgrade requirements. We recommend doing this as soon as possible so that your security is up to date.

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. Open the publication’s data source settings: 
   1. Scroll to the Main Analytics Source section and the Authorize Access to Adobe Analytics Source box. 
   2. Click “Edit” to open the analytics source settings.
      
4. In the Update Data Source pop-up panel, review the current credentials.
    
   1. On the Credentials tab, click “Show/Hide” to toggle visibility for the credentials. 
   2. Compare the credentials listed with the credentials in your Adobe Project.
      1. If you are using your existing AA Project connected to MFN, then simply ensure the credentials here match the new set created in the AA Project. Then, skip to step 6. 
      2. If you created a new Project in your Adobe account, go to step 5 to add the new Project’s credentials as a new source. 
5. Add a new data source. Complete this step only if you created a new Project in AA, and are NOT using an existing Project. 
   1. Under Selected Data Source, click to open the dropdown menu and select “Create a new source.” 
   2. Enter a name for this data source.
   3. Copy and paste the new Client ID. The ID must be exact.
   4. Copy and paste the new Client Secret. The Secret must be exact. 
      
6. Validate the Adobe Analytics connection. 
   1. Click “Validate.”
      1. If validation passes, your account migration has been completed. You are now using your new credentials.
         
      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.
      
7. Once the validation is successful, confirm or select an ID in the Report Suite tab.
   
   
   1. Go to the Report Suite tab. 
   2. Confirm the ID selected. 
   3. To select another ID, click "Change."
   4. Select an ID from the dropdown menu.
   5. Click "Save."
8. (Optional) Confirm or select additional IDs and segments.
    
   1. Go to the IDs and Segments tab.  
   2. Confirm the selections. Leaving these fields blank or selecting “Default” or “None” is okay. 
   3. To select another ID or segment, click "Change" for each field.
   4. Select an ID or segment from the dropdown menu.
   5. Click "Save." 
9. Click "Close" to close the Update Data Source panel. Be sure to save any changes you made before closing. 
10. Check for validation. 
    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. 
       

You may need to return to Adobe's instructions to finish with any remaining steps they require. 

You are now using a more secure method for connecting your AA Project to MFN! When Adobe’s deadline arrives, rest assured knowing you have already prepared for it. 

What is the timeline? 

You can complete the steps at any time as long as they are completed by Adobe’s final migration deadline. Complete the migration now and bring modernized security protocols to your connection. 

Does the migration impact my data? 

While the migration itself does not impact the data in AA or MFN, failure to complete the migration steps by Adobe’s deadline may result in a frozen connection that could stop the flow of data between AA and MFN. 

If this happens to your connection, please complete the migration steps as soon as possible. Then submit a ticket or support email for us to import the missing data. 

Will my Adobe integrations or applications stop working immediately after I create the new credentials in AA?

No. Any existing integration or application using the Service Account (JWT) credential will continue to work until Adobe’s deadline. The new OAuth credentials you create will not affect your connection to MFN until you enter them in MFN, at which time MFN will switch from the existing (JWT) to the new (OAuth). 

What happens if we do not migrate our application by Adobe’s deadline? 

According to Adobe: “AA projects on the Developer Console still containing any Service Account (JWT) credentials will be 'frozen' after the deadline. This will disable certificate rotation for your application or any other action to modify the Project or the credential. The ability to migrate will, however, still be available. Once you migrate your application, the Project will be 'unfrozen' again.”

Where can I go with questions? 

For questions regarding the Adobe Analytics portion of the migration, we recommend checking their Migration Guide and Migration FAQs or contacting Adobe support. We are limited on troubleshooting Adobe Analytics. 

Should you have questions or need assistance with the Metrics for News portion of the migration, please send an email to support@metricsfornews.com or submit a ticket and we will respond shortly. 

Thank you for your attention to this vital upgrade!