Comment fonctionne la Shopify Customer Privacy API

La Shopify Customer Privacy API aide les marchands à se conformer aux réglementations sur la vie privée telles que le RGPD et le CCPA, en permettant aux applications et services tiers (comme Meta Pixel, Google Ads et d'autres scripts de suivi) de respecter le consentement des utilisateurs.

Grâce à cette API, votre code JavaScript peut vérifier le statut de consentement d'un visiteur avant de charger des balises de suivi ou de marketing.

Comment définir le statut de consentement avec la Shopify Customer Privacy API

Si vous intégrez une plateforme de gestion du consentement (CMP) ou créez une expérience de consentement personnalisée, vous pouvez utiliser la méthode setTrackingConsent() pour mettre à jour de manière programmatique les préférences de consentement d'un client.

Cette méthode ne doit être utilisée que par des CMP autorisées ou après avoir obtenu le consentement explicite de l'utilisateur. Elle n'est pas destinée à remplacer les décisions prises par l'utilisateur via la bannière native de Shopify ou des CMP externes.

Exemple : Définir le statut de consentement

Shopify.loadFeatures(
  [
    {
      name: 'consent-tracking-api',
      version: '0.1',
    },
  ],
  (error) => {
    if (error) {
      console.error('Failed to load consent-tracking-api:', error);
      return;
    }

    // Set consent status after the user agrees (e.g., via custom CMP UI)
    Shopify.customerPrivacy.setTrackingConsent({
      marketing: true,
      analytics: true,
      preferences: true,
    });
  }
);

Comment vérifier le statut de consentement avec la Shopify Customer Privacy API

Utilisez le code suivant pour charger l'API et accéder aux préférences de consentement du visiteur :

window.Shopify.loadFeatures(
  [
    {
      name: 'consent-tracking-api',
      version: '0.1',
    },
  ],
  (error) => {
    if (error) {
      // Handle loading error
      return;
    }

    // API is ready—check visitor consent
    const consent = window.Shopify.customerPrivacy.currentVisitorConsent();
    console.log(consent);
  }
);

Veillez à placer votre logique dans le callback, car l'API n'est disponible qu'une fois entièrement chargée.

Exemple de sortie

{
  "marketing": "yes",
  "analytics": "yes",
  "preferences": "yes",
  "sale_of_data": "no"
}

Catégories de consentement

L'API renvoie le statut de consentement pour les catégories suivantes :

  • analytics
  • marketing
  • preferences
  • sale_of_data

Chaque catégorie renvoie 'yes' ou 'no', vous permettant de charger ou bloquer conditionnellement les scripts tiers en fonction des préférences de l'utilisateur.

essential est toujours activé par Shopify et ne peut pas être désactivé.