Gestione del consenso
L'SDK fornisce un metodo setConsent() per aggiornare lo stato del consenso in qualsiasi momento. I segnali di consenso vengono mappati nel formato Google Consent Mode v2 e inclusi in ogni payload dell'evento.
API setConsent()
// 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 })Campi di ConsentInput
| Campo | Tipo | Predefinito | Descrizione |
|---|---|---|---|
analytics | boolean | true | Consenti il tracciamento analitico |
marketing | boolean | true | Consenti il tracciamento marketing/pubblicitario |
Mappatura GCM v2
L'SDK mappa il tuo input di consenso ai segnali Google Consent Mode v2:
| ConsentInput | Segnale GCM v2 |
|---|---|
analytics | analytics_storage |
marketing | ad_storage |
marketing | ad_user_data |
marketing | ad_personalization |
Consenso predefinito (negato per impostazione predefinita)
Per impostazione predefinita, sia analytics che marketing sono true. Per le regioni conformi al GDPR, inizializza con il consenso negato:
const converlay = createConverlay({
shopDomain: 'my-store.myshopify.com',
consent: {
analytics: false,
marketing: false,
},
})Gli eventi vengono comunque inviati
L'SDK invia gli eventi indipendentemente dallo stato del consenso. I segnali di consenso sono inclusi nel payload e il server di Converlay li utilizza per decidere quali destinazioni ricevono ogni evento. Questo garantisce che gli eventi possano essere memorizzati e inoltrati una volta concesso il consenso.
Customer Privacy API di Shopify
Se la tua storefront headless utilizza la Customer Privacy API di Shopify, puoi sincronizzare le modifiche del consenso direttamente:
// 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,
})
}
)
}Gestori di consenso di terze parti
Per gestori di consenso come OneTrust, Cookiebot o simili:
// OneTrust example
window.OptanonWrapper = () => {
const groups = window.OnetrustActiveGroups || ''
converlay.setConsent({
analytics: groups.includes('C0002'),
marketing: groups.includes('C0004'),
})
}