Klaviyo-Integration: Einrichtung und Hilfe

1. Laden Sie das mprklaviyo-ZIP unter Module > "Module Manager" hoch und installieren Sie es.
2. Klicken Sie auf "Configure", um Klaviyo-Einstellungen zu öffnen.
3. Kopieren Sie Ihren öffentlichen Klaviyo-API-Schlüssel, auch Site ID genannt, in Öffentlicher API-Schlüssel. Der Feldhinweis verweist auf "Klaviyo > Settings > API Keys".
4. Prüfen Sie die Einwilligungsdienst-ID und die Ereignisschalter.
5. Aktivieren Sie "Enable Klaviyo" und klicken Sie auf Speichern.
6. Erteilen Sie in einer neuen Browser-Kundensitzung die entsprechende Marketing-Einwilligung und besuchen Sie eine Produktseite.
7. Fügen Sie ein Produkt hinzu und schließen Sie eine Testbestellung ab. Prüfen Sie die eingehenden Klaviyo-Ereignisse.

Verwenden Sie die öffentliche Site ID. Für diese Onsite-Integration benötigen Sie keinen privaten Klaviyo-API-Schlüssel.

Die Modulseiten "Integrity", Lizenz, Support und Updates sind neben der Konfiguration verfügbar. Ein Hinweis auf erforderliche Einstellungen meldet einen fehlenden öffentlichen Schlüssel.

Das Modul startet über displayHeader. Der aktuelle Handler für displayBeforeBodyClosingTag gibt kein Tracking-Markup zurück. Das Template enthält öffentliche Routing-Konfiguration. Kunden-, Warenkorb- und Bestelldaten werden nach Live-Prüfungen von einem privaten, nicht cachebaren Tracking-Endpunkt abgerufen.

Die Laufzeit prüft Aktivierungszustand, Konto, Shop-Host, Richtlinien für ausgehende Übertragungen, Marketing-Einwilligung und interne Mitarbeitermarkierungen, bevor sie Folgendes lädt:

https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=YOUR_SITE_ID

Die Identifizierung erfordert außerdem eine passende Einwilligung und eine authentifizierte Kundensitzung. Wenn erlaubt, sendet sie $email, $first_name und $last_name. Eine Anmeldung allein setzt die Einwilligung nicht außer Kraft.

Das Modul meldet Newsletter-Kontakte nicht bei einer Klaviyo-Liste an und importiert keine historischen Kunden und Bestellungen. Konfigurieren Sie Kampagnen, Segmente und Flows in Klaviyo anhand der empfangenen Ereignisse.

Warenkorbzugänge werden mit actionBeforeCartUpdateQty und actionCartSave erfasst. Der Browser verarbeitet ausstehende Zugangseinträge. Das bloße Öffnen des Warenkorbs löst das Ereignis nicht mehr aus. Für Zugänge in der Warteschlange gelten Prüfungen der erfassten Einwilligung, des Ziels und des Widerrufs.

Die Bestellbestätigung verwendet displayOrderConfirmation und einen an den Käufer gebundenen Beleg. Stornierte/fehlerhafte Bestellungen werden übersprungen. Ein Protokoll verhindert wiederholte Freigaben für denselben Shop, dasselbe Ziel und dieselbe Bestellung. Verwenden Sie für Tests eine neue Bestellung, statt eine alte Bestätigung wiederholt neu zu laden.

Falls Sie ein Theme-Override benötigen, lautet der Pfad des Bootstrap-Templates:

themes/your-theme/modules/mprklaviyo/views/templates/hook/tracking.tpl

Das aktuelle Template delegiert an JavaScript und den privaten Endpunkt. Behalten Sie Datenattribute und Skriptverweise bei, wenn Sie es anpassen.

• Kein Skript: Prüfen Sie "Enable Klaviyo", Öffentlicher API-Schlüssel, den Hook displayHeader, Einwilligung und Mitarbeitermarkierungen.
• Keine Identifizierung: Prüfen Sie Kundenanmeldung und passende Einwilligung. Ein anonymer Besuch liefert keine Kundenidentität.
• Kein Produktaufruf: Prüfen Sie "Track Viewed Product", den Aktivierungszustand und die ID des Produkts.
• Kein Warenkorbereignis: Fügen Sie nach Einwilligung in einer Kundensitzung einen Artikel hinzu. Prüfen Sie die private Tracking-Anfrage und bei Bedarf die Warenkorbereignistabellen über "Integrity".
• Kein Kaufereignis: Prüfen Sie "Track Purchase", den nativen Bestätigungs-Hook, die Käufersitzung, die sichere Bestätigungs-URL und den Bestellstatus.
• Blockierte externe Anfrage: Prüfen Sie Datenschutzwerkzeuge des Browsers und Netzwerkfehler. Verwenden Sie einen markierten Backoffice-Browser nicht als einzigen Test.

Deaktivieren Sie "Enable Klaviyo" und speichern Sie, um das Tracking dieses Moduls zu stoppen. Deinstallieren Sie es im "Module Manager", um Menü und Konfiguration zu entfernen. Die Deinstallationsmethode löscht Ereignistabellen nicht ausdrücklich. Sie fordert keine Löschung bereits an Klaviyo gesendeter Profile oder Ereignisse an.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.