eesii für print-Nachrichten konfigurieren

  • Aktualisiert

Überblick

eesii ist eine Drittanbieterlösung für Print-Nachrichten. In eesii definieren Sie Prozesse, (Kampagnen) zum Versenden von Print-Nachrichten. Diese eesii-Kampagnen können über einen App-Verbindungs-Knoten aus einer Marketing-Automation-Kampagne in Optimizely Campaign gesteuert werden. Weitere Informationen zu eesii finden Sie unter eesii.com/de/produkt.

eesii hat eine REST-API, über die print-Nachrichten mit Empfängerdaten aus Optimizely Campaign versendet werden können. Dazu benötigen Sie einen eesii-API-Schlüssel und eine eesii-Kampagnen-ID.

Ihren eesii-API-Schlüssel finden

Kontext: Um eine eesii-Kampagne über eine App-Verbindung zu steuern, benötigen Sie den API-Schlüssel Ihres eesii-Kontos.
Voraussetzungen: Sie haben ein eesii-Konto und Zugriff auf eine eesii-Kampagne.

  1. Klicken Sie im eesii-Hauptmenü auf Kampagne.
  2. Falls erforderlich: Wechseln Sie zu einem anderen Tab, um Ihre Kampagnen zu sehen.
  3. Klicken Sie in der Liste der Kampagnen auf eine beliebige Kampagne.
    → Die Kampagnendetails werden angezeigt.
  4. Klicken Sie auf Webhook generieren.
    → Die Webhook-Details werden angezeigt, darunter auch Ihr eesii-API-Schlüssel.

Eine eesii-Kampagnen-ID finden

Kontext: Um eine eesii-Kampagne über eine App-Verbindung zu steuern, benötigen Sie die Kampagnen-ID.
Voraussetzungen: Sie haben ein eesii-Konto und Zugriff auf eine eesii-Kampagne.

  1. Klicken Sie im eesii-Hauptmenü auf Kampagne.
  2. Falls erforderlich: Wechseln Sie zu einem anderen Tab, um die gewünschte Art von Kampagnen zu sehen.
  3. Klicken Sie in der Liste der Kampagnen auf den Eintrag für die gewünschte Kampagne.
    → Die Kampagnendetails werden angezeigt.
  4. Klicken Sie auf Webhook generieren.
    → Die Webhook-Details werden angezeigt, darunter auch die Kampagnen-ID.

JSON-Daten in API-Anfragen

Die eesii-API verarbeitet POST-Anfragen mit Informationen im JSON-Format. Wenn Sie Optimizely Campaign zum Senden solcher API-Anfragen verwenden, können Sie den JSON-Code im Nachrichten-Body einer App-Verbindung definieren. Dieser JSON-Code kann Platzhalter für dynamische Werte aus einer Empfängerliste enthalten, die in geschweiften Klammern stehen.

Nachfolgend finden Sie ein Beispiel für JSON-Daten in einer eesii-API-Anfrage. Dynamische Werte in geschweiften Klammern {} werden verwendet, um die Daten für einzelne Empfänger aus der Empfängerliste in Optimizely Campaign abzurufen. Die Layout-ID und die Kampagnen-ID für die eesii-Kampagne sind als feste Werte enthalten.

{
  "record": {
    "First Name": "{firstname}",
    "Last Name": "{lastname}",
    "Straße": "{street}",
    "Nr": "{streetnumber}"
    "Zip Code": "{zipcode}"
    "Place": "{place}"
    "layoutId": "abc",
    "campaignId": "xyz"
  }
}

Eine App-Verbindung für eesii erstellen

Voraussetzungen: Sie kennen den API-Schlüssel für Ihr eesii-Konto und die Kampagnen-ID der eesii-Kampagne, die Sie verwenden möchten.

  1. Gehen Sie in Optimizely Campaign zu Administration > App-Verbindungen.
  2. Klicken Sie unterhalb der Liste der App-Verbindungen auf Erstellen...
  3. Geben Sie einen aussagekräftigen Namen ein (z. B. „Trigger für eesii-Kampagne ABC“).
  4. Konfigurieren Sie die API-Anfrage:
    HTTP-Methode: POST
    URL: https://eesii.com/api/v1/campaigns/singlerecord
    Authentifizierungsmethode: Schlüsselauthentifizierung
    Inhaltstyp: application/json
    Nachrichtentext: Empfängerinformationen als JSON-Code, siehe JSON-Struktur für Empfängerinformationen oben.
    Authentifizierungsschlüssel: Geben Sie hier den Text „eesii-apikey“ ein.
    Authentifizierungswert: Ihr eesii-API-Schlüssel
  5. Klicken Sie auf Speichern.
    → Die neue App-Verbindung kann jetzt in einer Marketing-Automation-Kampagne verwendet werden.

Senden von Print-Nachrichten aus einer MA-Kampagne

Kontext: Ein einfacher Anwendungsfall ist das Senden einer Print-Nachricht, wenn ein neuer Empfänger zu einer bestimmten Empfängerliste hinzugefügt wird. Natürlich können Sie mit Marketing Automation auch andere, komplexere Kampagnen konfigurieren.
Voraussetzungen: Sie haben eine App-Verbindung für das Senden von Print-Nachrichten über eesii vorbereitet, siehe Eine App-Verbindung für eesii erstellen oben.

  1. Erstellen Sie eine Marketing-Automation-Kampagne.
  2. Fügen Sie einen App-Verbindungs-Knoten hinzu.
  3. Wählen Sie im App-Verbindungs-Knoten Ihre App-Verbindung für eesii aus.
  4. Stellen Sie die MA-Kampagne fertig und achten Sie darauf, dass der App-Verbindungsknoten die erforderlichen Empfängerdaten erhält.
  5. Speichern Sie die MA-Kampagne.
    → Die neue MA-Kampagne löst das Senden von print-Nachrichten über eesii aus.

Eine eesii-Kampagne testen (softproof)

Kontext: Testen Sie, ob Ihre Kombination aus Marketing Automation und eesii wie erwartet funktioniert, bevor Sie print-Nachrichten versenden.
Voraussetzungen: Sie haben eine Marketing Automation-Kampagne vorbereitet, um print-Nachrichten über eesii zu senden. Ihre eesii-Kampagne ist vollständig konfiguriert und befindet sich im Entwurfsstatus.

  1. Führen Sie in Optimizely Campaign eine Aktion aus, die den App-Verbindungs-Knoten für eesii in Ihrer Marketing-Automation-Kampagne aktiviert.
  2. Öffnen Sie auf eesii.com Ihre Print-Kampagne.
  3. Überprüfen Sie, ob ein Testlauf angezeigt wird, welcher zu der in Optimizely Campaign ausgeführten Aktion gehört.
    Hinweis: Es kann einige Minuten dauern, bis die API-Anfrage aus Optimizely Campaign von eesii verarbeitet wurde.
  4. Klicken Sie in der Zeile des Testlaufs auf PDF herunterladen und öffnen Sie die Datei.
  5. Überprüfen Sie, ob das Layout und die Empfängerdaten wie erwartet gerendert werden.
  6. Wenn alles in Ordnung ist, aktivieren Sie das Häkchen, um zu bestätigen, dass Sie die PDF-Datei von eesii (auch Softproof genannt) überprüft haben.
  7. Klicken Sie auf Kampagne aktivieren.
    → Die eesii-Kampagne ist nun bereit zum Senden.