Optilyz für Print-Nachrichten verwenden

4 min

Ü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.

Gehen Sie zu optilyz.com und loggen Sie sich in ihrem Konto ein.

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.

Gehen Sie zu optilyz.com und loggen Sie sich in ihrem Konto ein.

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).

Gehen Sie in Optimizely Campaign zu Verwaltung > App-Verbindungen.

Klicken Sie unter der Liste der App-Verbindungen auf Erstellen...

Geben Sie einen aussagekräftigen Namen ein (beispielsweise "Optilyz-Automatisierung ABC starten").

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.

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.

Erstellen Sie eine Marketing-Automation-Kampagne (Siehe Marketing Automation für Details).

Erstellen Sie einen App-Verbinden-Knoten.

Wählen Sie im App-Verbinden-Knoten ihre App-Verbindung für Optilyz aus.

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.

Speichern Sie die MA-Kampagne. → Die neue MA-Kampagne wird Print-Nachrichten über Optilyz versenden.