Utlös samordnade kampanjer med en signal trigger-signal
Du kan utlösa en Orchestrated-kampanj genom att skicka den en signal i stället för att köra den enligt ett schema. Signalen skickas via ett API-anrop från ett externt system eller program. När du använder en signal kan du skicka parametrar. De görs sedan tillgängliga i den samordnade kampanjen som händelsevariabler i körningssammanhanget - som kan användas för målinriktning, villkor eller uttryck.
En process från början till slut för att utlösa en Orchestrated-kampanj med en signal:
orchestrated-campaign.publish). Se Inbyggda behörigheter.Schemalägg kampanjen som ska utlösas av en signal configure-signal
Följ de här stegen för att ange att en orkestrerad kampanj ska starta på en signal i stället för ett schema:
-
Öppna den Orchestrated-kampanj som du vill utlösa med hjälp av en signal.
-
Öppna schemakonfigurationen. Lär dig att schemalägga en orkestrerad kampanj.
-
Välj Triggered by a signal så att kampanjen väntar på en signal i stället för att köra ett schema.
Lägg till parametrar för signalnyttolasten (valfritt) parameters
Du kan skicka parametrar i utlösarsignalen och använda dem i kampanjen i körningskontexten, till exempel i mål, villkor eller uttryck. Definiera först varje parameter i schemainställningarna och skicka sedan dess värde när du anropar utlösar-API:t.
-
Öppna kampanjschemaläggaren och välj Add parameter.
-
Definiera varje parameterns namn och datatyp som ska skickas i signalnyttolasten. Du kan också ange testvärden som ska användas när du utlöser kampanjen i testläge. Lär dig hur du testar en utlöst kampanj.
Bygg och testa kampanjen build-and-test
Bygg din kampanj på arbetsytan och testa den sedan som utkast genom att aktivera signalen via API:t innan du publicerar.
-
Lägg till och koppla aktiviteter (målgrupp, målinriktning, leveranser) på arbetsytan. Lär dig att samordna kampanjaktiviteter
-
Om du har definierat parametrar i signalen kan du koppla dem till arbetsytelogiken (t.ex. i villkor eller mål). I det här exemplet används parametern "channel" som ett villkor i en Test-aktivitet.
Om du vill använda en signalparameter i uttrycksredigeraren (till exempel för att skapa en fråga i en Build audience-aktivitet) skriver du
$(vars/@<parameterName>)i uttrycksfältet. Ersätt<parameterName>med parameternamnet som definierats i schemaläggaren, till exempel$(vars/@channel). Lär dig arbeta med uttrycksredigeraren. -
Öppna kampanjschemaläggaren, markera Copy API request och välj format (cURL eller HTTP-begäran).
Den kopierade informationen innehåller det orkestrerade kampanj-ID:t, sandlådenamnet, organisations-ID:t och testvärden för parametrarna om du har lagt till några.
accordion Exempelbegäran cURL med en parameter och ett testvärde 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" } } -
Klicka på Start för att starta kampanjen.
-
Skicka API-anropet för utlösaren med den exempelbegäran som du har kopierat från schemaläggaren.
Publicera kampanjen när du är nöjd med testresultaten.
Publicera och utlösa kampanjen publish
När du har skapat och testat kampanjen publicerar du kampanjen så att den kan utlösas från ditt program.
-
Klicka på Publish på kampanjarbetsytan. Kampanjen måste publiceras innan den kan aktiveras från ett externt system. Läs mer om hur du startar och övervakar kampanjen.
-
Öppna kampanjschemaläggaren, markera Copy API request och välj format (cURL eller HTTP-begäran).
Den kopierade informationen innehåller det orkestrerade kampanj-ID:t, sandlådenamnet, organisations-ID:t och parametrar om du har lagt till några.
-
Anropa utlösar-API:t från systemet.
note important IMPORTANT För en live-orchestrerad kampanj kräver ett begränsningsskyddsprotokoll ett minimiintervall på en timme mellan två API-utlösarkörningar. Om du anropar API:t igen innan intervallet har gått ut returnerar API:t HTTP 429-fel (för många begäranden). Det här skyddsutkastet används inte när du utlöser ett utkast för att testa det. Om du har lagt till parametrar i signalnyttolasten visas de värden som du skickar i API-anropet som kampanjhändelsevariabler när kampanjen körs. Om du vill inspektera dem öppnar du kampanjloggarna från verktygsfältet för kampanjarbetsytan. Identifiera aktiviteten som motsvarar signalen på fliken Tasks och klicka på pennikonen för att komma åt de relaterade händelsevariablerna. Lär dig hur du får åtkomst till loggar och uppgifter.
