Klaviyo's Magento 1-Integration akzeptiert keine neuen Installationen mehr und wird Ende 2027 vollständig eingestellt. Der Klaviyo-Support kann bei Anfragen zu Magento 1 nicht mehr helfen.

Übersicht

Magento unterstützt Warenkorb-Preisregeln, die verwendet werden können, um einen Rabatt auf die Bestellung einer Kund*in anzuwenden. Für bestehende Preisregeln können Gutscheincodes erstellt werden, damit Käufer*innen während des Checkouts einen Code verwenden können, um einen Rabatt anzuwenden.

Klaviyos Gutschein-Funktionen für Magento ermöglichen es Stores mit einer bestehenden Magento-1.x-Integrationen, Folgendes zu tun:

  • Erstelle neue Gutscheine in Klaviyo, die mit bereits vorhandenen Preisregeln in Magento verknüpft sind.
  • Füge personalisierte Gutscheine in E-Mail- und SMS/MMS-Flow-Nachrichten ein, damit jede*r Empfänger*in einen einzigartigen Code erhält.

In diesem Leitfaden erfährst du, wie du Magento-Gutscheine in Klaviyo einrichtest.

Von Magento generierte personalisierte Gutscheine sind in E-Mail- und SMS/MMS-Flow-Nachrichten verfügbar. In Kampagnen-E-Mails sind sie nicht verfügbar. Das Senden von eindeutigen Gutscheincodes in einer Kampagne kann Tausende von Codes pro Sekunde erfordern, und die Rate-Limits des Magento-Servers können die Codegenerierung bei diesem Volumen beeinträchtigen.

Anforderungen

Für diese Schritte sind eine bestehende, aktivierte Magento 1-Integration sowie die in Magento installierte Klaviyo-Erweiterung erforderlich. Details zu den Daten, die durch die Integration synchronisiert werden, findest du in der Magento 1-Datenreferenz.

Die REST API aktivieren

Aktiviere zuerst die REST API, indem du eine neue REST-Rolle erstellst und ihr vollen Zugriff gewährst. Weise die Rolle dann einer*einem deiner Admin-Nutzer*innen zu.

  1. Klicke auf System > Web Services > REST - Rollen.
  2. Erstelle eine neue Administrator-Rolle. Gib für das Feld Rollenname einen Namen ein, zum Beispiel „Administrator“.
  3. Auf der linken Seite auf den Tab Role API Resources klicken. Resource Access auf All festlegen und auf Save Role klicken.
  4. Navigiere als Nächstes zu System > Web Services > REST - Attribute.
  5. Wähle Administrator aus der Liste der Benutzertypen aus.
  6. Setze Ressourcenzugriff auf Alle und klicke auf Speichern.
  7. Navigiere als Nächstes zu System > Berechtigungen > Benutzer*innen.
  8. Wähle eine*n Admin-Nutzer*in aus der Liste aus und klicke auf Nutzer*in bearbeiten.
  9. Klicke in der linken Seitenleiste auf den Tab REST role.
  10. Klicke auf das Optionsfeld, um deinem*r Nutzer*in die neue REST-Adminrolle zuzuweisen.
  1. Klicke auf Benutzer*in speichern.

Du hast jetzt die REST API für deinen Magento-Shop aktiviert.

Wenn du dir nicht sicher bist, ob deine REST API richtig konfiguriert ist, sieh dir bitte die Schritte in unserer Ressource zur Fehlerbehebung bei Gutscheinen für Magento 1x an.

Generiere REST-Anmeldedaten in Magento

Um Klaviyos Magento-Gutschein-Funktion zu aktivieren, generiere REST API-Anmeldedaten mit dem Admin-Nutzer, dem du die REST-Rolle zugewiesen hast, und gib sie dann in Klaviyo ein.

  1. Melde dich als Admin-Benutzer*in an, dem/der du die REST-Rolle im obigen Abschnitt „REST API aktivieren“ zugewiesen hast.
  2. Klicke auf System > Konfiguration und klicke dann im Abschnitt Kund*innen auf Klaviyo.
  3. Klicke auf OAuth-Token generieren.
763276
763276

Der Consumer Key, Consumer Secret, Authorization Token und das Authorization Secret werden ausgefüllt. Du kopierst diese Werte im nächsten Schritt per Copy/Paste in dein Klaviyo-Konto.

Magento-Gutscheine in Klaviyo einrichten

