Erste Schritte mit PrestaShop

Übersicht

Du erfährst, wie du deinen PrestaShop mit Klaviyo integrierst. Klaviyo ist der bevorzugte Partner von PrestaShop für Marketing-Automatisierung. Dieser Prozess umfasst zwei Schritte: die Installation eines kostenlosen Moduls(PrestaShop Automation mit Klaviyo) in PrestaShop und die Aktivierung der Integration in Klaviyo. In diesem Artikel findest du außerdem Informationen zur Überwachung deiner Datensynchronisation, zur Einrichtung von Transaktions-E-Mails und zum Update deines Moduls, damit dein Unternehmen mit Klaviyo wachsen kann.

Bevor du anfängst

Um das Klaviyo Modul verwenden zu können, benötigst du eine der folgenden PrestaShop Versionen:

• PrestaShop 1.7.0 und höher (inkl. PHP 7.1 oder höher)
  • Bitte beachte, dass du PrestaShop 1.7.6 oder höher benötigst, wenn du die SMS-Einwilligung im Rahmen der Erfassungsfunktion beim Bezahlvorgang einholen möchtest.
• PrestaShop Edition 8.0 und höher
• PrestaShop Project 8.0 und höher

Wenn du eine ältere PrestaShop-Version (vor 1.7.0) verwendest und ein Upgrade durchführen möchtest, um ein Klaviyo Modul zu verwenden, lies dir die Anleitung zum Upgrade deines Shops von PrestaShop durch.

Bitte lies vor der Integrierung die folgenden Informationen:

• Wenn du die PrestaShop Edition verwendest, ist das Modul PrestaShop Automation mit Klaviyo bereits vorinstalliert. Wenn du eine andere Version von PrestaShop verwendest, musst du diese installieren (siehe nächster Abschnitt). 
• PrestaShop Automation mit Klaviyo wurde entwickelt, um PrestaShop Backoffice-Funktionen wie PrestaShop Account zu integrieren. Beachte, dass Stores, die mit PrestaShop Project 8.0 arbeiten, das PS_MBO Modul installieren müssen, um das Klaviyo Modul verwenden zu können.
• Du möchtest keine Back-Office-Funktionen in deinen Open Source PrestaShop Store integrieren? Du kannst stattdessen unser Klaviyo by PrestaShop Partnermodul verwenden, das den gleichen Funktionsumfang wie PrestaShop Automation mit Klaviyo enthält und kein PS_MBO benötigt.

Möchtest du dein aktuelles Klaviyo Modul aktualisieren? Mehr dazu erfährst du am Ende dieses Artikels. 

Video-Anleitung

Das Modul in PrestaShop installieren

1. Wenn du PrestaShop Edition verwendest, ist das Modul PrestaShop Automation mit Klaviyo bereits vorinstalliert. So gehst du vor:
1. Melde dich bei deinem PrestaShop-Shop an.
2. Wähle unter Configure (Konfigurieren) im linken Menü die Option Klaviyo aus.
3. Im nächsten Abschnitt dieses Artikels erfährst du, wie du das Modul konfigurierst.
2. Wenn du die PrestaShop Edition nicht verwendest, rufe im PrestaShop Marketplace die Seite zur Verwendung von PrestaShop Automation mit dem Klaviyo Modul auf und fahre mit dem nächsten Schritt fort.
   
3. Klicke auf der Modulseite auf Download. Bestätige gegebenenfalls deine Angaben, wähle dann die von dir verwendete PrestaShop-Version aus und lade die Zip-Datei herunter. Du brauchst die Zip-Datei nicht zu entpacken.
   
4. Melde dich bei deinem PrestaShop-Shop an und navigiere zu Modules > Module Manager. Klicke auf Upload a module (Modul hochladen) und zieh die Zip-Datei per Drag-and-Drop in den Modul-Manager.
   
5. Nach Abschluss der Installation zeigt das Modul eine Erfolgsmeldung an. Klicke anschließend auf Configure (Konfigurieren) und fahre mit dem nächsten Abschnitt fort.

Das Modul in PrestaShop konfigurieren

