Optilyz für Print-Nachrichten verwenden

  • Aktualisiert

Überblick

Optilyz ist eine Drittanbieterlösung für den Versand von print-Nachrichten. In Optilyz definieren Sie Automatisierungen, d. h. Prozesse für den Versand von print-Nachrichten. Diese Automatisierungen können von einer Marketing-Automation-Kampagne über einen App-Verbinden-Knoten gestartet werden. Weitere Informationen über Optilyz finden Sie unter optilyz.com.

JSON-Struktur zum Übertragen von Empfängerdaten

Die Optilyz RESTful API akzeptiert Empfängerinformationen im JSON-Format. Details zur API finden Sie in der Optilyz API-Dokumentation. Der JSON-Text kann im Nachrichten-Body einer App-Verbindung definiert werden. Er kann Platzhalter für dynamische Werte aus einer Empfängerliste enthalten, die in geschweifte Klammern eingeschlossen sind (siehe App-Verbindungen).

Beispiele für Empfängerinformationen mit dynamischen Werten als JSON:

{
"address": {
"firstName": "{firstname}",
"lastName": "{lastname}",
"street": "{street}",
"houseNumber": "{streetnumber}",
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}",
"individualisation1": "{custom1}",
"individualisation2": "{custom2}",
"individualisation3": "{custom3}"
},
"variation": 1
}
{
"address": {
"fullName": "{name}",
"address1": "{streetwithstreetnumber}";
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}"
},
"variation": 1
}
{
"address": {
"companyName1": "{companyname}",
"companyName2": "{department}",
"address1": "{streetwithstreetnumber}";
"zipCode": "{zip}",
"city": "{city}",
"country": "{country}"
},
"variation": 1
}

Ihren Optilyz-API-Schlüssel finden

Kontext: Um eine Optilyz-Automatisierung von einer App-Verbindung starten zu lassen, benötigen Sie den API-Schlüssel ihres Optilyz-Kontos.

Voraussetzungen: Sie haben ein Optilyz-Konto.

  1. Gehen Sie zu optilyz.com und loggen Sie sich in ihrem Konto ein.
  2. Gehen Sie zum Menüpunkt Automatisierungen.
    → Sie finden ihren API-Schlüssel oberhalb der Liste.

Eine Optilyz-Automatisierungs-ID finden

Kontext: Um eine Optilyz-Automatisierung von einer App-Verbindung starten zu lassen, benötigen sie die Automatisierungs-ID.

Voraussetzungen: Sie haben ein Optilyz-Konto und haben eine Automatisierung erstellt.

  1. Gehen Sie zu optilyz.com und loggen Sie sich in ihrem Konto ein.
  2. Klicken Sie auf die Automatisierung, die aus einer Marketing-Automation-Kampagne heraus gestartet werden soll.
    → Sie sehen ihre Automatisierungs-ID oben auf der Seite.

Eine App-Verbindung für Optilyz erstellen

Voraussetzungen: Sie kennen den API-Schlüssel ihres Optilyz-Kontos und die Automatisierungs-ID der Automatisierung, die sie benutzen möchten. Sie haben den JSON-Code für die Übertragung von Empfängerinformationen zu Optilyz vorbereitet (siehe oben).

  1. Gehen Sie in Optimizely Campaign zu Verwaltung > App-Verbindungen.
  2. Klicken Sie unter der Liste der App-Verbindungen auf Erstellen...
  3.  Geben Sie einen aussagekräftigen Namen ein (beispielsweise "Optilyz-Automatisierung ABC starten").
  4. Konfigurieren Sie die App-Verbindung so:
    HTTP Methode: POST
    URL: https://www.optilyz.com/api/v2/automations/[Optilyz-Automatisierungs-ID]/recipient
    Authentifizierungsmethode: Basisauthentifizierung
    Content-Typ: application/json
    Nachrichten-Body: JSON code für die Übertragung von Empfängerdaten. Hinweis: Stellen Sie sicher, dass alle notwendigen Felder für die Automatisierung im JSON-Code zugewiesen werden!
    Benutzername: Ihr Optilyz-API-Schlüssel im Format base64.
    Password: Nicht erforderlich, lassen Sie das Feld leer.
  5. Klicken Sie auf Speichern.
    → Die neue App-Verbindung ist verfügbar, wenn Sie im Kampagnen-Editor von Marketing Automation einen App-Verbinden-Knoten einfügen.

Eine Optilyz-Automatisierung in einer MA-Kampagne benutzen

Voraussetzungen: Sie haben eine App-Verbindung für das Starten einer Optilyz-Automatisierung eingerichtet.

  1. Erstellen Sie eine Marketing-Automation-Kampagne (Siehe Marketing Automation für Details).
  2. Erstellen Sie einen App-Verbinden-Knoten.
  3. Wählen Sie im App-Verbinden-Knoten ihre App-Verbindung für Optilyz aus.
  4. Vervollständigen Sie ihre MA-Kampagne und stellen Sie sicher, dass die Empfängerdaten alle benötigten Felder für den Versand von Print-Nachrichten enthalten.
  5. Speichern Sie die MA-Kampagne.
    → Die neue MA-Kampagne wird Print-Nachrichten über Optilyz versenden.