Die Optimizely-Campaign-Integration für Make

  • Aktualisiert

Grundlagen

Zweck

Make ist eine Automatisierungsplattform für die Verbindung verschiedener Anwendungen und Dienste zur Automatisierung von Aufgaben. Bitte lesen Sie die Make-Benutzerdokumentation, um mehr über Make zu erfahren. Die Seite Create your first scenario bietet einen guten Ausgangspunkt. Im Folgenden liegt der Schwerpunkt auf der Verwendung von Optimizely Campaign als App innerhalb von Make. Sie sollten die Grundlagen von Make verstehen, bevor Sie fortfahren.

Die Nutzung der Webhooks, die in der Campaign-App in Make bereitgestellt werden, ist kostenlos.

Triggers and Actions

Die Optimizely-Campaign-App in Make stellt zwei Arten von Objekten bereit:

  • Trigger, die auf Ereignissen in Optimizely Campaign basieren und genutzt werden, um Make-Szenarien (Workflows) zu steuern,
  • Aktionen in Optimizely Campaign, die in Szenarien benutzt werden können.

Wenn Sie in Make ein Modul zu einem Szenario hinzufügen, suchen Sie nach "Optimizely Campaign", um zu Campaign gehörige Trigger und Aktionen zu finden.

Voraussetzungen

Benutzerkonto

Folgende Anforderungen müssen erfüllt sein, damit Sie die Optimizely-Campaign-Integration in Make benutzen können:

  • Wenn Sie sich in der DACH-Region befinden, benötigen Sie einen Optimizely Campaign API-Benutzer, der die Rolle bm - Webservice User Integration-Platform hat.

  • Wenn Sie sich außerhalb der DACH-Region befinden, benötigen Sie einen Optimizely Campaign API-Benutzer, der die Rolle epi - Webservice User Integration-Platform hat.

  • Sie haben die Anmeldedaten für diesen API-Benutzer.

  • Sie können sich mit einem anderen Benutzerkonto bei Optimizely Campaign anmelden (nicht zwingend erforderlich, aber sehr empfehlenswert, um Ihre Szenarien zu testen).

  • Sie haben ein Benutzerkonto auf make.com.

Die Anmeldedaten des API-Benutzers werden von Make für die Kommunikation mit Optimizely Campaign verwendet. Wenn Sie sich in der DACH-Region befinden, hilft Ihnen der Optimizely-Support bei der Erstellung eines Campaign-API-Benutzers mit der erforderlichen Rolle. Wenn Sie sich außerhalb der DACH-Region befinden, können Sie dies über die Self-Service-Funktion tun. Bei Problemen wenden Sie sich bitte an den Support.

Mit vielen Postfachanbietern können Sie E-Mail-Unteradressen verwenden, um einen solchen Benutzer schnell zu erstellen, z. B. wenn Ihre Adresse first.last@example.com lautet, können Sie den Benutzer first.last+make@example.com als neuen Benutzer in Optimizely Campaign erstellen. Auch wenn die Benutzer unterschiedlich sind, werden E-Mail-Nachrichten für beide Adressen in Ihrem Posteingang für first.last@example.com ankommen.

Eine Verbindung einrichten

Kontext: Aktionen und Polling-basierte Trigger, die mit Optimizely Campaign zusammenhängen, erfordern, dass Sie eine Verbindung zwischen Make und Campaign auswählen oder erstellen.
Voraussetzungen: Sie sind in Make angemeldet und sehen den Szenario-Editor.

  1. Fügen Sie ein Modul hinzu oder wählen Sie ein Modul aus, das eine Verbindung erfordert.
    → Die Eigenschaften des neuen Moduls werden angezeigt.
  2. Klicken Sie neben dem Feld Verbindung auf Hinzufügen.
    → Die Eigenschaften der neuen Verbindung werden angezeigt.
  3. Geben Sie einen Namen für die Verbindung ein.
  4. Geben Sie die E-Mail und das Passwort des API-Benutzers ein.
  5. Geben Sie die Client-ID ein (siehe die Seite API-Übersicht in Campaign).
  6. Klicken Sie auf Speichern.

Trigger und Aktionen

Überblick

Wenn Sie ein Modul zu einem Make-Szenario hinzufügen, können Sie Trigger und Ereignisse hinzufügen, um zu steuern, was passieren soll und wann es passieren soll. Die folgenden Trigger werden von Optimizely Campaign bereitgestellt:

  • Watch Bounces
  • Watch Recipients
  • Watch Spam Complaints
  • Watch Unsubscribes

Folgende Aktionen werden von Optimizely Campaign bereitgestellt:

  • Create a Recipient
  • Make an API call
  • Send Transactional Message
  • Update a Recipient

Um einen Prozess zu automatisieren, an dem Optimizely Campaign und eine andere Anwendung beteiligt sind, erstellen Sie ein Szenario, das einen Trigger oder ein Ereignis aus Optimizely Campaign mit einem Trigger oder einem Ereignis aus der anderen Anwendung kombiniert.

Der Trigger Watch Bounces

Dieser Trigger wird aktiviert, wenn im Campaign-Client aus der verwendeten Verbindung ein Bounce registriert wird. Er verwendet Webhooks, so dass er bei einem Bounce sofort ausgelöst wird. Der Trigger stellt für nachfolgende Aktionen die Daten bereit, die für Bounce-Webhooks verfügbar sind, siehe Webhooks.

Der Trigger Watch Recipients