1. Du musst deinen öffentlichen Klaviyo API-Schlüssel (auch bekannt als deine Site-ID) abrufen und einen privaten Klaviyo API-Schlüssel zur Verwendung in PrestaShop generieren. 
   • Melde dich bei Klaviyo an und klicke dann unten links auf den Namen deiner Organisation.
   • Wähle Einstellungen > API-Schlüssel.
   • Kopiere deinen öffentlichen API-Schlüssel von der Seite und füge ihn in die entsprechende Einstellung in PrestaShop ein.
   • Zurück in Klaviyo klickst du auf Privaten API-Schlüssel erstellen. Dann benennst du den API-Schlüssel, wählst Schlüssel mit vollem Zugriff und klickst auf Erstellen.
   • Kopiere deinen neu erstellten privaten API-Schlüssel und füge ihn in die entsprechende Einstellung in PrestaShop ein.
2. Aktiviere die Option Bestellereignisse in Echtzeit an Klaviyo senden, wenn du möchtest, dass transaktionale Bestellereignisse in Echtzeit synchronisiert werden. Diese Events können zum Senden von Transaktionsnachrichten verwendet werden und erscheinen als zweite Gruppe von Events, die als transaktional gekennzeichnet sind. So siehst du z. B. in Klaviyo eine Metrik mit der Bezeichnung TRANSAKTIONAL – BESTELLUNG AUFGEGEBEN, die in Echtzeit synchronisiert wird, zusätzlich zu einer Metrik mit der Bezeichnung BESTELLUNG AUFGEGEBEN, die alle 30 Minuten synchronisiert wird.
   
3. Ändere gegebenenfalls die Einstellung für Von PrestaShop generierte Transaktions-E-Mails bei Bestellungen deaktivieren. Wir empfehlen, die Einstellung so lange deaktiviert zu lassen, bis du einsatzbereite Transaktions-E-Mails in Klaviyo hast. Du kannst jederzeit zu dieser Seite zurückkehren und die Einstellung aktivieren, um Sendungen von PrestaShop zu deaktivieren. Beachte, dass das Aktivieren dieser Einstellung Transaktions-E-Mails blockiert, die im Zusammenhang mit den Ereignissen BESTELLUNG AUFGEGEBEN, BESTELLUNG ERFÜLLT, BESTELLUNG STORNIERT und BESTELLUNG ERSTATTET sowie mit Zahlungserinnerungs-E-Mails stehen. 
4. Aktiviere die Option PrestaShop-E-Mail-Abonnenten mit Klaviyo synchronisieren, wenn du E-Mail-Abonnent*innen, die beim Bezahlvorgang oder über ein Anmeldeformular erfasst wurden, synchronisieren möchtest.
5. Aktiviere die Option PrestaShop-SMS-Abonnenten mit Klaviyo synchronisieren, wenn du möchtest, dass sich Benutzer*innen während des Bezahlvorgangs für SMS-Marketing anmelden können.
   
   Bevor du SMS-Abonnent*innen synchronisieren kannst, musst du SMS in Klaviyo einrichten.
   
6. Klicke auf Speichern, um fortzufahren.
7. Wenn du die Einstellung für die Synchronisierung von E-Mail-Abonnent*innen aktiviert hast, wirst du aufgefordert, eine Liste aus deinem Klaviyo-Konto auszuwählen, zu der du E-Mail-Abonnent*innen hinzufügen möchtest. Alle neuen Abonnent*innen werden zu der von dir gewählten Liste hinzugefügt. Wir empfehlen hier die Verwendung der E-Mail-Liste.
   
