Einwilligungsverwaltung
Das SDK bietet eine setConsent()-Methode, um den Einwilligungsstatus jederzeit zu aktualisieren. Einwilligungssignale werden in das Google Consent Mode v2-Format abgebildet und in jedem Event-Payload mitgesendet.
setConsent()-API
// Grant both analytics and marketing
converlay.setConsent({ analytics: true, marketing: true })
// Deny marketing (e.g., user declines cookie banner)
converlay.setConsent({ analytics: true, marketing: false })
// Update a single signal without affecting the other
converlay.setConsent({ marketing: false })ConsentInput-Felder
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
analytics | boolean | true | Analytics-Tracking erlauben |
marketing | boolean | true | Marketing-/Werbe-Tracking erlauben |
GCM v2-Zuordnung
Das SDK bildet Ihre Einwilligungseingabe auf Google Consent Mode v2-Signale ab:
| ConsentInput | GCM v2-Signal |
|---|---|
analytics | analytics_storage |
marketing | ad_storage |
marketing | ad_user_data |
marketing | ad_personalization |
Standard-Einwilligung (standardmäßig abgelehnt)
Standardmäßig sind analytics und marketing auf true gesetzt. Für DSGVO-konforme Regionen initialisieren Sie mit abgelehnter Einwilligung:
const converlay = createConverlay({
shopDomain: 'my-store.myshopify.com',
consent: {
analytics: false,
marketing: false,
},
})Events werden weiterhin gesendet
Das SDK sendet Events unabhängig vom Einwilligungsstatus. Einwilligungssignale sind im Payload enthalten, und Converlays Server nutzt sie, um zu entscheiden, welche Ziele jedes Event erhalten. So können Events gepuffert und nach Erteilung der Einwilligung weitergeleitet werden.
Shopify Customer Privacy API
Wenn Ihre Headless-Storefront Shopifys Customer Privacy API verwendet, können Sie Einwilligungsänderungen direkt synchronisieren:
// Listen for Shopify Customer Privacy API consent changes
if (window.Shopify?.customerPrivacy) {
window.Shopify.customerPrivacy.subscribe(
'visitorConsentCollected',
(event) => {
converlay.setConsent({
analytics: event.analyticsAllowed,
marketing: event.marketingAllowed,
})
}
)
}Drittanbieter-Consent-Manager
Für Consent-Manager wie OneTrust, Cookiebot oder ähnliche:
// OneTrust example
window.OptanonWrapper = () => {
const groups = window.OnetrustActiveGroups || ''
converlay.setConsent({
analytics: groups.includes('C0002'),
marketing: groups.includes('C0004'),
})
}