UniConsent

Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

Get Started

Come funziona la Shopify Customer Privacy API

La Shopify Customer Privacy API aiuta i merchant a rispettare normative sulla privacy come il GDPR e il CCPA, consentendo alle app e ai servizi di terze parti (come Meta Pixel, Google Ads e altri script di tracciamento) di rispettare il consenso degli utenti.

Con questa API, il tuo codice JavaScript può verificare lo stato del consenso di un visitatore prima di caricare tag di tracciamento o di marketing.

Come impostare lo stato del consenso con la Shopify Customer Privacy API

Se stai integrando una Consent Management Platform (CMP) o creando un'esperienza di consenso personalizzata, puoi utilizzare il metodo setTrackingConsent() per aggiornare in modo programmatico le preferenze di consenso di un cliente.

Questo metodo deve essere utilizzato solo da CMP autorizzate o dopo aver ricevuto il consenso esplicito dell'utente. Non è pensato per sovrascrivere le decisioni prese dall'utente tramite il banner nativo di Shopify o tramite CMP esterne.

Esempio: impostare lo stato del consenso

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

Come verificare lo stato del consenso con la Shopify Customer Privacy API

Utilizza il codice seguente per caricare l'API e accedere alle preferenze di consenso del visitatore:

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

Assicurati di inserire la tua logica all'interno della callback, poiché l'API è disponibile solo quando è stata caricata completamente.

Esempio di output

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

Categorie di consenso

L'API restituisce lo stato del consenso per le seguenti categorie:

  • analytics
  • marketing
  • preferences
  • sale_of_data

Ogni categoria restituisce 'yes' o 'no', consentendoti di caricare o bloccare in modo condizionale gli script di terze parti in base alle preferenze dell'utente.

La categoria essential è sempre attiva in Shopify e non può essere disattivata.