Dein Magento-Server muss HMAC-SHA1-Signaturen für die OAuth-Authentifizierung unterstützen.

  1. Im Klaviyo-Konto zur Magento-Integrationen navigieren.
  2. Gehe im Tab Einstellungen zu Erweitert > Gutscheine und wähle Gutscheine aktivieren aus.
  3. Gib deinen Consumer key, Consumer secret, Authorization token und Authorization secret aus Magento ein.
  1. Klicke auf Speichern.

Nachdem die Einstellungen erfolgreich gespeichert wurden, kannst du auf der Seite Gutscheine einen Gutschein erstellen.

Einen Magento-Gutschein in Klaviyo erstellen

Öffne in Klaviyo die Gutschein-Seite und wähle den Tab Magento 1 Gutscheine aus.

Bevor du einen neuen Gutschein erstellst, musst du zuerst in Magento eine Preisregel definieren, die alle Spezifikationen für den Gutschein enthält. Preisregeln können nicht in Klaviyo erstellt werden. Ein neuer in Klaviyo erstellter Gutschein muss auf eine bereits vorhandene Preisregel in Magento verweisen.

Wenn du in Magento eine Preisregel erstellst, beachte, dass die Option, eine neue Preisregel einem bestimmten Gutschein zuzuordnen, auf Spezifischer Gutschein gesetzt bleiben sollte, und du musst das Kontrollkästchen Use Auto Generation aktiviert haben.

  1. Klicke auf Magento 1-Gutschein erstellen.
  2. Gib den Namen und die Magento-Regel-ID ein:
    • Name: Verwende einen eindeutigen Namen mit nur Buchstaben, Zahlen und Unterstrichen, der maximal 32 Zeichen lang ist. Du kannst den Namen nach dem Erstellen des Gutscheins nicht mehr ändern.
    • Magento-Regel-ID: Gib die ID der Preisregel ein, die du in Magento erstellt hast, um sie mit diesem Gutschein zu verknüpfen.
  3. Klicke auf Gutschein erstellen. Nachdem die Erstellung erfolgreich war, führt dich Klaviyo zurück zur Magento-Gutscheinliste.

Nach der Erstellung kannst du die folgenden Details in Klaviyo überprüfen:

  • Gutschein: Der Gutscheinname in der Liste.
  • Aktiver Zeitraum: Öffne den Gutschein, um die Daten zu sehen, die durch die Magento-Preisregel angegeben werden. Der Zeitraum kann Folgendes anzeigen:
    • Aktiv, kein Ablaufdatum
    • Datum A – Kein Ablaufdatum
    • Datum A - Datum B
    • Ablaufdatum B
  • Erstellt: Das Datum, an dem der Gutschein erstellt wurde.
  • Zuletzt aktualisiert: Das Datum, an dem der Gutschein zuletzt aktualisiert wurde.

Um einen Gutschein zu bearbeiten, klicke auf seinen Namen, aktualisiere die Magento-Regel-ID und klicke auf Gutschein aktualisieren. Um einen Gutschein zu löschen, öffne das Zeilenmenü, wähle Löschen aus und bestätige den Löschvorgang.

Verwende einen Magento-Gutschein in einer Flow-E-Mail

Sobald ein Gutschein erstellt wurde, füge ihn mithilfe des folgenden Vorlagen-Tags in eine Flow-E-Mail ein. Um denselben Code an mehreren Stellen anzuzeigen, wiederhole den Tag mit demselben Gutscheinnamen.

text
{% coupon_code 'CouponName' %}

Ersetze CouponName durch den Namen deines Gutscheins. Zum Beispiel:

mceclip0__2_.png
mceclip0__2_.png

Wenn du denselben Gutschein in einer E-Mail und einer SMS/MMS-Flow-Nachricht verwendest, kann Klaviyo den Code wiederverwenden, der dieser*m Empfänger*in bereits zugewiesen wurde. Wenn du den Gutscheinnamen wiederholst, wird dadurch nicht garantiert, dass du für jede Nachricht einen neuen Code erhältst.

Personalisierte Gutscheine in SMS-Flow-Nachrichten verwenden

Personalisierte Gutscheine sind auch für deine SMS/MMS-Nachrichten in Flows verfügbar. Generiere die Codes genau wie für E-Mails. Verwende dann das folgende Vorlagen-Tag, um den Gutscheincode in deine SMS- oder MMS-Nachricht einzufügen:

{% coupon_code 'CouponName' %}.

Ändere im Snippet CouponName in den Namen deines Gutscheins und füge das Snippet zu deiner SMS- oder MMS-Flow-Nachricht hinzu.

