Gestion du consentement

Le SDK fournit une méthode setConsent() pour mettre à jour l'état du consentement à tout moment. Les signaux de consentement sont mappés au format Google Consent Mode v2 et inclus dans chaque payload d'événement.

API setConsent()

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 })

Champs ConsentInput

Champ	Type	Par défaut	Description
`analytics`	`boolean`	`true`	Autoriser le suivi analytique
`marketing`	`boolean`	`true`	Autoriser le suivi marketing/publicitaire

Mapping GCM v2

Le SDK mappe vos entrées de consentement vers les signaux Google Consent Mode v2 :

ConsentInput	Signal GCM v2
`analytics`	`analytics_storage`
`marketing`	`ad_storage`
`marketing`	`ad_user_data`
`marketing`	`ad_personalization`

Consentement par défaut (refusé par défaut)

Par défaut, analytics et marketing sont à true. Pour les régions soumises au RGPD, initialisez avec le consentement refusé :

Deny by default

const converlay = createConverlay({
  shopDomain: 'my-store.myshopify.com',
  consent: {
    analytics: false,
    marketing: false,
  },
})

Les événements sont toujours envoyés

Le SDK envoie les événements quel que soit l'état du consentement. Les signaux de consentement sont inclus dans le payload, et le serveur Converlay les utilise pour décider quelles destinations reçoivent chaque événement. Cela garantit que les événements peuvent être mis en mémoire tampon et transférés une fois le consentement accordé.

API Customer Privacy de Shopify

Si votre storefront headless utilise l'API Customer Privacy de Shopify, vous pouvez synchroniser les changements de consentement directement :

Shopify integration

// 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,
      })
    }
  )
}

Gestionnaires de consentement tiers

Pour les gestionnaires de consentement comme OneTrust, Cookiebot ou similaires :

OneTrust example

// OneTrust example
window.OptanonWrapper = () => {
  const groups = window.OnetrustActiveGroups || ''
  converlay.setConsent({
    analytics: groups.includes('C0002'),
    marketing: groups.includes('C0004'),
  })
}

Précédent← Identification des utilisateurs SuivantIntégration React →