8. Wenn du mit dem Newsletter-Abonnement-Modul von PrestaShop Profile in eine Klaviyo-Liste eintragen möchtest, stelle sicher, dass du das Modul aktiviert hast und dass das Modul Version 2.6.0 oder höher verwendet.
9. Wenn du die Einstellung zur Synchronisierung von SMS-Abonnent*innen aktiviert hast:
1. Du wirst aufgefordert, eine Liste aus deinem Klaviyo-Konto auszuwählen, zu der du SMS-Abonnent*innen hinzufügen möchtest. Alle neuen Abonnent*innen werden zu der von dir gewählten Liste hinzugefügt. Wir empfehlen, eine getrennte Liste für E-Mail- und SMS-Abonnent*innen zu verwenden.
2. Wähle Wann können Nachrichten abonniert werden? Dies kann entweder geschehen, nachdem sie den Bezahlvorgang gestartet oder eine Bestellung aufgegeben haben.
3. Füge ein Einwilligungs-Label für dein Marketing-Kästchen hinzu. Verwende eine klare Formulierung, um Benutzer*innen darüber zu informieren, wozu sie zustimmen (z. B. „SMS-Marketing abonnieren“).
4. Füge den Offenlegungstext für die Einwilligung hinzu. Für die Einhaltung der Vorschriften ist eine Offenlegung erforderlich. Stelle sicher, dass du die Bedingungen für dein SMS-Marketingprogramm in deine Nutzungsbedingungen und deine Datenschutzerklärung aufnimmst. Hinweis: Im Feld für die Offenlegung musst du HTML verwenden. Beispiel für eine Offenlegung:
   Indem du dieses Kästchen aktivierst und oben deine Telefonnummer eingibst, stimmst du zu, Marketing-Textnachrichten (z. B. zu Werbeaktionen, Warenkorberinnerungen) von [Firmenname] an die angegebene Nummer zu erhalten. Es können Nachrichten- und Datengebühren anfallen. Die Häufigkeit der Nachrichten kann variieren. Du kannst dich jederzeit abmelden, indem du mit STOP antwortest oder auf den Abmeldelink klickst (sofern verfügbar). <a href="link">Datenschutzerklärung</a> und <a href="link">Nutzungsbedingungen</a>.
5. Du kannst den Sprachschalter rechts neben dem Offenlegungsfeld verwenden, um den entsprechenden Text für jede Sprache hinzuzufügen, in der dein Shop angezeigt wird. 
   
10. Klicke auf Speichern, um fortzufahren.
11. Als Nächstes füllst du das Formular für die Zuordnung des Bestellstatus aus, indem du entweder die Standardwerte akzeptierst oder andere Werte auswählst. Der Bestellstatus entspricht den Bestellereignissen, die in Klaviyo aufgezeichnet werden. Du kannst für jedes Bestellereignis mehrere Werte auswählen. Nutze Cmd oder Strg+Klick, um mehrere auszuwählen. Ein Wert kann nicht in mehreren Bestellereignissen ausgewählt werden. Solltest du einen Wert mehrfach auswählen, bekommst du eine Fehlermeldung und deine Eingabe kann nicht gespeichert werden Sowohl transaktionale als auch nicht-transaktionale Ereignisse halten sich an die von dir gewählte Bestellzuordnung.
12. Wenn du mit der Konfiguration des Bestellstatus fertig bist, klicke auf Speichern.
13. Nun siehst du einen Gutschein-Bereich, in dem du Gutscheine erstellen kannst. Wähle im Feld Warenkorbregel-Limit die Option Eine Warenkorbregel pro Präfix oder Eine Warenkorbregel pro Bestellung , um die Verwendung von Gutscheinen durch Kund*innen zu begrenzen. Die Standardeinstellung ist eine Warenkorbregel pro Präfix. Auf diese Weise können Kund*innen während des Bezahlvorgangs nicht mehr als einen Gutscheincode mit demselben Präfix hinzufügen.
    
14. Wenn du auch über das Feld Zu generierende Menge Gutscheincodes generieren möchtest, kannst du später auf diese Seite zurückkehren. Erfahre mehr darüber, wie du allgemeingültige Gutscheine für PrestaShop erstellst.
15. Als Nächstes wählst du Erweiterte Parameter im Abschnitt Konfigurieren der linken Navigation. Wähle Webservice. Kopiere den Webservice-Schlüssel von Klaviyo, der für dich generiert wurde, und fahre mit dem nächsten Abschnitt fort. 
    • Dieser Schlüssel wird im nächsten Schritt verwendet, wenn du die Integration in Klaviyo aktivierst. Wir empfehlen dir zu überprüfen, ob der Webservice-Schlüssel über die richtigen Berechtigungen für Klaviyo verfügt. Klicke dafür auf das Bleistift-Symbol neben dem Klaviyo Webservice-Schlüssel. Scrolle in der Liste aller Berechtigungen nach unten und suche Klaviyo. Stelle sicher, dass die Kontrollkästchen aller Berechtigungen aktiviert sind. Wähle Speichern, um Änderungen zu übernehmen.

Die Integration in Klaviyo aktivieren

1. Als Nächstes aktivierst du die PrestaShop-Integration in deinem Klaviyo-Konto. Wähle dazu in Klaviyo den Namen deiner Organisation in der unteren linken Ecke aus und gehe dann zu Integrationen. 
2. Klicke auf Integrationen hinzufügen, suche nach PrestaShop und wähle die Karte aus. Klicke dann auf Installieren.
3. Auf der nächsten Seite klickst du auf Mit PrestaShop verbinden.
   
