Migrating Users from Adobe ID to Fed ID

Description description

Environment

  • Customer Journey Analytics
  • Analytics

Issue/Symptoms

How to migrate a User from Adobe ID to Fed ID and also changing the domain name.

For example - User@olddomain.com (Adobe ID) to User@newdomain.com (Fed ID)

Note: The same process can be followed, if the customer is looking to change the domain name from one Adobe ID to another Adobe ID. Ensure that Adobe ID is selected in all the steps mentioned below.

For example - User@olddomain.com (Adobe ID) to User@newdomain.com (Adobe ID)

Resolution resolution

Steps to be followed:

  1. Obtain a backup of current users and their product profiles

    1. Go to the Experience Cloud Admin Console - Users tab.
    2. Click on 3 dots and select “Export users list to CSV”.
  2. Unlink Adobe Analytics user accounts with Experience Cloud Admin Console accounts

    1. This can be done by simply deleting the user account from the Experience Cloud Admin Console.
    2. Go to the Experience Cloud Admin Console - Users tab.
    3. Either use the “Remove users by CSV” option using 3 dots or just select the user and click “Remove User”.
  3. Upload new users as Federated ID without Analytics product profiles

    1. Go to the Experience Cloud Admin Console - Users tab.

    2. Click “Add users by CSV” and download the standard template.

    3. Populate the following fields only:

      1. Identity Type
      2. Username
      3. Domain
      4. Email
      5. First Name
      6. Last Name
      7. Country Code
    4. You can take the help of the reference backup file (from 1) for information like First Name, Last Name and Country Code

    5. Ensure that Identity Type is Federated ID, Username, Domain, Email are all updated as per the updated Federated ID user detail.

    6. Upload the file.

  4. Update the email address of the Analytics user account

    1. Go to Analytics - Admin - Analytics users & assets.
    2. The Analytics user account corresponding to the removed Experience Cloud user account (as done in 2) will show “Not Initiated” as the Migration status.
    3. Click the user account and update the email address and save the changes. Like User@olddomain.com was updated to User@newdomain.com for the “UserID” Analytics user account.
  5. Upload Analytics product profiles to the uploaded Federated ID users in (3)

    1. Let’s do a bulk upload.
    2. Go to the Experience Cloud Admin Console - Users tab.
    3. Click on 3 dots and “Edit user details by CSV”.
    4. Use the file from (3) and update the required details.
    5. For information on “Product Configurations and other columns” use the file from (1).
    6. Ensure that the column “ID” is empty.
    7. Verify ad validate the details of other columns.
    8. Upload the file.

This will change the email address of the user, update the identity type of the user to the Federated ID and link it to the existing Analytics user account (while retaining all the assets).

Considerations:

  1. It’s advisable to complete it in batches rather than doing it all at once.
  2. Also, if the Analytics user ID is using the email address, the user ID can’t be changed – it will continue to show the old email address through the email address and other things will change and work as expected.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f