So richtest du Gutscheine ein (für Magento 1.x)

Übersicht

Magento unterstützt Warenkorb-Preisregeln, mit denen du einen Rabatt auf die Bestellung einer*s Kund*in anwenden kannst. Für bestehende Preisregeln können Gutscheincodes erstellt werden, damit Käufer*innen einen bestimmten Code während des Checkout-Prozesses einfach nutzen können, um einen Rabatt anzuwenden.

Mit der Gutschein-Funktion von Klaviyo für Magento können Magento-1.0-Shops Folgendes tun:

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

In diesem Leitfaden wird erklärt, wie du Magento-Gutscheine in Klaviyo einrichtest.

Anforderungen

Als Voraussetzung stell sicher, dass du die Magento-Integration in Klaviyo aktiviert und die Klaviyo-Erweiterung in Magento installiert hast.

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.
    

11. Klicke auf Benutzer*in speichern.

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

REST-Anmeldedaten in Magento generieren

Um Klaviyos Magento-Gutschein-Funktionen zu aktivieren, erstelle zuerst REST-API-Anmeldedaten in deinem Magento-Shop mit dem REST-Admin-Konto, das du gerade erstellt hast, und füge diese dann in dein Klaviyo-Konto ein.

1. Melde dich als die*der REST-Admin-Benutzer*in an, die*den du im Abschnitt REST API aktivieren obenerstellt hast.
2. Klicke auf System > Konfiguration und klicke dann im Abschnitt Kund*innen auf Klaviyo.
3. Klicke auf OAuth-Token generieren.

Der Consumer Key, Consumer Secret, Authorization Token und das Authorization Secret werden ausgefüllt. Du kopierst diese Werte und fügst sie im nächsten Schritt in dein Klaviyo-Konto ein.

Magento-Gutscheine in Klaviyo einrichten

1. Im Klaviyo-Konto zur Magento-Integrationen navigieren.
2. Klicke auf den Pfeil Erweiterte Optionen, um die Gutschein-Einstellungen zu erweitern.
3. Füge die REST-Anmeldedaten ein, die du oben erstellt hast.

1. Klicke auf Magento-Einstellungen aktualisieren.

Klaviyo validiert deine REST-Anmeldedaten, und du kannst mit dem Tab „Gutschein“ deines Kontos beginnen, Gutscheine zu erstellen.

Einen Magento-Gutschein in Klaviyo erstellen

Wenn du nach der Angabe deiner REST-Anmeldedaten zum ersten Mal zum Gutschein -Tab in deinem Klaviyo-Konto navigierst, siehst du die Meldung: „Du hast noch keine Gutscheine hinzugefügt.“

1. Klicke auf Gutschein hinzufügen, um einen neuen Gutschein zu erstellen.
2. Fülle die folgenden Informationen aus: Gutscheinname und die Magento-Regel-ID.

• Gutscheinname: Der von dir angegebene Name darf nur aus Buchstaben, Zahlen und Unterstrichen bestehen und kann bis zu 32 Zeichen lang sein
• Magento-Regel-ID: Erstelle zuerst eine Regel in Magento und füge die ID dieser Regel hier ein, um sie mit diesem Gutschein zu verknüpfen

Alle erstellten Gutscheine werden mit den folgenden Übersichtsdetails angezeigt:

• Gutscheinname: Name des Gutscheins
• Aktiver Zeitraum: Es gibt die folgenden Optionen:
  • Aktiv, kein Ablaufdatum
  • Datum A – Kein Ablaufdatum
  • Datum A - Datum B
  • Aktiv, Ablaufdatum B
• Erstellungsdatum: Datum, an dem der Gutschein erstellt wurde
• Zuletzt aktualisiert am: Datum, an dem der Gutschein zuletzt aktualisiert wurde

Gutscheine können in diesem Tab über das Dropdown-Menü auf der rechten Seite bearbeitet und gelöscht werden.

Einen Magento-Gutschein in einer Flow-E-Mail verwenden

Sobald ein Gutschein erstellt wurde, kannst du ihn mithilfe der folgenden Platzhalter-Variable in eine Flow-E-Mail einfügen. Du kannst pro E-Mail nur einen Gutscheincode hinzufügen. Du kannst denselben Gutscheincode an mehreren Stellen anzeigen, aber du kannst nicht mehrere Codes verwenden.

{% coupon_code 'CouponName' %}

Ersetze CouponName durch den Namen deines Gutscheins. Zum Beispiel:

Verwende personalisierte Gutscheine in SMS-Flow-Nachrichten

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' %}.

Ersetze im Snippet CouponName durch den Namen des gewünschten Gutscheins und füge ihn in die Nachricht ein (entweder Flow oder Kampagne).

Anders als bei E-Mails kannst du pro SMS-Nachricht nur einen Gutscheincode verwenden. Bei E-Mails hast du Zugriff auf versteckte Blöcke, um unterschiedliche Gutscheine zu senden, je nachdem, wo eine Person lebt oder was sie getan hat. Wenn du versuchst, mehrere Gutscheine zu einer SMS hinzuzufügen, wird eine Fehlermeldung angezeigt.

Fehlerbehebung bei Fehlern

Fehlermeldung: „Verbindung zur REST-API mit den angegebenen REST-Anmeldedaten nicht möglich.“ Bitte überprüfe, ob diese Anmeldedaten in deinem Magento-Admin gültig sind.“

Wenn diese Fehlermeldung in Klaviyo angezeigt wird, gibt es zwei wahrscheinliche 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 keinen vollständigen Rollenzugriff für die REST API aktiviert.

Aktiviere zur Behebung dieses Problems HMAC-SHA1-Signaturen für die OAuth-Authentifizierung auf deinem Magento-Server. Führe dann die folgenden Schritte aus, um deine REST-Berechtigungen zu aktualisieren:

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
   Wir behandeln die Anweisungen dazu in unserem Leitfaden zum Einrichten von Gutscheinen für Magento im hier verlinkten Abschnitt.
3. Eine weitere häufige Ursache ist, dass verschiedene Apache-Module den Header „Authorization: Basic base64 (user:password)“ entfernen können.
   Lies diesen Beitrag für weitere Informationen

Gutscheincodes, die von Klaviyo in E-Mails eingefügt werden, sind nicht eindeutig – alle Empfänger*innen scheinen denselben Code zu erhalten.

Beim Erstellen einer Preisregel in Magento sollte die Option, eine neue Preisregel mit einem bestimmten Gutschein zu verknüpfen, auf „Bestimmter Gutschein“ eingestellt bleiben, und du musst das Kontrollkästchen „Automatische Generierung verwenden“ aktivieren.

Klicke in Magento auf deine Preisregel und scrolle unter Allgemeine Informationen 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 empfangende Person einer E-Mail einen neuen, personalisierten Gutschein zu generieren.