App-Verbindungen

Grundlagen

Überblick

Mit App-Verbindungen können Sie Daten und Befehle aus einer Marketing-Automation-Kampagne an externe Anwendungen senden. Diese Funktion ist momentan als öffentliche Beta-Version verfügbar.

App-Verbindungen sind mit Webhooks verwandt, aber funktionieren etwas anders: Webhooks werden per API definiert und von Aktionen eines Empfängers ausgelöst. App-Verbindungen dagegen werden in der Optimizely Campaign-Benutzeroberfläche definiert und ausgelöst, wenn ein Empfänger einen bestimmten Knoten in einer Marketing Automation-Kampagne erreicht.

Eine App-Verbindung enthält einen Satz von Parametern, die eine HTTP-Anfrage definieren. Jede App-Verbindung wird zuerst auf der Seite App-Verbindungen konfiguriert und kann dann im Kampagneneditor von Marketing Automation verwendet werden, indem Sie einen App-Verbinden-Knoten einfügen.

Wenn ein Empfänger einen App-Verbinden-Knoten erreicht, wird die definierte HTTP-Anfrage an die externe Anwendung gesendet. Dies kann auf bestimmte Zielgruppen begrenzt werden.

Seite App-Verbindungen öffnen

Voraussetzungen: Sie sind in Optimizely Campaign angemeldet. Sie haben die Berechtigung App-Verbindungen zu sehen.

1. Klicken Sie in der Menüleiste auf Verwaltung.
2. Klicken Sie auf App-Verbindungen.
   → Die Seite App-Verbindungen wird angezeigt.

Eigenschaften von HTTP-Anfragen aus App-Verbindungen

Authentifizierung

Aktuell verwenden alle App-Verbindungen eine Authentifizierung mit Namen und Passwort. Wenn die Felder Benutzername und Passwort auf der Seite App-Verbindung bearbeiten leer sind, sendet die App-Verbindung HTTP-Anfragen mit einem leeren Authentifizerungs-String.

Eine zukünftige Version wird mehrere Authentifizierungsmethoden unterstützen:

• ohne Authentifizierungs-String.
• einfache Authentifizierung mit Name und Passwort (bereits verfügbar).
• schlüsselbasierte Authentifizierung.

Content-Typ

Aktuell verwenden alle HTTP-Anfragen mit der Methode POST den Content-Typ application/json. Anfragen vom Typ GET enthalten keine Angabe des Content-Typs. Eine zukünftige Version wird weitere Optionen für Content-Typen anbieten.

Vorbereitung von App-Verbindungen

Einstellungen und Platzhalter für dynamische Werte

App-Verbindungen werden auf der Seite App-Verbindung erstellen konfiguriert. In mehreren Textfeldern werden die Elemente der HTTP-Anfrage definiert, die von der App-Verbindung gesendet werden soll.

In den meisten Anwendungsfällen für App-Verbindungen sollen Daten aus einer laufenden Kampagne an eine externe Anwendung gesendet werden. Zu diesem Zweck dienen Platzhalter, mit denen Sie Werte aus einer Empfängerliste in die HTTP-Anfrage einfügen können. Jeder Platzhalter referenziert einen Wert aus einer einzelnen Spalte in einer Empfängerliste. Wenn ein Empfänger einen App-Verbinden-Knoten erreicht, wird der Wert aus der Spalte für diesen Empfänger an die Stelle des Platzhalters gesetzt.

Platzhalter können in den Feldern für URL-Parameter verwendet werden. Im Feld URL funktioniert die Ersetzung von Platzhaltern mit dynamischen Werten nicht.

Verwenden Sie für Platzhalter den internen Namen des Empfängerlistenfeldes in geschweiften Klammern, verwenden Sie nicht den Anzeigenamen! Der interne Name ist auf der Seite Empfängerlisten sichtbar.

App-Verbindung erstellen

Voraussetzungen: Sie sehen die Seite App-Verbindungen. Sie sind berechtigt, App-Verbindungen zu bearbeiten. Sie wissen, wie sie die externe Anwendung mit einer HTTP-Anfrage ansprechen müssen (wenn Sie eine Optimizely Campaign API ansprechen möchten, siehe API-Übersicht).

1. Klicken Sie unter der Liste der App-Verbindungen auf Erstellen.
   → Die Seite App-Verbindung erstellen wird angezeigt.
2. Geben Sie einen Namen ein.
3. Wählen Sie die passende HTTP-Methode.
4. Geben Sie die URL für die HTTP-Anfrage ein. Fügen Sie kein "?" und keine Parameter im Feld URL ein!
5. Falls Sie die HTTP-Methode POST verwenden, geben Sie den Nachrichten-Body ein.
6. Falls erforderlich: Geben Sie einen Benutzernamen und ein Passwort ein.
7. Optional: Geben Sie ein Schlüssel-Wert-Paar ein, dass als URL-Parameter hinzugefügt werden soll.
8. Optional: Klicken Sie auf und geben Sie weitere Schlüssel-Wert-Paare ein.
9. Klicken Sie auf Speichern.
   → Die neue App-Verbindung steht im App-Verbinden-Knoten im Kampagneneditor von Marketing Automation zur Verfügung.

App-Verbindung bearbeiten

Voraussetzungen: Sie sehen die Seite App-Verbindungen. Sie sind berechtigt, App-Verbindungen zu bearbeiten.

1. Klicken Sie in der Liste auf die App-Verbindung, die Sie bearbeiten möchten.
   → Der ausgewählte Eintrag wird hervorgehoben.
2. Klicken Sie unter der Liste auf Bearbeiten...
   → Die Seite App-Verbindung Bearbeiten wird angezeigt.
3. Passen Sie die Parameter an (siehe App-Verbindung erstellen oben).
4. Klicken Sie auf Speichern.
   → Die Änderungen werden gespeichert.

Verwendung von App-Verbindungen in MA-Kampagnen

App-Verbinden-Knoten hinzufügen

Voraussetzungen: Sie haben eine MA-Kampagne erstellt oder geöffnet und sehen den Kampagneneditor.

1. Ziehen Sie einen App-Verbinden-Knoten aus dem Seitenbereich in den Design-Bereich.
2. Um den Knoten mit anderen Knoten in ihrer Kampagne zu verbinden, klicken Sie auf einen der Griffe an den Seiten des Knoten und ziehen Sie eine Verbindung zu einem anderen Knoten.
   → Die Kampagne enthält einen App-Verbinden-Knoten.

App-Verbinden-Knoten konfigurieren

Voraussetzungen: Sie haben eine App-Verbindung konfiguriert.  Sie sehen eine Marketing-Automation-Kampagne mit einem App-Verbinden-Knoten im Kampagneneditor.

1. Bewegen Sie den Mauszeiger über den App-Verbinden-Knoten.
2. Klicken Sie auf (properties).
   → Ein pop-up-Menü wird angezeigt.
3. Wählen Sie im Feld App-Verbindung die gewünscht App-Verbindung.
4. Optional: Wenn Sie die App-Verbindung nicht für jeden Benutzer, der den Knoten erreicht, ausführen möchten, sondern nur für bestimmte Zielgruppen, dann wählen Sie im Feld Aktion ausführen nur für eine Zielgruppe aus.
5. Speichern Sie die Kampagne.