Visitor migration

Last update: 2023-04-12
  • Created for:
  • User

If you have already implemented Experience Cloud Visitor ID Service then Grace Period is not applicable for you and should not be enabled.

Visitor migration is a process where the visitor ID cookie(s_vi) is migrated from one domain to another.

Visitor migration lets you preserve visitor identification cookies when changing data collection domains. Data collection domains might change for the following reasons:

  • Moving from to

  • You are implementing the Experience Cloud Visitor ID Service and are moving from a CNAME/first-party data collection domain to, or

  • Moving to a cname/first-party data collection ( First-Party Cookies).

  • Moving from one CNAME to another (changing domains).

After visitor migration is configured, when a user visits the new domain without a visitor ID cookie, the server redirects to the previous data collection hostname, retrieves any available visitor ID cookies, and then redirects back to the new domain. If a Visitor ID is not found on the previous hostname, a new ID is generated. This occurs only once per visitor.

Visitor Migration Process

The following table lists the tasks required for visitor migration:

Task Description

To get started: Contact Customer Care with the domain(s) you want to migrate, and the migration period you would like to enable (30, 60, or 90 days). Make sure that you include the non-secure and secure domains.

Create a list with the exact syntax for the domains you want to migrate to and migrate from.

  • >
  • >

The migration host names are configured on Adobe Data collection server. Customer Care will let you know when the change is made so you can plan for the next step.

6+ hours after configuration change: Update the s.trackingServer and s.trackingServerSecure variables in your Analytics JavaScript code to use the new data collection servers.

After you make this change, use the Experience Cloud debugger to verify that the Analytics image request is going to the updated data collection server.

Immediately after updating your Analytics code: Test your site to verify that the redirect to the previous data collection domain is occurring.

Use a packet monitor to verify that when you access your site for the first time, or after clearing cookies, you see two 302 (redirect) HTTP status codes before the 200 (OK) HTTP status code. If any of these redirects fail, contact Customer Care immediately to ensure that the migration is configured correctly.

For the entire migration period: Keep the DNS record for the previous hostname active.

The previous hostname must resolve through DNS or the cookie migration will not occur.

On this page