---
title: Optilyz für Print-Nachrichten verwenden
slug: campaign/docs/optilyz-fpercentc3percentbcr-print-nachrichten-verwenden
docTags: 
createdAt: 2026-08-06T15:53:57.193Z
---

## Ü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](docId\:u1JjXABfIuf6zf6ixuTy6) gestartet werden. Weitere Informationen über Optilyz finden Sie unter [optilyz.com](https://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](https://www.optilyz.com/doc/api/#api-Recipients-EnqueueOneRecipient). 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](docId\:u1JjXABfIuf6zf6ixuTy6)).

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

```javascript
{
"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](docId\:kKf0hUWG54s6j9EYutrxe)).

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](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](docId\:rH-CVuXsKjRWjl4DSmNsl) 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.