Attivare campagne tramite API trigger-campaigns
Informazioni sulle campagne attivate da API about
Con Journey Optimizer è possibile creare campagne e richiamarle da un sistema esterno basato sull'attivatore utente utilizzando l'API REST di esecuzione interattiva dei messaggi. Questo ti consente di soddisfare varie esigenze di marketing e messaggistica transazionale, tra cui reimpostazioni di password e token OTP.
A tal fine, devi innanzitutto creare una campagna attivata da API in Journey Optimizer e quindi avviarne l’esecuzione tramite una chiamata API.
I canali disponibili per le campagne attivate da API sono e-mail, SMS e messaggi push.
➡️ Scopri questa funzione nel video
Creare una campagna attivata da API create
Configurare e attivare la campagna create-activate
Per creare una campagna attivata da API, segui i passaggi seguenti. Informazioni dettagliate su come creare una campagna sono disponibili in questa sezione.
-
Crea una nuova campagna con il tipo Attivato da API.
-
Scegli la categoria Marketing o Transazionale a seconda del tipo di comunicazione che desideri inviare.
-
Scegli uno dei canali supportati e la relativa configurazione di canale da utilizzare per inviare il messaggio, quindi fai clic su Crea.
-
Specifica un titolo e una descrizione per la campagna, quindi fai clic su Modifica contenuto per configurare il messaggio da inviare.
note note NOTE Puoi trasmettere dati aggiuntivi nel payload API che puoi sfruttare per personalizzare il messaggio. Ulteriori informazioni L’utilizzo di un numero elevato o di dati contestuali pesanti nel contenuto può influire sulle prestazioni. -
Nella sezione Pubblico, specifica lo spazio dei nomi da utilizzare per identificare i singoli utenti.
-
Se stai creando una campagna di tipo transazionale, i profili target devono essere definiti nella chiamata API. L'opzione Crea nuovi profili consente di creare automaticamente profili che non esistono nel database. Ulteriori informazioni sulla creazione del profilo durante l'esecuzione della campagna
note note NOTE Una singola chiamata API supporta fino a 20 destinatari univoci. Ogni destinatario deve avere un ID utente univoco; gli ID utente duplicati non sono consentiti. Ulteriori informazioni sono disponibili nella documentazione dell'API di esecuzione messaggi interattiva -
Per campagne di tipo marketing, fai clic sul pulsante Pubblico per scegliere il pubblico di destinazione.
-
-
Configura le date di inizio e di fine della campagna.
Se configuri una data di inizio e/o di fine specifica per una campagna, questa non verrà eseguita al di fuori di tali date e le chiamate API non riusciranno se la campagna viene attivata dalle API.
-
Fai clic su Rivedi per attivare per verificare che la campagna sia configurata correttamente, quindi attivala.
Ora puoi eseguire la campagna dalle API. Ulteriori informazioni
Eseguire la campagna execute
Una volta attivata la campagna, devi recuperare la richiesta cURL di esempio generata e utilizzarla nell’API per generare il payload e attivare la campagna.
-
Apri la campagna, quindi copia e incolla la richiesta di payload dalla sezione richiesta cURL. Questo payload include tutte le variabili di personalizzazione (profilo e contesto) utilizzate nel messaggio. È disponibile una volta che la campagna è in diretta.
-
Utilizza questa richiesta cURL nelle API per generare il payload e attivare la campagna. Per ulteriori informazioni, consulta la documentazione dell'API di esecuzione interattiva dei messaggi.
Esempi di chiamate API sono disponibili anche in questa pagina.
note note NOTE Se hai configurato una data di inizio e/o di fine specifica durante la creazione della campagna, questa non verrà eseguita al di fuori di queste date e le chiamate API avranno esito negativo.
Utilizzare attributi contestuali in campagne attivate da API contextual
Con le campagne attivate da API, puoi trasmettere dati aggiuntivi nel payload API e utilizzarli all’interno della campagna per personalizzare il messaggio.
Prendiamo questo esempio, in cui i clienti vogliono reimpostare la propria password e desideri inviare loro un URL di reimpostazione della password generato in uno strumento di terze parti. Con le campagne attivate da API, puoi passare l’URL generato nel payload API e sfruttarlo nella campagna per aggiungerlo al messaggio.
Per utilizzare questi dati nelle campagne, devi passarli nel payload API e aggiungerli nel messaggio utilizzando l’editor di personalizzazione. A questo scopo, utilizza la sintassi {{context.<contextualAttribute>}}, in cui <contextualAttribute> deve corrispondere al nome della variabile nel payload API contenente i dati che desideri trasmettere.
La sintassi {{context.<contextualAttribute>}} è mappata solo a un tipo di dati String.
context.system è limitata solo all'utilizzo interno di Adobe e non deve essere utilizzata per trasmettere attributi contestuali.Per il momento non è disponibile alcun attributo contestuale da utilizzare nel menu della barra a sinistra. Gli attributi devono essere digitati direttamente nell'espressione di personalizzazione, senza alcun controllo eseguito da Journey Optimizer.
Creazione di profili durante l’esecuzione della campagna profile-creation
In alcuni casi, potrebbe essere necessario inviare messaggi transazionali a profili che non esistono nel sistema. Ad esempio, se un utente sconosciuto tenta di reimpostare la password sul sito web.
Se nel database non esiste un profilo, Journey Optimizer ti consente di crearlo automaticamente durante l’esecuzione della campagna per consentire l’invio del messaggio a questo profilo.
Per attivare la creazione del profilo durante l'esecuzione della campagna, attiva l'opzione Crea nuovi profili nella sezione Pubblico. Se questa opzione è disabilitata, i profili sconosciuti verranno rifiutati per qualsiasi invio e la chiamata API avrà esito negativo.
Video introduttivo video
Scopri come creare una campagna e attivarla da un sistema esterno basato sulle interazioni dell’utente, utilizzando l’API REST di Esecuzione interattiva dei messaggi.