Attivare campagne orchestrate utilizzando un segnale trigger-signal
Puoi attivare una campagna orchestrata inviandole un segnale invece di eseguirla secondo una pianificazione. Il segnale viene inviato tramite una chiamata API da un sistema o un’applicazione esterna. Quando utilizzi un segnale, puoi trasmettere parametri. Vengono quindi rese disponibili nella campagna orchestrata come variabili evento nel contesto di esecuzione, per l’utilizzo in targeting, condizioni o espressioni.
Processo end-to-end per attivare una campagna orchestrata utilizzando un segnale:
orchestrated-campaign.publish). Consulta Autorizzazioni incorporate.Pianificare l’attivazione della campagna da parte di un segnale configure-signal
Per impostare una campagna orchestrata in modo che inizi su un segnale invece che su una pianificazione, effettua le seguenti operazioni:
-
Apri la campagna orchestrata che desideri attivare utilizzando un segnale.
-
Apri la configurazione della pianificazione. Scopri come pianificare una campagna orchestrata.
-
Seleziona Attivato da un segnale in modo che la campagna attenda un segnale invece di essere eseguita secondo una pianificazione.
Aggiungere parametri per il payload del segnale (facoltativo) parameters
Puoi trasmettere parametri nel segnale di attivazione e utilizzarli nella campagna nel contesto di esecuzione, ad esempio nel targeting, nelle condizioni o nelle espressioni. Definisci prima ciascun parametro nelle impostazioni di pianificazione, quindi trasmettine il relativo valore quando chiami l'API dell'attivatore.
-
Apri il modulo di pianificazione campagne e seleziona Aggiungi parametro.
-
Definisci il nome e il tipo di dati di ciascun parametro da inviare nel payload del segnale. Puoi anche fornire valori di test che verranno utilizzati quando attivi la campagna in modalità di test. Scopri come verificare una campagna attivata.
Creare e testare la campagna build-and-test
Crea la campagna sull’area di lavoro, quindi, facoltativamente, testala in bozza attivando il segnale tramite l’API prima della pubblicazione.
-
Aggiungi e connetti attività (pubblico, targeting, consegne) sull’area di lavoro. Scopri come orchestrare le attività della campagna
-
Se hai definito i parametri nel segnale, puoi collegarli alla logica dell’area di lavoro (ad esempio, in condizioni o nel targeting). In questo esempio, il parametro "channel" viene utilizzato come condizione in un'attività Test.
Per utilizzare un parametro di segnale nell'editor espressioni (ad esempio, per generare una query in un'attività Genera pubblico), digitare
$(vars/@<parameterName>)nel campo espressione. Sostituire<parameterName>con il nome del parametro definito nella pianificazione, ad esempio$(vars/@channel). Scopri come utilizzare l'editor espressioni. -
Apri l'utilità di pianificazione della campagna, seleziona Copia richiesta API e scegli il formato (cURL o richiesta HTTP).
Le informazioni copiate includono l’ID della campagna orchestrata, il nome della sandbox, l’ID organizzazione e i valori di test per i parametri, se ne hai aggiunti alcuni.
accordion Richiesta cURL di esempio con un parametro e un valore di test 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" } } -
Fai clic su Inizio per avviare la campagna.
-
Invia la chiamata API del trigger utilizzando la richiesta di esempio copiata dal modulo di pianificazione.
Quando si è soddisfatti dei risultati del test, pubblicare la campagna.
Pubblicare e attivare la campagna publish
Dopo aver generato e testato la campagna, pubblicala in modo che possa essere attivata dall'applicazione.
-
Fai clic su Pubblica nell'area di lavoro della campagna. La campagna deve essere pubblicata prima di poter essere attivata da un sistema esterno. Ulteriori informazioni sull'avvio e il monitoraggio della campagna.
-
Apri l'utilità di pianificazione della campagna, seleziona Copia richiesta API e scegli il formato (cURL o richiesta HTTP).
Le informazioni copiate includono l’ID della campagna orchestrata, il nome della sandbox, l’ID dell’organizzazione e i parametri, se ne hai aggiunti alcuni.
-
Chiama l'API del trigger dal sistema.
note important IMPORTANT Per una campagna orchestrata in tempo reale, un guardrail della velocità impone un intervallo minimo di un'ora tra due esecuzioni del trigger API. Se si chiama di nuovo l'API prima che l'intervallo sia trascorso, l'API restituisce l'errore HTTP 429 (troppe richieste). Questo guardrail non viene applicato quando si attiva una versione bozza per testarla. Se hai aggiunto parametri al payload del segnale, i valori trasmessi nella chiamata API vengono esposti come variabili evento della campagna durante l’esecuzione della campagna. Per esaminarli, apri i registri della campagna dalla barra degli strumenti dell’area di lavoro della campagna. Nella scheda Attività, identifica l'attività corrispondente al segnale e fai clic sull'icona a forma di matita per accedere alle variabili di evento correlate. Scopri come accedere a registri e attività.
