Trigger Orchestrated campagnes gebruikend een signaal trigger-signal
U kunt een Geordende campagne teweegbrengen door het een signaal te verzenden in plaats van het op een programma in werking te stellen. Het signaal wordt verzonden via een API-aanroep van een extern systeem of externe toepassing. Wanneer u een signaal gebruikt, kunt u parameters doorgeven. Ze worden vervolgens in de georkestreerde campagne beschikbaar gesteld als gebeurtenisvariabelen in de uitvoeringscontext — voor gebruik bij het opgeven van doelen, voorwaarden of expressies.
Het proces van begin tot eind om een Geordende campagne teweeg te brengen gebruikend een signaal:
orchestrated-campaign.publish ) nodig. Zie ingebouwde toestemmingen .Plan de campagne die door een signaal moet worden teweeggebracht configure-signal
Voer de volgende stappen uit om een georkestreerde campagne in te stellen om te beginnen met een signaal in plaats van een schema:
-
Open de geordende campagne die u wilt activeren door een signaal te gebruiken.
-
Open de planningsconfiguratie. Leer hoe te om een Geordende campagne te plannen.
-
Selecteer Triggered by a signal zodat de campagne op een signaal wacht in plaats van op een schema.
Parameters toevoegen voor de signaallading (optioneel) parameters
U kunt parameters in het trekkersignaal overgaan en hen in uw campagne in de uitvoeringscontext-voor voorbeeld, in het richten, voorwaarden, of uitdrukkingen gebruiken. Definieer eerst elke parameter in de planningsinstellingen en geef vervolgens de waarde ervan door wanneer u de trigger-API aanroept.
-
Open de campagneplanner en selecteer Add parameter.
-
Bepaal de naam en het gegevenstype van elke parameter om in de signaallading te verzenden. U kunt waarden van de Test ook verstrekken die zullen worden gebruikt wanneer u de campagne op testwijze teweegbrengt. Leer hoe te om een teweeggebrachte campagne te testen.
De campagne bouwen en testen build-and-test
Bouw uw campagne op het canvas, dan test naar keuze het in ontwerp door het signaal via API in werking te stellen alvorens u publiceert.
-
Voeg activiteiten (publiek, gericht, leveranties) op het canvas toe en verbind. Leer hoe te om campagneactiviteiten te ordenen
-
Als u parameters in het signaal hebt bepaald, kunt u hen in uw canvaslogica (bijvoorbeeld, in voorwaarden of het richten) telegraferen. In dit voorbeeld wordt de parameter "channel" gebruikt als een voorwaarde in een Test -activiteit.
{de parameter van het 0} Kanaal die als voorwaarde in de activiteit van de Test wordt gebruikt
Als u een signaalparameter in de expressieeditor wilt gebruiken (bijvoorbeeld om een query te maken in een Build audience -activiteit), typt u
$(vars/@<parameterName>)in het expressieveld. Vervang<parameterName>door de parameternaam die in de planner is gedefinieerd, bijvoorbeeld$(vars/@channel). Leer hoe te met de uitdrukkingsredacteur te werken. -
Open de campagneplanner, selecteer Copy API request en kies het formaat (cURL of HTTP- Verzoek).
De gekopieerde informatie bevat onder andere de geordende campagne-id, de naam van de sandbox, de organisatie-id en testwaarden voor de parameters als u er enkele hebt toegevoegd.
accordion Voorbeeld van een cURL-aanvraag met een parameter en een testwaarde 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" } } -
Klik op Start om de campagne te starten.
-
Verzend de trekkerAPI vraag gebruikend het steekproefverzoek u van de planner hebt gekopieerd.
Wanneer u met de testresultaten wordt tevredengesteld, publiceer de campagne .
De campagne publiceren en activeren publish
Nadat u hebt gebouwd en de campagne getest, publiceer de campagne zodat kan het van uw toepassing worden teweeggebracht.
-
Klik op Publish in het campagnecanvas. De campagne moet worden gepubliceerd voordat deze vanuit een extern systeem kan worden geactiveerd. Leer meer bij het beginnen en het controleren van de campagne .
-
Open de campagneplanner, selecteer Copy API request en kies het formaat (cURL of HTTP- Verzoek).
De gekopieerde informatie bevat onder andere de geordende campagne-id, de naam van de sandbox, de organisatie-id en parameters als u er een hebt toegevoegd.
-
Roep de trigger-API van uw systeem aan.
note important IMPORTANT Voor een levende georkestreerde campagne, dwingt een throttle guardrail a minimuminterval van één uur tussen twee API triggeruitvoeringen af. Als u opnieuw API roept alvorens dat interval is verstreken, keert API HTTP 429 fout (Te veel verzoeken) terug. Deze hulplijn wordt niet toegepast wanneer u een conceptversie activeert om deze te testen. Als u parameters aan de signaallading toevoegde, worden de waarden u in de API vraag overgaat blootgesteld als variabelen van de campagnegebeurtenis wanneer de campagne loopt. Als u ze wilt inspecteren, opent u de logboeken van de campagne op de werkbalk van het campagnecanvas. Geef op het tabblad Tasks de taak op die overeenkomt met het signaal en klik op het potloodpictogram om de gerelateerde gebeurtenisvariabelen te openen. leer hoe te om tot logboeken en taken toegang te hebben.