4. Auf der nächsten Seite gibst du die URL deines PrestaShop-Shops in das Feld Shop-URL ein. Du findest deine Shop-URL in deinem PrestaShop-Konto unter Shop Parameters (Shop-Parameter) > Traffic & SEO (Traffic und SEO) > Shop URLs (Shop-URLs). Du kannst auch auf View my shop (Meinen Shop anzeigen) klicken, um von jeder Seite deines Kontos aus schnell zu deiner PrestaShop-Website zu navigieren und die URL deines Shops abzurufen.
   
5. Füge den Webservice-Schlüssel, den du aus PrestaShop kopiert hast, in das Feld Webservice-Schlüssel ein.
6. Wenn du alle von deinen Shops verwendeten Währungen in Klaviyo in eine bestimmte Währung umrechnen möchtest, markiere Alle Währungen in eine Standardwährung umrechnen und wähle einen globalen Währungscode aus der Dropdown-Liste aus.
   • Die Währung deines Klaviyo-Kontos wird dadurch nicht geändert. Um die Währung deines Kontos zu ändern, sieh dir unseren Leitfaden zum Ändern der Währung für dein Konto an.
7. Unter Liste der Shops abrufen findest du eine Liste deiner verfügbaren PrestaShop-Shops. Wähle dann die Shops aus, die du integrieren möchtest. Du musst mindestens einen Shop auswählen, um fortzufahren.
8. Klicke auf Mit PrestaShop verbinden. Du siehst eine Erfolgsmeldung, die anzeigt, dass deine Konten verbunden wurden.
   

PrestaShop-Daten in Klaviyo

Drei Arten von Ereignissen werden von PrestaShop zu Klaviyo synchronisiert: 

• Bestellereignisse, die alle 30 Minuten synchronisiert werden (z. B. BESTELLUNG AUFGEGEBEN).
• Transaktionale Bestellereignisse, die in Echtzeit synchronisiert werden, sofern du sie aktivierst (z. B. TRANSAKTIONAL – BESTELLUNG AUFGEGEBEN).
• Onsite-Ereignisse von Klaviyo (z. B. AUF SEITE AKTIV, PRODUKT AUFGERUFEN und ZUM WARENKORB HINZUGEFÜGT). 

Darüber hinaus werden auch Kundeninformationen von PrestaShop mit Klaviyo-Profilen synchronisiert, einschließlich E-Mail-Adresse, Telefonnummer, E-Mail-Einwilligung und SMS-Einwilligung, falls zutreffend. 

Alle diese Ereignisse kannst du in Klaviyo unter Analytics > Metriken einsehen. Durch Filtern nach PrestaShop siehst du Bestell- und Transaktionsereignisse (sie werden mit PrestaShop-Symbol angezeigt). Du kannst aber auch nach API filtern, um Onsite-Ereignisse von Klaviyo aufzurufen (sie haben ein Zahnrad-Symbol). Eine vollständige Liste der von PrestaShop synchronisierten Metriken findest du in unserem PrestaShop-Überblick.

Bei der erstmaligen Integration mit PrestaShop synchronisiert Klaviyo die Daten der letzten 90 Tage, sodass du direkt mit dem Engagement neuerer Kunden beginnen kannst. Nach der Synchronisierung der Daten der letzten 90 Tage beginnt Klaviyo mit der vollständigen Synchronisierung deiner Kundenhistorie. Je nachdem, wie viele Bestellungen, Kunden und Produkte dein Shop hat, kann die Synchronisierung aller Daten zwischen einigen Minuten und mehreren Tagen dauern.

Wir empfehlen, dass du mindestens 1024 MB PHP-Speicher zur Verfügung hast, wenn die Synchronisierung der Kundenhistorie läuft. So kann die Synchronisierung zeitnah abgeschlossen werden. Der anfängliche Speicherbedarf kann auf Wunsch reduziert werden, nachdem die Synchronisierung der Kundenhistorie abgeschlossen ist.