2020-06-16_17-58-37.png
2020-06-16_17-58-37.png

Du kannst pro SMS/MMS-Nachricht einen Gutscheinnamen verwenden. Wenn du unterschiedliche Gutscheinnamen hinzufügst, wird ein Fehler angezeigt. In E-Mails kannst du Blöcke ein-/ausblenden, um unterschiedliche Gutscheine zu senden, je nachdem, wo jemand wohnt oder was er*sie getan hat. Damit du pro Empfänger*in 1 Angebot anzeigen kannst, lege die Bedingungen so fest, dass nur der vorgesehene Gutscheinblock erscheint.

2020-06-17_09-51-08.png
2020-06-17_09-51-08.png

Fehler beheben

Gutscheine können nicht aktiviert werden oder Verbindung zur REST-API nicht möglich

Möglicherweise siehst du in den Integrationseinstellungen „Gutscheine können aufgrund eines Authentifizierungsproblems nicht aktiviert werden“ oder „Verbindung zur REST API mit den angegebenen REST credentials nicht möglich.“ Bitte überprüfe, ob diese Zugangsdaten in deinem Magento-Admin gültig sind.“

Überprüfe zuerst, dass alle 4 REST-Anmeldedaten korrekt kopiert wurden. Wenn sie korrekt sind, überprüfe diese möglichen Ursachen:

  1. Dein Magento-Server ist nicht so eingerichtet, dass er HMAC-SHA1-Signaturen für die OAuth-Authentifizierung unterstützt.
  2. Möglicherweise hast du den vollständigen Rollenzugriff für die REST API nicht aktiviert.

Bestätige, dass dein Magento-Server HMAC-SHA1-Signaturen für die OAuth-Authentifizierung unterstützt. Prüfe dann die folgenden REST-Berechtigungen und Servereinstellungen:

  1. Kommentiere die Rewrite-Regel in deiner .htaccess aus oder füge sie hinzu Datei neu generieren. Das ist die Zeile, die du unbedingt auskommentiert lassen solltest:
    RewriteRule ^api/rest api.php?type=rest [QSA,L]
  2. Überprüfe, ob deine REST-Rolle korrekt eingerichtet ist.
    Führe die Schritte im Abschnitt „REST API aktivieren“ oben aus.
  3. Wenn du Apache verwendest, überprüfe, dass er den Authorization -Header an PHP weitergibt. Die Magento-REST-Verbindung verwendet OAuth-Zugangsdaten. In diesem Leitfaden zum Weiterleiten des Authorization-Headers findest du Details zur Serverkonfiguration.

Wenn die Fehlermeldung ausdrücklich ein SSL-Zertifikat erwähnt, überprüfe, dass in deinem Magento-Shop ein gültiges, vertrauenswürdiges SSL-Zertifikat installiert ist.

Alle Empfänger*innen erhalten denselben Gutscheincode

Wenn du in Magento eine Preisregel erstellst, sollte die Option, eine neue Preisregel mit einem bestimmten Gutschein zu verknüpfen, auf Spezifischer Gutschein eingestellt bleiben, und du musst das Kontrollkästchen „Use Auto Generation“ aktivieren.

Klicke in Magento auf deine Preisregel, und scrolle unter General Information nach unten zur Zeilenoption „Gutschein“ und ändere diese Einstellung in „Spezifischer Gutschein“. Aktiviere als Nächstes hier das Kontrollkästchen für die automatische Generierung. Das sollte das Problem beheben und es uns ermöglichen, für jede*n E-Mail-Empfänger*in einen neuen personalisierten Gutscheincode zu generieren.

War dieser Artikel hilfreich?
Nutze dieses Formular nur für Feedback zu Artikeln. So kontaktierst du den Support.

Mehr von Klaviyo entdecken

Community
Vernetze dich mit Kolleg*innen, Partner*innen und Klaviyo-Expert*innen, um dich inspirieren zu lassen, Erkenntnisse auszutauschen und Antworten auf deine Fragen zu erhalten.
Partner
Beauftragen Sie einen Klaviyo-zertifizierten Experten, der Ihnen bei einer bestimmten Aufgabe hilft oder für das laufende Marketing-Management zuständig ist.
Support

Kontaktiere den Support über dein Konto.

Support per E-Mail (kostenlose Testversion und kostenpflichtige Konten) Verfügbar 24/7

Chat / virtuelle Unterstützung
Verfügbarkeit abhängig von Standort und Abonnementtyp