Was ist das externe Lexpad und wie verwende ich es? MAX

Externes Lexpad verwenden

MAX-Kunden können ein Tool namens External Lexpad nutzen, das in Kombination mit Automation Events die Erstellung von benutzerdefinierten Ereignissen ermöglicht, die mit Standard-Tools nicht möglich sind. Dieses Tool ist besonders nützlich für Kunden, die keine der gängigen E-Commerce-Plattformen nutzen, in die wir integrieren, oder die Workflows und Nachrichten erstellen müssen, die über die Möglichkeiten dieser Integrationen hinausgehen. Beispiele für Szenarien, die von unseren Kunden mit External Lexpad erstellt wurden, sind:

  • Ein Unternehmen aus dem Gastgewerbe, das Nachrichten über stornierte Hotelreservierungen versendet.
  • Ein Glücksspielunternehmen, das den Nutzern seines Prämienprogramms den verfügbaren Punktestand mitteilt.
  • Ein Reiseunternehmen, das Gutscheine basierend auf dem Standort des Nutzers versendet.
  • Ein Immobilienunternehmen, das Angebote basierend auf dem Standort des Nutzers versendet.

Wichtige Überlegungen

  • Anforderungen an den Entwickler: Du brauchst einen Entwickler, der sich mit API und JSON auskennt. Unsere Customer Solutions Architects können zwar bei dem Prozess helfen, aber auf Kundenseite ist technisches Fachwissen erforderlich.
  • Zuständigkeiten: Customer Solution Architects helfen beim Einrichten des Ablaufs, beim Testen der Nachricht, beim Überprüfen des Endpunkts, beim Abrufen von Informationen, beim Kombinieren der erforderlichen Daten in der Datenbank und beim Strukturieren des JSON, falls erforderlich. Sie sind jedoch nicht für den endgültigen Inhalt und das Ergebnis der Nachricht verantwortlich. Kunden sollten Workflows vor dem Start gründlich testen.

Anforderungen an den Endpunkt

Externes Lexpad benötigt einen Endpunkt, der die folgenden Kriterien erfüllt:

  • Der WebService muss innerhalb von 4 Sekunden antworten.
  • Die Antwortgröße darf 32 KB nicht überschreiten.
  • Lexpad muss im JSON-Format sein und den Zeichensatz UTF-8 verwenden.
  • Die Top-Level-Struktur muss ein JSON-Objekt sein. Arrays oder reine Werte sind nicht erlaubt.
  • Der Endpunkt muss für die hier aufgeführten IPs erreichbar sein: IP-Bereiche.

Um die Verbindung herzustellen, müssen uns die Details des Endpunkts mitgeteilt werden. Außerdem musst du uns über jede Nachricht informieren, die du verbinden willst.

Richtlinien für die Nachricht

Die Nachricht sollte eine Automation-Nachricht sein, da das Hinzufügen des External Lexpad manuell erfolgt. Bei Newslettern können Ausnahmen gemacht werden. Bitte benachrichtige uns jedoch mindestens 24 Stunden, bevor die Nachricht versendet werden soll. Eine Dokumentation über die Syntax für Dynamischen Content im External Lexpad findest du hier: Externe Lexpad-Dokumentation.

Automation Workflow

Es gibt keine besonderen Regeln für den Workflow, solange die Nachricht über einen solchen versendet wird. Die einzige Einschränkung ist, dass eine Nachricht nicht gleichzeitig External Lexpad und Variablen aus Events oder E-Commerce-Elementen verwenden kann, da diese das interne Lexpad nutzen. Im Folgenden findest du ein Beispiel für einen möglichen Workflow:

Lexpad-Hilfe

  • Bitte stelle eine Nachricht oder eine Nachrichtenvorlage mit Platzhaltern für die External Lexpad-Werte zur Verfügung. Wenn die Platzhalter nicht eindeutig sind, gib detaillierte Anweisungen, wo jeder Wert zugeordnet werden soll.
  • Gib die Endpunktdetails an, die mit der Nachricht verbunden werden sollen.
  • Wenn die IP-Adressen, die auf den Endpunkt zugreifen, begrenzt sind, gib eine JSON-Beispielantwort als Textdatei an. Dies hilft Customer Solutions Architects beim Einrichten und Testen des dynamischen Contents.
  • Wir fügen eine Test-E-Mail-Adresse zu einer Liste in deinem Konto hinzu und deine JSON-Antwort sollte für diese Adresse gesendet werden.
  • Wenn das Lexpad eine Liste von Elementen zurückgibt (z. B. Angebote), sollte die Beispielantwort mehrere Werte enthalten, um eine korrekte Darstellung zu gewährleisten.
  • Wenn du Bilder einfügst (z. B. Vorschaubilder für Angebote), solltest du in der JSON-Antwort Bildlinks und die gewünschten Abmessungen angeben.

Bearbeitungszeit

Die Bearbeitung der Nachricht kann je nach Arbeitsaufkommen etwa 2 Arbeitstage dauern. Customer Solution Architects können während dieses Prozesses Fragen stellen oder Vorschläge machen. Obwohl sie sich bemühen, dass die Nachricht korrekt funktioniert, sollten die Kunden die Nachricht testen, um sicherzustellen, dass sie wie erwartet angezeigt wird, bevor sie sie an ihre Kontakte senden.