Dieser Trigger wird aktiviert, wenn ein neuer Empfänger in einer bestimmten Empfängerliste erstellt wird. Er verwendet Polling, so dass die Intervalle für die Überprüfung auf neue Empfänger konfiguriert werden müssen. Er hat folgende Optionen:

  • Connection (erforderlich): Wählen oder erstellen Sie eine Verbindung zu Optimizely Campaign.
  • Limit (erforderlich): Legen Sie die maximale Anzahl der Ergebnisse fest, mit denen während einer Ausführung gearbeitet werden soll.
  • Recipient List ID (erforderlich): Wählen Sie die Empfängerliste aus, die durch den Trigger überwacht wird.
  • Recipient List attributes: Wählen Sie ein oder mehrere Felder aus der ausgewählten Empfängerliste aus. Die Werte der ausgewählten Felder können in nachfolgenden Modulen verwendet werden.
  • Include Opt-in Data: Geben Sie an, ob die Opt-in-Datenfelder angefordert werden sollen. Gilt nur für Opt-in-Listen.

Der Trigger Watch Spam complaints

Dieser Trigger wird aktiviert, wenn im Campaign-Client aus der verwendeten Verbindung eine Spam-Beschwerde registriert wird. Er verwendet Webhooks, so dass er bei einer Spam-Beschwerde sofort ausgelöst wird. Der Trigger versorgt nachfolgende Aktionen mit den Daten, die für Spam-Beschwerde-Webhooks verfügbar sind, siehe Webhooks.

The trigger Watch Unsubscribes

Dieser Trigger wird aktiviert, wenn im Campaign-Client aus der verwendeten Verbindung eine Abmeldung registriert wird. Er verwendet Webhooks, so dass er bei einer Abmeldung sofort ausgelöst wird. Der Trigger versorgt nachfolgende Aktionen mit den Daten, die für Spam-Beschwerde-Webhooks verfügbar sind, siehe Webhooks.

Die Aktion Create a Recipient

Diese Aktion dient zum Erstellen eines neuen Empfängers in Campagn. Sie hat folgende Optionen:

  • Connection (erforderlich): Der Campaign-Mandant und die Anmeldedaten für Ihren API-Benutzer.
  • Recipient List ID: Die Empfängerliste, die Sie bearbeiten möchten.
  • Recipient ID: In der Regel die E-Mail-Adresse.
  • Adress: Die E-Mail-Adresse des Empfängers. Erforderlich, wenn die Empfänger-ID nicht die E-Mail-Adresse ist.
  • Primary Key: Der Primärschlüssel der ausgewählten Empfängerliste. Achten Sie darauf, dass Sie den richtigen auswählen.
  • Recipient Data: Eine Reihe von Feldern, die in der ausgewählten Empfängerliste verfügbar sind.
  • Opt-in process ID: Wählen Sie einen Opt-in-Prozess, der für das Hinzufügen von Empfängern zu Ihrer Liste geeignet ist.
  • Return Opt-in Mail ID: Ruft die Mail-ID für einen Opt-in-Prozess vom Typ double oder confirmed ab und stellt diese ID für nachfolgende Module im Szenario bereit.

Die Aktion Make an API Call

Diese Aktion kann einen API-Aufruf an Optimizely Campaign senden und ermöglicht es Ihnen, alle Funktionen der APIs von Campaign in einem Make-Szenario zu nutzen. Konfigurieren Sie sie entsprechend dem Endpunkt-Design der API, die Sie adressieren.

Die Aktion Send Transactional Message

Diese Aktion dient dazu, eine Transaktionsnachricht über Optimizely Campaign zu versenden. Sie hat folgende Optionen:

  • Connection (erforderlich): Der Campaign-Mandant und die Anmeldedaten für Ihren API-Benutzer.
  • Transactional Mail (erforderlich): Die Transaktionskampagne, die Sie für den Versand von Nachrichten verwenden möchten.
  • Recipient List ID (erforderlich): Die Empfängerliste, welche die Transaktionskampagne verwenden soll.
  • RecipientID (erforderlich): Die ID des Empfängers der transaktionalen Nachricht. Diese muss als Primärschlüssel in der Empfängerliste gültig sein (normalerweise eine E-Mail-Adresse).
  • Primary Key (erforderlich): Der Primärschlüssel der ausgewählten Empfängerliste. Achten Sie darauf, dass Sie den richtigen auswählen.
  • Recipient Data: Eine Reihe von Feldern, die in der ausgewählten Empfängerliste verfügbar sind.

Die Aktion Update a Recipient

Diese Aktion ähnelt der Aktion Create a Recipient, dient aber zur Bearbeitung eines bereits vorhandenen Empfängers. Sie hat folgende Optionen:

  • Connection (erforderlich): Der Campaign-Mandant und die Anmeldedaten für Ihren API-Benutzer.
  • Recipient List ID (erforderlich): Die Empfängerliste, die Sie bearbeiten möchten.
  • Recipient ID: Die ID des Empfängers, den Sie aktualisieren möchten, normalerweise die E-Mail-Adresse.
  • Primary Key: Der Primärschlüssel der ausgewählten Empfängerliste. Achten Sie darauf, dass Sie den richtigen auswählen.
  • Recipient Data: Eine Reihe von Feldern, die in der ausgewählten Empfängerliste verfügbar sind.
  • Mode: Hier wählen Sie aus, wie die Felder bearbeitet werden sollen: Set überschreibt vorhandene Feldwerte; Prepend setzt den neuen Inhalt an den Anfang des vorhandenen Feldwertes; Append setzt ihn ans Ende.