Trigger hat Kampagnen mithilfe eines Signals orchestriert trigger-signal
Sie können einen Trigger für eine orchestrierte Kampagne durchführen, indem Sie ihr ein Signal senden, anstatt sie planmäßig auszuführen. Das Signal wird über einen API-Aufruf von einem externen System oder einer externen Anwendung gesendet. Bei Verwendung eines Signals können Parameter übergeben werden. Sie werden dann in der orchestrierten Kampagne als Ereignisvariablen im Ausführungskontext zur Verwendung bei der Zielgruppenbestimmung, in Bedingungen oder Ausdrücken bereitgestellt.
End-to-End-Prozess zum Trigger einer orchestrierten Kampagne mithilfe eines Signals:
Planung der durch ein Signal ausgelösten Kampagne configure-signal
Gehen Sie wie folgt vor, um eine orchestrierte Kampagne so einzurichten, dass sie mit einem Signal statt mit einem Zeitplan startet:
-
Öffnen Sie die orchestrierte Kampagne, die Sie mit einem Signal Trigger machen möchten.
-
Öffnen Sie die Zeitplankonfiguration. Erfahren Sie, wie Sie eine koordinierte Kampagne planen.
-
Wählen Sie Wird durch ein Signal ausgelöst, damit die Kampagne auf ein Signal wartet, anstatt nach einem Zeitplan zu laufen.
Parameter für die Signal-Payload hinzufügen (optional) parameters
Sie können Parameter im Kampagnensignal übergeben und in Ihrer Trigger im Ausführungskontext verwenden, z. B. bei der Zielgruppenbestimmung, in Bedingungen oder Ausdrücken. Definieren Sie zunächst jeden Parameter in den Zeitplaneinstellungen und übergeben Sie dann beim Aufruf der Trigger-API dessen Wert.
-
Öffnen Sie die Kampagnenplanung und wählen Sie Parameter hinzufügen aus.
-
Definieren Sie den Namen und den Datentyp jedes Parameters, der in der Signal-Payload gesendet werden soll. Sie können auch Testwerte angeben, die beim Trigger der Kampagne im Testmodus verwendet werden. Erfahren Sie, wie Sie eine ausgelöste Kampagne testen.
Erstellen und Testen der Kampagne build-and-test
Erstellen Sie Ihre Kampagne auf der Arbeitsfläche und testen Sie sie dann optional im Entwurf , indem Sie das Signal über die API auslösen, bevor Sie veröffentlichen.
-
Fügen Sie Aktivitäten (Audience, Zielgruppenbestimmung, Sendungen) auf der Arbeitsfläche hinzu und verbinden Sie sie. Weitere Informationen zur Orchestrierung von Kampagnenaktivitäten
-
Wenn Sie Parameter im Signal definiert haben, können Sie diese in Ihre Arbeitsflächen-Logik verkabeln (z. B. in Bedingungen oder beim Targeting). In diesem Beispiel wird der Parameter „channel“ als Bedingung in einer ""- verwendet.
Um einen Signalparameter im Ausdruckseditor zu verwenden (z. B. um eine Abfrage in der Aktivität Zielgruppe aufbauen), geben Sie
$(vars/@<parameterName>)in das Ausdrucksfeld ein. Ersetzen Sie<parameterName>durch den im Planer definierten Parameternamen, z. B.$(vars/@channel). Erfahren Sie mehr über die Arbeit mit dem Ausdruckseditor. -
Öffnen Sie die Kampagnenplanung, wählen Sie API-Anfrage kopieren und das Format aus (cURL- oder HTTP-Anfrage).
Die kopierten Informationen enthalten die orchestrierte Kampagnen-ID, den Sandbox-Namen, die Organisations-ID und Testwerte für Ihre Parameter, sofern Sie welche hinzugefügt haben.
accordion Beispielhafte cURL-Anfrage mit einem -Parameter und einem Testwert code language-bash POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger Headers: Authorization: Bearer ## Access token ## Content-Type: application/json x-api-key: ## Provide API Key here ## x-api-version: 1 x-gw-ims-org-id: 123456ABCDEFG@LumaOrg x-sandbox-name: prod Body: { "variables": { "channel": "sms" } } -
Klicken Sie Starten, um die Kampagne zu starten.
-
Senden Sie den Trigger-API-Aufruf mit der Beispielanfrage, die Sie aus der Planung kopiert haben.
Wenn Sie mit den Testergebnissen zufrieden sind, veröffentlichen die Kampagne.
Veröffentlichen und Trigger der Kampagne publish
Nachdem Sie Kampagne erstellt und getestet haben veröffentlichen Sie die Kampagne, damit sie über Ihre Anwendung ausgelöst werden kann.
-
Klicken Sie der Kampagnen Arbeitsfläche auf „Veröffentlichen“. Die Kampagne muss veröffentlicht werden, bevor sie von einem externen System ausgelöst werden kann. Weitere Informationen zum Starten und Überwachen der Kampagne.
-
Öffnen Sie die Kampagnenplanung, wählen Sie API-Anfrage kopieren und das Format aus (cURL- oder HTTP-Anfrage).
Die kopierten Informationen enthalten die Kennung der orchestrierten Kampagne, den Sandbox-Namen, die Organisations-ID und die Parameter, sofern Sie welche hinzugefügt haben.
-
Rufen Sie die Trigger-API von Ihrem System aus auf.
note important IMPORTANT Bei einer orchestrierten Live-Kampagne erzwingt eine Drosselungsmaßnahme ein Mindestintervall von einer Stunde zwischen zwei API-Trigger-Ausführungen. Wenn Sie die API erneut aufrufen, bevor dieses Intervall abgelaufen ist, gibt die API HTTP 429-Fehler (zu viele Anfragen) zurück. Diese Schutzmaßnahme wird nicht angewendet, wenn Sie Trigger für eine Entwurfsversion ausführen, um sie zu testen. Wenn Sie Parameter zur Signal-Payload hinzugefügt haben, werden die Werte, die Sie im API-Aufruf übergeben, bei der Ausführung der Kampagne als Kampagnenereignisvariablen verfügbar gemacht. Um sie zu überprüfen, öffnen Sie die Kampagnenprotokolle in der Symbolleiste der Kampagnen-Arbeitsfläche. Identifizieren Sie auf Registerkarte die Aufgabe, die dem Signal entspricht, und klicken Sie auf das Stiftsymbol, um auf die zugehörigen Ereignisvariablen zuzugreifen. Erfahren Sie, wie Sie auf Protokolle und Aufgaben zugreifen können.