Wenn die Synchronisierung abgeschlossen ist, wird die PrestaShop-Integration auf der Registerkarte „Integrationen“ als abgeschlossen markiert. Um zu überprüfen, ob alle Daten aus PrestaShop erfolgreich synchronisiert wurden, kannst du die Gesamtbestellungen für einige Tage oder eine Woche abgleichen. Bevor du mit der Validierung beginnst: Stelle sicher, dass die Zeitzone deines Kontos mit den Einstellungen in PrestaShop übereinstimmt. So überprüfst oder aktualisierst du die Zeitzone deines Kontos:

1. Klicke unten links auf den Namen deiner Organisation.
2. Gehe zu Einstellungen.
3. Gehe zur Registerkarte Organisation. 

Transaktions-E-Mails senden

Möchtest du Transaktions-E-Mails mit Echtzeit-Bestelldaten aus PrestaShop versenden? Dazu ist es erforderlich, neue Flows in Klaviyo erstellen. Lies den Artikel So verwendest du Flows für den Versand von Transaktions-E-Mails, um zu erfahren, wie Transaktions-E-Mails in Klaviyo funktionieren. Du musst diese Flows zunächst einrichten und dich dann zur Genehmigung an das Support-Team von Klaviyo wenden. Sobald die Flows genehmigt sind, kannst du den Versand von Transaktions-E-Mails in PrestaShop deaktivieren und deine Transaktions-Flows in Klaviyo starten. 

Dein Modul aktualisieren

Verwendest du eine PrestaShop-Modulversion unter 1.4.1? Wir empfehlen, sofort auf 1.4.1 oder höher zu aktualisieren. Ältere Versionen des Moduls verwenden die APIs v1 und v2 von Klaviyo, die inzwischen eingestellt wurden und nicht mehr wie erwartet funktionieren.

Wenn du ein Upgrade auf Version 1.4.1 oder höher durchführst, kannst du die Vorteile dieser Funktionen nutzen, die erstmals in Version 1.3.0 veröffentlicht wurden:

1. Zeige für Produkte, die in deinen E-Mails beworben werden, einfach den tatsächlichen Preis inkl. Mehrwertsteuer (MwSt.) an. Beachte, dass ein Upgrade von einer älteren Version als 1.2.10 auf Version 1.2.10 oder höher aufgrund dieser Änderung zu Ungenauigkeiten bei den E-Mail-Vorlagen führen kann. Lies diesen Artikel für weitere Informationen.
2. Versende Transaktions-E-Mails an deine Kunden mit Ereignis-Synchronisierung in Echtzeit.
3. Generiere mehrere Gutscheine auf einmal und importiere sie gebündelt in Klaviyo.

So aktualisierst du dein Modul auf die neueste Version:

1. Melde dich in deinem PrestaShop-Admin-Konto an.
2. Navigiere zu Module > Module Manager.
3. Scrolle zum Klaviyo-Modul und wähle Upgrade aus. 
   

Die Änderungen für jede Version findest du im Klaviyo-Modul im Marketplace für Add-ons. Scrolle nach unten zu What’s New? (Was gibt's Neues?) und klicke auf Show changelog history (Änderungsverlauf anzeigen). 

Bist du an einer gepatchten Version interessiert?

Wenn du das PrestaShop-Modul von Klaviyo in der Version 1.2.18 oder 1.2.9 verwendest und eine gepatchte Version nutzen möchtest (statt dem neuesten Modul von Klaviyo), sind Patches verfügbar. Gehe für ein Upgrade dieser Module folgendermaßen vor:

1. Melde dich in deinem PrestaShop-Admin-Konto an. 
2. Navigiere zu Module > Module Manager.
3. Suche das Klaviyo-Modul, öffne die Dropdown-Liste neben Upgrade und wähle Uninstall (Deinstallieren).
   
4. Verwende diese Links, um deine Patch-Version herunterzuladen:
   • 1.2.18+v3api.zip 
   • 1.2.9+v3api.zip
5. Lade das Modul im PrestaShop-Modulmanager hoch, beginnend mit Schritt 4 im obigen Abschnitt. 
6. Integriere PrestaShop wieder in Klaviyo, indem du die weiteren Schritte ausführst. 

Ergebnis 

Du hast PrestaShop mit Klaviyo integriert und kannst Klaviyo für deine eigenen Marketing-Anforderungen nutzen. 

Weitere Ressourcen

• PrestaShop: Datenübersicht

• So aktivierst du Preise mit Mehrwertsteuer für PrestaShop
• So erstellst du Gutscheine für PrestaShop