Share consents across devices

Search…
Introduction
The Didomi CMP supports syncing to allow consent sharing across devices and environments. Consent can be shared between all environments that have syncing enabled in the same organization: multiple websites, multiple apps (same or multiple devices), multiple websites and apps together, etc.
When syncing is enabled and an organization user ID is available, the Didomi CMP will load the previously stored user choices from the Consents API and will apply them locally.
Syncing is currently in beta. Please reach out to our Support team ([email protected]) to enable the feature for your account.
Configuration
Setting user organization ID
For the sync process to work properly, an User Organization Id property needs to be set before the Didomi initialization:
Java
Kotlin
Swift
Objective-C
Dart
1
Didomi.getInstance().setUser("organization-user-id");
Copied!
1
Didomi.getInstance().setUser("organization-user-id")
Copied!
1
Didomi.shared.setUser(id: "organization-user-id")
Copied!
1
Didomi *didomi = [Didomi shared];
2
[didomi setUserWithId:@"organization-user-id"];
Copied!
1
await DidomiSdk.setUser("organization-user-id");
Copied!
This value represents the unique identifier with which the organization identifies the user for which it wants to sync the consents. This can be an email address, a user ID, etc. We recommend hashing the value to not communicate plain user IDs to Didomi.
Enabling sync
The sync process can be enabled with async.enabled configuration option in the Didomi configuration:
1
{
2
    "app": {
3
        ...
4
    },
5
    "sync": {
6
        "enabled": true
7
    }
8
}
Copied!
Behavior
Sync timeout
The maximum time allowed for the syncing process to be completed can be specified with a sync.timeout configuration option in the Didomi configuration:
1
{
2
    "app": {
3
        ...
4
    },
5
    "sync": {
6
        "enabled": true,
7
        "timeout": 2000
8
    }
9
}
Copied!
The sync.timeout configuration option accepts an integer which represents the maximum time allowed (in milliseconds) for the syncing process to be completed.
If the syncing process takes more time to be completed than it is specified in sync.timeout configuration option, the initialization continues as if there was no data to sync.
Delaying notice showing
The Didomi CMP enables delaying notice showing while the sync is in progress. This ensures that the user never sees the consent notice if sync is possible.
The sync.delayNotice configuration option can be used for delaying the notice showing until the sync is complete:
1
{
2
    "app": {
3
        ...
4
    },
5
    "sync": {
6
        "enabled": true,
7
        "delayNotice": true
8
    }
9
}
Copied!
Third-party SDKs
Share consent with WebViews
Last modified 2mo ago
Copy link
Contents
Introduction
Configuration
Setting user organization ID
Enabling sync
Behavior
Sync timeout
Delaying notice showing