UniConsent

Leading Consent Management Platform

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

Get Started

Wie die Shopify Customer Privacy API funktioniert

Die Shopify Customer Privacy API hilft Händlern, Datenschutzvorschriften wie GDPR und CCPA einzuhalten, indem sie es Apps und Drittanbieter-Diensten (wie Meta Pixel, Google Ads und anderen Tracking-Skripten) ermöglicht, die Einwilligung der Nutzer zu respektieren.

Mit dieser API kann Ihr JavaScript-Code den Einwilligungsstatus eines Besuchers prüfen, bevor Tracking- oder Marketing-Tags geladen werden.

Einwilligungsstatus mit der Shopify Customer Privacy API setzen

Wenn Sie eine Consent Management Platform (CMP) integrieren oder eine individuelle Einwilligungslösung erstellen, können Sie die Methode setTrackingConsent() verwenden, um die Einwilligungspräferenzen eines Kunden programmatisch zu aktualisieren.

Diese Methode sollte nur von autorisierten CMPs oder nach ausdrücklicher Einwilligung des Nutzers verwendet werden. Sie ist nicht dafür gedacht, Entscheidungen zu überschreiben, die der Nutzer über das native Shopify-Banner oder externe CMPs getroffen hat.

Beispiel: Einwilligungsstatus setzen

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

Einwilligungsstatus mit der Shopify Customer Privacy API prüfen

Verwenden Sie den folgenden Code, um die API zu laden und auf die Einwilligungspräferenzen des Besuchers zuzugreifen:

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

Stellen Sie sicher, dass Sie Ihre Logik innerhalb des Callbacks platzieren, da die API erst nach vollständigem Laden verfügbar ist.

Beispielausgabe

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

Einwilligungskategorien

Die API gibt den Einwilligungsstatus für folgende Kategorien zurück:

  • analytics
  • marketing
  • preferences
  • sale_of_data

Jede Kategorie gibt 'yes' oder 'no' zurück, sodass Sie Drittanbieter-Skripte basierend auf den Nutzerpräferenzen bedingt laden oder blockieren können.

essential ist bei Shopify immer aktiviert und kann nicht umgeschaltet werden.