Dokumentation: Maileon

Geändert am Fri, 06 Oct 2023 um 01:53 PM


INHALTSVERZEICHNIS

1. Installation

Das Plugin kann wie gewohnt über die Pluginverwaltung im Shopbackend installiert werden.


1.1 API Key

In den Plugineinstellungen muss zunächst der API Key hinterlegt werden.

Diesen findest du in deinem Maileon Konto unter Einstellungen > API Key.

Dort kannst du einen API Key erstellen. Der API Key benötigt alle Berechtigungen, damit das Plugin funktioniert.



2. Konfiguration bei Maileon

Um die Synchronisation von Maileon zu Shop zu ermöglichen, müssen noch Einstellungen bei Maileon getätigt werden.


2.1 DOI Mail

Um eine DOI (Double Opt In) Mail bei Maileon auszulösen. Muss eine DOI Mail im Maileon Konto angelegt werden. Dies kannst du unter Versendungen DOI-Mailings.


2.2 Webhooks

Um Maileon zu ermöglichen die Newsletterempfänger zu aktualisieren, müssen 2 Webhooks eingerichtet werden. 

Einer dient dem Aktivieren des Newsletterempfänger der andere dem löschen.

Webhooks kannst du unter Einstellungen > Webhooks anlegen.


2.2.1 Webhook DOI

Um das DOI mittels der von Maileon verschickten DOI Mail einzurichten, wird ein DOI Webhook benötigt.

Erstelle hierfür einen DOI Webhook. Die URL muss dem Schema


https://meinShop.de/plugins/ws5_maileon/confirm.php


entsprechen. Zusätzlich muss noch ein URL-Parameter definiert werden. Dieser muss mail lauten und den Kontaktfeldwert E-Mail Adresse beinhalten. Bestätigt ein Kunde nun seine Email in der Maileon DOI Mail wird er ebenfalls im JTL Shop als aktiv markiert.


2.2.2 Webhook Abmeldung

Um das Abmelden vom Newsletter durch den in Maileon Mails integrierten Abmeldelink zu ermöglichen muss ebenfalls ein Webhook erstellt werden.

Wähle hierfür als Ereignis Abmeldung. Die URL muss hier dem Schema


https://meinShop.de/plugins/ws5_maileon/unsubscribe.php


entsprechen. Als URL Parameter muss hier ebenfalls mail mit dem Kontaktfeldwert E-Mail Adresse hinterlegt werden.

Klickt ein Kunde jetzt den Abmeldelink in einer Maileon Adresse wird er von den Newsletterempfängern im Shop gelöscht.



3. Einstellungen Plugin



Shop Formular - Maileon DOI

Hier kannst du auswählen, ob und welche der in Maileon aktiven DOI Mailings bei einer Anmeldung über den Shop gestartet werden soll. Verwendest du die Bestätigungs-Mail des Shop muss du hier Nein auswählen.


Shop DOI - Maileon Permission

Hier kannst du auswählen, welche Permission (Berechtigung) Nutzer erhalten, wenn du die DOI Bestätigung über den Shop realisierst.


Permission exportierte Kontakte

Hier kannst du auswählen, welche Permission die Nutzer bei Maileon erhalten sollen, wenn du bestehende Nutzer vom Shop zu Maileon exportierst.


Synchronisatzions Modus

Hier kannst du auswählen, ob bei Maileon bereits bestehende Kontakte beim exportieren geupdatet oder ignoriert werden sollen. Die Permission wird dabei nie reduziert sondern nur erhöht. 


Event Bestellung senden

Hier kannst du einstellen, ob beim Kaufabschluss das entsprechende Event an Maileon übergeben werden soll.


4. Kontaktereignisse 

Bei der Installation des Plugins werden folgende Ereignisse bei Maileon angelegt.

  • jtl_account_deleted - Löschen eines Kundenkontos im Shop
  • jtl_bestellung - Abschluss einer Bestellung
  • jtl_registration - Registrierung eines Kundenkontos im Shop
  • jtl_cart_abandonend - Warenkorbabbrecher eines registrierten Kunden


Du findest die Ereignisse unter Listen&Kontakte > Kontaktereignisse.

Welche Ereignisse ein Kontakt durchlaufen hat, kannst du beim jeweiligen Kontakt nachsehen.



4.1 Warenkorbabbrecher

Das Kontaktereignis wird ausgelöst, wenn ein registrierter Kunde Artikel für eine gewisse Zeit in seinem Warenkorb liegen hat, ohne diese auch zu kaufen. Anhand von diesem Event ist es dann möglich zB. Erinnerungsemails an den Kunden zu senden.


Damit die Warenkorbabbrecher funktionieren muss die Einstellung "Warenkorb speichern" im Shop-Backend  unter Darstellung -> Standardansichten -> Bestellvorgang -> Warenkorb aktiviert sein.




Über die Einstellungen des Plugins lassen sich zudem Einzelheiten konfigurieren. Die Wartezeit sagt aus wie lange ein Artikel bei einem Kunden im Warenkorb liegen muss bevor das Event ausgelöst wird.


Über die Ausschlusszeit ist es möglich festzulegen wie lang ein Kunde keine Warenkorbabbrecher E-Mail erhalten soll, wenn er bereits zuvor eine entsprechende E-Mail erhalten hat.





Tags: