Migrate Consent from a Legacy Provider
Transcend allows you to save user consent across websites.
This piece of documentation describes steps to undertake in order to migrate consent preferences from an existing Privacy Provider to Transcend. Going through these steps in sequential order is needed, so that both systems are temporarily in place at the same time, and bridge over the migration period.
airgap needs to be Live on your website before proceeding to the next steps, but
reporting-only should be on as well, so that consent can be synced without any disruption for your users.
Please connect with your Transcend CX contacts if you need any assistance during that process.
The next step to migrate your Consent Management is to ensure that any future user consent updates are synchronized with Transcend.
The following approach will cover both logged in and anonymous users, and will sync whenever a page with airgap loads.
Upon page load, retrieve consent status from your legacy system, anonymous user cookie and/or your legacy consent provider, as well as Transcend, using
airgap.getConsent. If airgap was already used by this user to update consent, this function will return consent information with
confirmed = true. If
confirmed = false, the consent information is merely reflecting your system defaults.
Transcend Consent Management data also contains a timestamp that you can compare to your legacy consent information.
const existingConsentTimestamp = Date.parse(airgap?.getConsent?.()?.timestamp || 0);
Create a list of Consent Preferences from your current consent manager, and share that list with your Transcend CX contact.
The list should be built in CSV format, and structured the following way.
|id||Unique identifier for a user.||String. You can use any unique identifier. Ex. email for identified users, unique id cookie value for anonymous users.|
|essential||Consent status for the |
|functional||Consent status for the |
|analytics||Consent status for the |
|advertising||Consent status for the |
|saleofinfo||Consent status for the |
|confirmed||True if user has confirmed consent preferences.|
|updated||Has the consent been updated (including no-change confirmation) since default resolution.|
|prompted||Whether or not the UI has been shown to the end-user.|
|timestamp||Timestamp of when consent was collected.||ISO 8601 Date. Ex. |
Your Transcend CX contact will import your provided consent data so that your legacy users' preferences are known to Transcend and airgap.
Please allow up to one week for this step to be completed.
At this point, your consent data should be imported into Transcend, and airgap should be collecting new consent updates as well as telemetry data.
You should already be familiar with the overall airgap onboarding process, but don’t hesitate to contact the Transcend CX Team if you have any additional questions.