In questa pagina: scopri come attivare una campagna orchestrata con un segnale dall’API REST o dall’attività finale di un’altra campagna e come trasmettere parametri di payload che diventano variabili per targeting, condizioni ed espressioni.
Puoi avviare una campagna orchestrata con un segnale invece di una pianificazione fissa. Quando la campagna riceve il segnale, viene eseguita e puoi trasmettere parametri nel payload. Diventano disponibili come variabili per il targeting, le condizioni o le espressioni.
Il segnale può provenire da uno dei seguenti elementi:
- API REST: l’applicazione o l’integrazione chiama l’endpoint del trigger (vedere Pubblicare e attivare la campagna e il riferimento API).
- Altra campagna orchestrata: l’attività End di una campagna a monte invia lo stesso tipo di segnale al completamento di un ramo. Scopri come configurare l’attività End.
Questa pagina spiega come impostare la campagna che riceve il segnale (pianificazione, parametri, test, pubblicazione), quindi come attivarla dall’API o da un’attività End. Quando le variabili saranno disponibili, per informazioni su come utilizzarle nelle regole e nelle condizioni Test, vedere Utilizzare le variabili nelle campagne orchestrate.
Per informazioni sulla specifica REST completa dell’endpoint del trigger (percorsi, intestazioni, corpo, risposte ed errori), vedi Attivare l’API delle campagne orchestrate nella documentazione dell’API di Adobe Journey Optimizer.
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 della pianificazione, quindi trasmettine il relativo valore quando chiami l’API del trigger o quando mappi i parametri dall’attività Fine di una campagna a monte (vedi di seguito).
-
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.
Testare la campagna build-and-test
Crea la campagna nell’area di lavoro, quindi testala in Bozza prima di pubblicarla inviando il segnale tramite l’API REST.
-
Campagne orchestrate attivate dall’API REST. Utilizzare i passaggi seguenti per eseguire la campagna in bozza e convalidare il targeting, i parametri e la logica di consegna prima della pubblicazione.
-
Campagne orchestrate attivate da un’attività End. Impossibile eseguire la catena completa end-to-end nella bozza: dopo la pubblicazione della campagna upstream, l’attività End avvia solo una campagna downstream pubblicata. Per eseguire il test del lato a valle prima della pubblicazione di entrambe le campagne, mantieni la campagna in Bozza, imposta Valori di test per i parametri del segnale nella pianificazione (Aggiungi parametri per il payload del segnale), quindi segui i passaggi dell’API riportati di seguito. La chiamata API del trigger utilizza lo stesso payload di un’attività End in fase di runtime, pertanto è possibile convalidare l’instradamento dei parametri e la logica dell’area di lavoro prima di pubblicare la campagna a valle e configurare l’attività End a monte (Trigger dall’attività End di un’altra campagna).
-
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. Per informazioni dettagliate su richieste e risposte, consulta Attivare l’API delle campagne orchestrate.
Quando si è soddisfatti dei risultati del test, pubblicare la campagna.
Pubblicare e attivare la campagna publish
Dopo aver testato la campagna, pubblicala in modo che possa ricevere un segnale dall’applicazione o dall’attività End di un’altra campagna. Ulteriori informazioni sull’avvio e il monitoraggio della campagna.
Potrai quindi attivarla dall’API REST o dall’attività End di un’altra campagna. Consulta le sezioni seguenti.
Inviare il segnale con l’API REST publish-api
Dopo la pubblicazione, segui questi passaggi ogni volta che attivi la campagna dalla tua applicazione:
-
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. Per informazioni sulla specifica dell’endpoint attivo, consulta API di attivazione di campagne orchestrate.
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 richiami nuovamente l’API prima che sia trascorso tale intervallo, l’API restituisce 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à.
Inviare il segnale dall’attività Fine di un’altra campagna signal-end
Utilizza questo percorso per concatenare campagne orchestrate: al termine di un ramo della campagna a monte, l’attività End invia un segnale a una campagna a valle già impostata su Attivata da un segnale. Ciò ti consente di riutilizzare campagne più piccole e di trasmettere un payload diverso da ogni chiamante.
- Puoi utilizzare diverse attività End nella stessa area di lavoro e configurarle per attivare una campagna a valle diversa.
- Diverse campagne possono attivare la stessa campagna a valle. Ogni chiamata può inviare un payload diverso.
Segui questi passaggi sulla campagna che deve essere eseguita per prima:
-
Apri la campagna orchestrata che deve inviare il segnale e seleziona un’attività Fine alla fine del ramo che deve essere completata prima dell’inizio della campagna a valle.
-
Nella sezione External signal, seleziona la campagna a valle da attivare.
-
Facoltativamente, aggiungi parametri: utilizza gli stessi nomi utilizzati nella pianificazione della campagna a valle e imposta ogni valore.
-
Per testare la campagna a valle in modalità bozza prima di pubblicarla, segui i passaggi descritti nella sezione verifica della campagna per attivarla in bozza con l’API REST.
La campagna a valle deve essere attiva prima di poter pubblicare la campagna a monte che vi fa riferimento in un’attività Fine. Se il segnale viene inviato mentre la campagna di destinazione non è pubblicata, l’esecuzione non riuscirà. Pubblica la campagna a valle, quindi riprendi o riavvia secondo necessità.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to trigger an Orchestrated campaign with a signal from the REST API or from another campaign’s End activity, and how to pass payload parameters that become variables for targeting, conditions, and expressions.
Intents:
- Schedule an Orchestrated campaign to start on a signal instead of a fixed schedule.
- Define parameters for the signal payload, with test values for use in test mode.
- Build and test the campaign in Draft before publishing, including copying a sample API request.
- Publish the campaign and trigger it from the REST API.
- Chain campaigns by configuring an End activity to send a signal to a downstream campaign.
- Inspect campaign event variables passed in a trigger signal from the campaign logs.
Glossary:
- Triggered by a signal: the schedule option that makes a campaign wait for a signal instead of running on a schedule (product-specific)
- End activity: the campaign activity, placed at the end of a branch, that can send a signal to a downstream campaign through its External signal section (product-specific)
- External signal: the section of the End activity where the downstream campaign to trigger is selected (product-specific)
- Test values: values defined for signal parameters in the scheduler, used when the campaign is triggered in test mode (product-specific)
- Copy API request: the scheduler option that copies the orchestrated campaign ID, sandbox name, organization ID, and parameter values, in cURL or HTTP Request format (product-specific)
Guardrails:
- To trigger an Orchestrated campaign using a signal, you need the Publish orchestrated campaigns permission (
orchestrated-campaign.publish). - For a live orchestrated campaign, a throttle guardrail enforces a minimum interval of one hour between two API trigger executions (hard limit); calling the API again before that interval has elapsed returns HTTP 429 (Too many requests). This guardrail is not applied when you trigger a draft version to test it.
- For Orchestrated campaigns triggered by the REST API, if you pass a parameter in the API call that has not been defined in the scheduler, the API call still succeeds and the parameter is propagated and can be used in expressions; however, the orchestrated campaign interface will not help you use it — for example, the Test activity will not list or show parameters that were not defined in the scheduler.
- You cannot run the full chain end-to-end in draft for campaigns triggered by an End activity: once the upstream campaign is published, its End activity only starts a published downstream campaign.
- The downstream campaign must be live before you can publish the upstream campaign that references it in an End activity; if the signal is sent while the target campaign is not published, execution will fail.
- You can use several End activities on the same canvas, each configured to trigger a different downstream campaign.
- Several campaigns can trigger the same downstream campaign, and each call can send a different payload.
Terminology:
- Canonical name: Triggered by a signal — variant: signal.
- Do not confuse: “End activity” signal (sent at runtime to a published downstream campaign) ≠ REST API trigger call used to test a draft downstream campaign before both campaigns are published.
FAQ:
- Q: How do I make a campaign start from a signal instead of a schedule? — Open the schedule configuration and select Triggered by a signal.
- Q: Where do I define parameters for the signal payload? — In the campaign scheduler, using Add parameter, where you can also set Test values for test mode.
- Q: What happens if I pass a parameter in the API call that was not defined in the scheduler? — The API call still succeeds and the parameter is propagated for use in expressions, but the Test activity will not list or show it.
- Q: How often can I call the trigger API for a live campaign? — A throttle guardrail enforces a minimum interval of one hour between two API trigger executions; calling again sooner returns HTTP 429 (Too many requests). This guardrail does not apply when triggering a draft version to test it.
- Q: Can I test the full chain from an upstream End activity to a downstream campaign before publishing both? — No; once published, an End activity only starts a published downstream campaign. To test the downstream side first, keep it in Draft, set Test values for its signal parameters, and trigger it directly with the REST API using the same payload the End activity would send.
- Q: What must be true of the downstream campaign before I publish the upstream campaign’s End activity that references it? — The downstream campaign must be live; if the signal is sent while it is not published, execution will fail.
Personas:
- developer: Can trigger a published Orchestrated campaign by calling the trigger API, and pass parameters in the payload that become variables for targeting, conditions, and expressions. Can copy a sample cURL or HTTP Request from the campaign scheduler, including the campaign ID, sandbox name, organization ID, and parameter values. The page states that a throttle guardrail enforces a minimum one-hour interval between two API trigger executions for a live campaign. Where: “Send the signal with the REST API”.
Onboarding:
- Level: Intermediate
- First minimal step: Open the schedule configuration and select Triggered by a signal.
- Success check: In the Tasks tab of the campaign logs, you can access the event variables passed in the trigger signal.
- Previous: Opening the schedule configuration to set up the Orchestrated campaign: Create and schedule Orchestrated campaigns with Journey Optimizer (orchestrated/create-orchestrated-campaign.md); Adding and connecting activities on the campaign canvas: Create Orchestrated campaigns with Adobe Journey Optimizer (orchestrated/orchestrate-activities.md)
- Next: Using signal parameters as variables in targeting, conditions, or expressions: Use variables in Orchestrated campaigns (orchestrated/variables-orchestrated-campaigns.md); Publishing and monitoring the campaign after testing it: Start and monitor Orchestrated campaigns with Adobe Journey Optimizer (orchestrated/start-monitor-campaigns.md)