Migrate to a custom domain (CDDC)

 

Introduction

You wish to migrate your site to a custom domain (Custom Domain Data Collection – CDDC), and must therefore update your tag to collect on this new domain, during the authorized migration period (7 days).

This migration must be done during the 7-day period allowed for migration, during which we collect on both domains. After this period, any hit sent on the old domain will be lost.

With a custom domain, you also have the ability to change the pixel path (/hit.xiti by default), in order to further customize your data collection.

 

Planning migration

Migration planning is done via the interface of site management. When editing a site, if a custom domain is available, you will be offered to migrate. You will then have to choose a migration start date, from which a 7-day period will be automatically determined. You will then have to migrate the tagging during this period, otherwise the data would not be collected.

 

With CDN

If you use the Internet CDN AT, simply update the file via TagComposer, and you will then automatically switch to your new collection domain.

This update must be done during the migration period to ensure that it contains the correct information.

 

With a local file

If you are using a file hosted locally on your server, you will need to download a new version of the file from TagComposer, and replace the file in question with the new one.

This download must be done during the migration period to ensure that it contains the correct information.

 

Without updating the smarttag.js file

It is also possible to migrate without updating the file, via a modification of the tracker instantiation.

 

Version up to 5.12.1

Until version 5.12.1, the configurations log, logSSL and domain can be used to migrate to a custom domain.
You will then have to split your customized collection domain like this:

Technically, a concatenation by a point is made between log and domain, and between logSSL and domain.

To be noted:

  • The non secure domain and the SSL domain are the same
  • The pixel path pixelPath must start with /
 

Version 5.13.0+

Since version 5.13.0, the configurations log, logSSL and domain have been replaced by collectDomain and collectDomainSSL.

Old configurations remain available for backwards compatibility

If you are using version 5.13.0 or later, you just need to initialize your tracker like this:

To be noted:

  • The non secure domain and the SSL domain are the same
  • The pixel path pixelPath must start with /

 

Was this post helpful?
Yes
No
Last update: 12/10/2018