Anwendungsbeispiel use-case
Im folgenden Anwendungsbeispiel wird gezeigt, wie Sie einen Workflow mit Parametern innerhalb Ihrer Workflows abrufen können.
Dabei soll ein Workflow durch einen API-Aufruf mit externen Parametern ausgelöst werden. Durch diesen Workflow werden aus einer Datei Daten in Ihre Datenbank geladen und eine entsprechende Audience erstellt. Nach der Erstellung der Audience wird ein zweiter Workflow ausgelöst, durch den eine Nachricht gesendet wird, die mit den externen, im API-Aufruf definierten Parametern personalisiert wurde.
Führen Sie dazu folgende Aktionen aus:
- Führen Sie einen API-Aufruf aus, um Workflow 1 mit externen Parametern auszulösen. Siehe Schritt 1: API-Aufruf konfigurieren.
- Erstellen Sie Workflow 1: Mit dem Workflow wird eine Datei übertragen und in die Datenbank geladen. Danach wird getestet, ob die Daten leer sind oder nicht, und schließlich werden die Profile in der Audience gespeichert. Abschließend wird Workflow 2 ausgelöst. Siehe Schritt 2: Workflow 1 konfigurieren.
- Erstellen Sie Workflow 2: Mit diesem Workflow wird die Zielgruppe gelesen, die in Workflow 1 erstellt wurde. Danach wird eine personalisierte Nachricht an die Profile gesendet, wobei ein Segment-Code verwendet wird, in den die Parameter eingefügt werden. Siehe Schritt 3: Workflow 2 konfigurieren.
Voraussetzungen prerequisites
Vor dem Konfigurieren des Workflows müssen Workflow 1 und 2 jeweils mit der Aktivität Externes Signal erstellt werden. Auf diese Weise können Sie diese Signalaktivitäten auswählen, wenn Sie die Workflows aufrufen.
Schritt 1: API-Aufruf konfigurieren step-1--configuring-the-api-call
Führen Sie einen API-Aufruf aus, um Workflow 1 mit Parametern auszulösen. Weiterführende Informationen zur Syntax des API-Aufrufs finden Sie in der Dokumentation zu Campaign Standard-REST-APIs.
In diesem Beispiel soll der Workflow mit den unten stehenden Parametern aufgerufen werden:
- fileToTarget: der Name der Datei, die in die Datenbank importiert werden soll.
- discountDesc: die Beschreibung, die im Versand für den Rabatt angezeigt werden soll.
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
Schritt 2: Workflow 1 konfigurieren step-2--configuring-workflow-1
Workflow 1 wird folgendermaßen erstellt:
- Aktivität Externes Signal; Hier müssen die externen Parameter deklariert werden, damit sie im Workflow verwendet werden können.
- Aktivität Dateiübertragung: Importiert die Datei mit dem in den Parametern definierten Namen.
- Aktivität Datei laden: Lädt Daten aus der importierten Datei in die Datenbank.
- Aktivität Daten-Update: Fügt Daten aus der importierten Datei in die Datenbank ein oder aktualisiert die Datenbank.
- Aktivität Test: Prüft, ob importierte Daten verfügbar sind.
- Aktivität Audience-Speicherung: Wenn die Datei Daten enthält, werden die Profile in einer Audience gespeichert.
- Aktivität Ende: Ruft Workflow 2 mit den gewünschten Parametern auf.
Führen Sie zur Konfiguration des Workflows die folgenden Schritte aus:
-
Deklarieren Sie die im API-Aufruf definierten Parameter. Öffnen Sie dazu die Aktivität Externes Signal und fügen Sie dann die Namen und Typen der Parameter hinzu.
-
Fügen Sie die Aktivität Dateiübertragung hinzu, um Daten in die Datenbank zu importieren. Ziehen Sie dazu die Aktivität in den Arbeitsbereich, öffnen Sie sie und wählen Sie den Tab Protokoll aus.
-
Wählen Sie die Option Dynamischen Dateipfad verwenden aus und verwenden Sie dann den Parameter fileToTarget als die zu übertragende Datei:
code language-none $(vars/@fileToTarget)
-
Laden Sie die Daten aus der Datei in die Datenbank.
Ziehen Sie dazu die Aktivität Datei laden in den Workflow und konfigurieren Sie sie nach Bedarf.
-
Fügen Sie Daten aus der importierten Datei in die Datenbank ein und aktualisieren Sie die Datenbank.
Ziehen Sie dazu die Aktivität Daten-Update in den Arbeitsbereich und wählen Sie den Tab Identifizierung aus, um ein Abstimmkriterium hinzuzufügen (in diesem Fall das Feld E-Mail).
-
Wählen Sie den Tab Zu aktualisierende Felder aus und spezifizieren Sie die in der Datenbank zu aktualisierenden Felder (in diesem Fall die Felder Vorname und E-Mail).
-
Überprüfen Sie, ob die Daten aus der Datei abgerufen wurden. Ziehen Sie dazu die Aktivität Test in den Workflow und wählen Sie die Schaltfläche Element hinzufügen aus, um eine Bedingung hinzuzufügen.
-
Benennen und definieren Sie die Bedingung. In diesem Fall soll getestet werden, ob die ausgehende Transition Daten mit der unten stehenden Syntax enthält.
code language-none $long(vars/@recCount)>0
-
Wenn Daten abgerufen werden, speichern Sie sie in einer Audience. Fügen Sie zu diesem Zweck die Aktivität Audience-Speicherung zur Transition Target not empty hinzu und öffnen Sie sie.
-
Wählen Sie die Option Dynamischen Titel verwenden aus und fügen Sie dann den Parameter fileToTarget als den Titel der Audience ein:
code language-none $(vars/@fileToTarget)
-
Ziehen Sie die Aktivität Ende in den Arbeitsbereich. Dadurch wird Workflow 2 mit Parametern aufgerufen. Öffnen Sie dann die Aktivität.
-
Wählen Sie den Tab Externes Signal aus und spezifizieren Sie den auszulösenden Workflow sowie die damit verknüpfte Signalaktivität.
-
Definieren Sie die in Workflow 2 zu verwendenden Parameter sowie deren Werte.
In diesem Fall sollen die Parameter übermittelt werden, die ursprünglich im API-Aufruf definiert wurden (fileToTarget und discountDesc), sowie der zusätzlichen Parameter segmentCode mit einem konstanten Wert ("20 % Rabatt").
Workflow 1 ist somit konfiguriert. Erstellen Sie jetzt Workflow 2. Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.
Schritt 3: Workflow 2 konfigurieren step-3--configuring-workflow-2
Workflow 2 wird folgendermaßen erstellt:
- Aktivität Externes Signal: Die Parameter müssen deklariert werden, damit sie im Workflow verwendet werden können.
- Aktivität Audience lesen: Liest die in Workflow 1 gespeicherte Audience.
- Aktivität E-Mail-Versand: Sendet eine wiederkehrende durch Parameter personalisierte Nachricht an die entsprechende Audience.
Führen Sie zur Konfiguration des Workflows die folgenden Schritte aus:
-
Deklarieren Sie die in Workflow 1 definierten Parameter.
Öffnen Sie dazu die Aktivität Externes Signal, und fügen Sie dann den Namen und den Typ eines jeden Parameters hinzu, der in der Aktivität Ende von Workflow 1 definiert wurde.
-
Verwenden Sie die in Workflow 1 gespeicherte Audience. Platzieren Sie zu diesem Zweck die Aktivität Audience lesen in den Workflow und öffnen Sie sie.
-
Wählen Sie die Option Dynamische Audience verwenden aus und verwenden Sie den Parameter fileToTarget als den Namen der zu lesenden Audience:
code language-none $(vars/@fileToTarget)
-
Benennen Sie die ausgehende Transition entsprechend dem Parameter segmentCode.
Wählen Sie dazu den Tab Transition und danach die Option Dynamischen Segmentcode verwenden aus.
-
Verwenden Sie den Parameter segmentCode als den Namen der ausgehenden Transition:
code language-none $(vars/@segmentCode)
-
Platzieren Sie die Aktivität E-Mail-Versand in den Workflow, um eine Nachricht an die Audience zu senden.
-
Identifizieren Sie die in der Nachricht zu verwendenden Parameter, um sie mit dem Parameter discountDesc zu personalisieren. Öffnen Sie dazu die erweiterten Optionen der Aktivität und fügen Sie den Namen und den Wert des Parameters hinzu.
-
Sie können die Nachricht jetzt konfigurieren. Öffnen Sie die Aktivität und wählen Sie Wiederholende E-Mail aus.
-
Wählen Sie die zu verwendende Vorlage aus und definieren Sie die E-Mail-Eigenschaften entsprechend Ihren Anforderungen.
-
Verwenden Sie den Parameter discountDesc als ein Personalisierungsfeld. Wählen Sie das Feld dazu aus der Liste der Personalisierungsfelder aus.
-
Jetzt können Sie die Konfiguration der Nachricht abschließen und diese wie üblich versenden.
Workflows ausführen executing-the-workflows
Nach dem Erstellen der Workflows können diese ausgeführt werden. Achten Sie darauf, dass die beiden Workflows gestartet werden, bevor der API-Aufruf ausgeführt wird.