Messaggi sulle transazioni degli eventi

Puoi inviare messaggi sulle transazioni destinati a un evento. Questo tipo di messaggi sulle transazioni non contiene informazioni del profilo: il target di consegna è definito dai dati contenuti nell’evento stesso.

Dopo aver creato e pubblicato un evento come l’abbandono del carrello, illustrato all’interno della presente sezione, il relativo messaggio sulle transazioni viene creato in automatico.

I passaggi di configurazione sono descritti nella sezione Configurazione di un evento per l’invio di un messaggio sulle transazioni.

Nota

I messaggi transazionali relativi agli eventi non contengono informazioni sui profili, pertanto non sono compatibili con le regole di affaticamento (anche nel caso di un arricchimento con profili). Consulta Regole di affaticamento.

Per fare in modo che l’evento attivi l’invio di un messaggio transazionale, devi personalizzare il messaggio, verificarlo e pubblicarlo.

Accesso ai messaggi transazionali

Per accedere al messaggio transazionale creato:

  1. Fate clic sul logo Adobe Campaign, nell'angolo in alto a sinistra.

  2. Seleziona Marketing plans > Transactional messages > Transactional messages.

  3. Fai clic sul messaggio desiderato per modificarlo.

IMPORTANTE

Per accedere ai messaggi transazionali, devi far parte del gruppo di sicurezza Administrators (all units).

Personalizzazione di un messaggio sulle transazioni

In questo esempio verrà illustrato come personalizzare un messaggio di transazione aggiungendo tre campi definiti al momento della creazione dell'evento a: nome, ultimo prodotto consultato, importo totale del carrello.

A tal fine, inserisci un campo di personalizzazione nel contenuto del messaggio.

  1. Fai clic sul blocco Content per modificare l’oggetto e il contenuto del messaggio. Ai fini del presente esempio, seleziona un modello contenente immagini e testo. Per ulteriori informazioni sui modelli di contenuto dell’e-mail, consulta Progettazione mediante modelli.

  2. Aggiungi un oggetto e modifica il contenuto del messaggio in base alle tue esigenze.

    Nota

    Il collegamento al carrello abbandonato porta a un URL esterno che reindirizzerà il consumatore al proprio carrello. Tale parametro non è gestito all’interno di Adobe Campaign.

  3. Scorri Context > Real-time event > Event context per ottenere i campi di personalizzazione: nome, ultimo prodotto consultato, importo totale del carrello.

  4. Per arricchire il contenuto del messaggio, aggiungi i campi selezionandoli dalla tabella a cui hai collegato l’evento. Nel nostro esempio, seleziona il campo Title (salutation) nella tabella Profile tramite Context > Real-time event > Event context.

  5. Inserisci tutti i campi richiesti.

  6. Per visualizzare l’anteprima del messaggio, seleziona il profilo definito per l’evento.

    La procedura per la visualizzazione dell’anteprima di un messaggio è spiegata nei dettagli nella sezione Anteprima dei messaggi.

    Puoi verificare che i campi di personalizzazione corrispondano alle informazioni inserite nel profilo di test. Per ulteriori informazioni al riguardo, consulta Definizione di un profilo di test in un messaggio transazionale.

Utilizzo degli elenchi di prodotti in un messaggio sulle transazioni

Puoi creare elenchi di prodotti che fanno riferimento a una o più raccolte di dati presenti nel contenuto di un’e-mail sulle transazioni. Ad esempio, in un messaggio e-mail di abbandono del carrello puoi includere un elenco di tutti i prodotti presenti nei carrelli degli utenti al momento dell’uscita dal sito web, aggiungendo un’immagine, il prezzo e il collegamento a ciascun prodotto.

Ulteriori informazioni in questo video.

IMPORTANTE

Gli elenchi dei prodotti sono disponibili solo durante la modifica dei messaggi e-mail sulle transazioni tramite l’interfaccia di E-mail Designer.

Adobe Campaign non supporta elenchi di prodotti nidificati, il che significa che non puoi includere un elenco di prodotti all’interno di un altro.

Nell'esempio seguente, verranno illustrati i passaggi per aggiungere un elenco di prodotti abbandonati in un messaggio transazionale.

Passaggio 1: Definire un elenco di prodotti

Prima di poter utilizzare un elenco di prodotti in un messaggio sulle transazioni, è necessario definire a livello di evento l’elenco dei prodotti e i campi per ciascun prodotto da visualizzare. Per ulteriori informazioni, consulta Definizione delle raccolte di dati.

  1. Nel messaggio sulle transazioni, fai clic sul blocco Content per modificare il contenuto dell’e-mail.

  2. Trascina e rilascia un componente struttura all’interno dell’area di lavoro. Per ulteriori informazioni, consulta Modifica della struttura delle e-mail.

    Ad esempio, seleziona un componente struttura a una colonna e aggiungi un componente testo, un componente immagine e un componente pulsante. Per ulteriori informazioni, consulta Aggiunta di frammenti e componenti.

  3. Seleziona il componente struttura appena creato, quindi fai clic sull’icona Enable product listing nella barra degli strumenti contestuale.

    Il componente struttura viene evidenziato con una cornice arancione e le impostazioni Product listing sono visualizzate nella palette a sinistra.

  4. Seleziona la modalità di visualizzazione degli elementi della raccolta:

    • Row: orizzontale, ovvero ogni elemento posto sulla riga inferiore al precedente.
    • Column: verticale, ovvero ciascun elemento posto accanto all’altro sulla medesima riga.
    Nota

    L’opzione Column è disponibile solo quando è in uso un componente struttura a più colonne ( 2:2 column, 3:3 column e 4:4 column ). Quando modifichi l’elenco dei prodotti, compila solo la prima colonna: le altre non saranno prese in considerazione. Per ulteriori informazioni sulla selezione dei componenti struttura, consulta Modifica della struttura delle e-mail.

  5. Seleziona la raccolta dati creata durante la configurazione dell’evento correlato al messaggio sulle transazioni, disponibile nel nodo Context > Real-time event > Event context.

    Per ulteriori informazioni sulla configurazione dell’evento, consulta Definizione delle raccolte di dati.

  6. Utilizza l’elenco a discesa First item per selezionare l’elemento che avvierà l’elenco visualizzato nel messaggio e-mail.

    Ad esempio, se scegli 2, il primo elemento della raccolta non verrà visualizzato nell’e-mail. L’elenco dei prodotti partirà dal secondo elemento.

  7. Seleziona il numero massimo di elementi da visualizzare nell’elenco.

    Nota

    Se desideri che gli elementi dell’elenco siano visualizzati in verticale ( Column ), il numero massimo è limitato in base al componente struttura selezionato (2, 3 o 4 colonne). Per ulteriori informazioni sulla selezione dei componenti struttura, consulta Modifica della struttura delle e-mail.

Passaggio 2: Compilare l'elenco di prodotti

Per visualizzare un elenco dei prodotti provenienti dall’evento collegato al messaggio e-mail sulle transazioni, attieniti alla procedura seguente.

Per ulteriori informazioni sulla creazione di una raccolta e dei campi correlati durante la configurazione dell’evento, consulta Definizione delle raccolte di dati.

  1. Seleziona il componente immagine inserito, fai clic su Enable personalization e sulla matita nel riquadro Impostazioni.

  2. Seleziona Add personalization field nella finestra Image source URL che si apre.

    Dal nodo Context > Real-time event > Event context, apri il nodo corrispondente alla raccolta creata, in questo caso Product list, quindi fai clic sul campo immagine definito (qui Product image). Fai clic su Save.

    Il campo di personalizzazione selezionato viene ora visualizzato nel riquadro Impostazioni.

  3. Nella posizione desiderata, seleziona Insert personalization field dalla barra degli strumenti contestuale.

  4. Dal nodo Context > Real-time event > Event context, apri il nodo corrispondente alla raccolta creata (qui Product list) e seleziona il campo creato (qui Product name). Fai clic su Confirm.

    Il campo di personalizzazione selezionato viene ora visualizzato nella posizione desiderata all’interno del contenuto dell’e-mail.

  5. Procedi similmente per l’inserimento del prezzo.

  6. Seleziona una parte di testo e fai clic su Insert link nella barra degli strumenti contestuale.

  7. Seleziona Add personalization field nella finestra Insert link che si apre.

    Dal nodo Context > Real-time event > Event context, apri il nodo corrispondente alla raccolta creata, in questo caso Product list, quindi fai clic sul campo URL (qui Product URL). Fai clic su Save.

    IMPORTANTE

    Per motivi di sicurezza, accertati di inserire il campo di personalizzazione all’interno di un collegamento che inizia con un nome di dominio statico appropriato.

    Il campo di personalizzazione selezionato viene ora visualizzato nel riquadro Impostazioni.

  8. Scegli il componente struttura sul quale viene applicato l’elenco di prodotti, quindi fai clic su Show fallback per definire un contenuto predefinito.

  9. Trascina uno o più componenti di contenuto e modificali in base alle tue esigenze.

    Il contenuto di fallback verrà visualizzato se la raccolta è vuota al momento di attivare l’evento, ad esempio se un cliente ha il carrello vuoto.

  10. Nel riquadro Impostazioni, modifica gli stili per l’elenco dei prodotti. Per ulteriori informazioni, consulta Modifica degli stili delle e-mail.

  11. Visualizza l’anteprima del messaggio e-mail utilizzando un profilo di prova collegato all’evento sulle transazioni rilevante per il quale hai definito i dati della raccolta. Ad esempio, aggiungi le seguenti informazioni nella sezione Event data relativa al profilo di test da utilizzare:

    Per approfondimenti sulla definizione di un profilo di test in un messaggio sulle transazioni, consulta questa sezione.

Verifica di un messaggio sulle transazioni

È innanzitutto necessario creare un profilo di test specifico che consenta di controllare correttamente il messaggio transazionale.

Definizione di un profilo di test specifico

Definite un profilo di test che sarà collegato all'evento, per consentirvi di visualizzare l'anteprima del messaggio e inviare una prova pertinente.

  1. Dal dashboard dei messaggi transazionali, fate clic sul pulsante Create test profile.

  2. Specifica le informazioni da inviare in formato JSON nella sezione Event data used for personalization. Tale contenuto verrà utilizzato al momento della visualizzazione dell’anteprima del messaggio e quando il profilo di test riceve la bozza.

    Nota

    Puoi inoltre inserire le informazioni relative alla tabella del profilo. Consulta Arricchimento del contenuto dei messaggi transazionali.

  3. Una volta creato, il profilo di test verrà prespecificato nel messaggio di transazione. Per controllare la destinazione della bozza, fai clic sul blocco Test profiles del messaggio.

Puoi anche creare un nuovo profilo di test o usarne uno già esistente nel menu Test profiles. Per eseguire questa operazione:

  1. Fai clic sul logo Adobe Campaign nell’angolo in alto a sinistra, quindi seleziona Profiles & audiences > Test profiles.

  2. Nella sezione Event, selezionate l'evento appena creato. In questo esempio, seleziona "Abbandono carrello (EVTcartAbandonment)".

  3. Nella casella di testo Event data, specifica le informazioni da inviare in formato JSON.

  4. Salva le modifiche.

  5. Accedete al messaggio creato e selezionate il profilo di test aggiornato.

Argomenti correlati:

Invio della prova

Dopo aver creato uno o più profili di test specifici e aver salvato il messaggio transazionale, potete inviare una prova per verificarlo.

La procedura per l’invio di una bozza è illustrata nella sezione Invio di una bozza.

Pubblicazione di un messaggio sulle transazioni

Dopo aver controllato il messaggio sulle transazioni, puoi eseguirne la pubblicazione.

Ora, non appena si attiva l’evento "Abbandono carrello", viene visualizzato automaticamente un messaggio contenente il titolo e il cognome del destinatario, l’URL del carrello, l’ultimo prodotto visionato o un elenco di prodotti, se definito, e l’importo totale del carrello da inviare.

Per accedere ai rapporti relativi al messaggio sulle transazioni, usa il pulsante Reports. Consulta Rapporti.

Sospensione di una pubblicazione di un messaggio sulle transazioni

Puoi sospendere la pubblicazione del messaggio sulle transazioni utilizzando, ad esempio, il pulsante Pause per la modifica dei dati contenuti nel messaggio. Pertanto, gli eventi non vengono più elaborati, ma rimangono in coda nel database di Adobe Campaign.

Gli eventi in coda vengono conservati durante un periodo di tempo definito nell’API REST (consulta la documentazione REST API) o nell’evento trigger, se utilizzi il servizio core Triggers (vedi Utilizzo di Campaign e Triggers di Experience Cloud).

Durante la selezione di Resume, vengono elaborati tutti gli eventi in coda, purché non siano scaduti. Adesso tali eventi contengono tutte le modifiche apportate durante la sospensione della pubblicazione del modello.

Annullamento della pubblicazione di un messaggio sulle transazioni

Facendo clic su Unpublish puoi annullare la pubblicazione dei messaggi sulle transazioni, ma anche la pubblicazione dell’evento corrispondente, che elimina dall’API REST la risorsa corrispondente all’evento creato in precedenza.

Adesso, anche se l’evento viene attivato nel sito web, i messaggi corrispondenti non saranno più inviati e pertanto non verranno memorizzati nel database.

Nota

Per pubblicare nuovamente il messaggio, devi tornare alla configurazione dell’evento corrispondente e pubblicarla, infine pubblicare il messaggio. Per ulteriori informazioni, consulta Pubblicazione di un messaggio sulle transazioni.

Se annulli la pubblicazione di un messaggio sulle transazioni in sospensione, potresti dover attendere fino a 24 ore prima di poterlo pubblicare nuovamente. In questo modo, il flusso di lavoro Database cleanup eliminerà tutti gli eventi inviati alla coda.

La procedura per la sospensione di un messaggio è spiegata nei dettagli nella sezione Sospensione della pubblicazione di un messaggio sulle transazioni.

Il flusso di lavoro Database cleanup, che viene eseguito ogni giorno alle 4.00, è accessibile tramite Administration > Application settings > Workflows.

Eliminazione di un messaggio sulle transazioni

Dopo aver annullato la pubblicazione di un messaggio sulle transazioni o se tale messaggio non è ancora stato pubblicato, puoi eseguirne l’eliminazione dall’elenco dei messaggi sulle transazioni. Per eseguire questa operazione:

  1. Fai clic sul logo Adobe Campaign nell’angolo in alto a sinistra, quindi seleziona Marketing plans > Transactional messages > Transactional messages.
  2. Passa il mouse sopra il messaggio desiderato.
  3. Fai clic sul pulsante Delete element.

Tuttavia, l’eliminazione di un messaggio sulle transazioni può essere eseguita solo in presenza di determinate condizioni:

  • Assicurati che il messaggio sulle transazioni presenti lo stato Draft, altrimenti non potrai eliminarlo. Lo stato Draft si applica a un messaggio che non è ancora stato pubblicato o che è stato annullato (e non è stato sospeso).

  • Messaggi sulle transazioni: a meno che un altro messaggio sulle transazioni non sia collegato all’evento corrispondente, se il messaggio sulle transazioni non viene pubblicato, anche la configurazione dell’evento deve essere annullata onde consentire una corretta eliminazione del messaggio sulle transazioni. Per ulteriori informazioni, consulta Annullamento della pubblicazione di un evento.

    IMPORTANTE

    Se elimini un messaggio sulle transazioni che ha già inviato delle notifiche, verranno cancellati anche i registri di invio e di tracciamento.

  • Messaggi sulle transazioni da un modello di evento predefinito (messaggi sulle transazioni interni): se un messaggio sulle transazioni interno è l’unico associato all’evento corrispondente, non è possibile eseguirne l’eliminazione. Devi innanzitutto creare un altro messaggio sulle transazioni effettuandone la duplicazione o utilizzando il menu Resources > Templates > Transactional message templates .

Procedura per l’esecuzione di un nuovo tentativo di messaggio sulle transazioni

Un messaggio sulle transazioni temporaneamente non consegnato è soggetto all’esecuzione di tentativi automatici fino alla scadenza della consegna. Per ulteriori informazioni sulla durata della consegna, consulta Parametri del periodo di validità.

Quando un messaggio sulle transazioni non viene inviato, vi sono due sistemi di esecuzione di un nuovo tentativo:

Procedura per l’esecuzione di un nuovo tentativo di elaborazione degli eventi

Se l’evento non può essere assegnato a una consegna di esecuzione, l’elaborazione dell’evento viene posticipata. I tentativi vengono quindi eseguiti fino a quando l’evento non viene assegnato a una nuova consegna di esecuzione.

Nota

Un evento posticipato non viene visualizzato nei registi di invio del messaggio sulle transazioni, poiché non è ancora stato assegnato a una consegna di esecuzione.

Ad esempio, non è stato possibile assegnare l’evento a una consegna di esecuzione perché il relativo contenuto non era corretto, si è verificato un problema con i diritti di accesso o con il marchio, è stato rilevato un errore durante l’applicazione delle regole di tipologia e così via. In questo caso, puoi sospendere il messaggio, modificarlo per risolvere il problema e infine pubblicarlo nuovamente. Il sistema di esecuzione di un nuovo tentativo lo assegnerà a una nuova consegna di esecuzione.

Procedura per l’esecuzione di un nuovo tentativo di invio del messaggio

Una volta che l’evento è stato assegnato a una consegna di esecuzione, il messaggio sulle transazioni può non riuscire a causa di un errore temporaneo, ad esempio se la cassetta postale del destinatario è piena. Per ulteriori informazioni, consulta Tentativi dopo un errore temporaneo di consegna.

Nota

Quando un evento viene assegnato a un’esecuzione di consegna, viene visualizzato nei registri di invio dell’esecuzione di consegna e solo in questa fase. Le consegne non riuscite vengono visualizzate nella scheda Execution list dei registri di invio dei messaggi transazionali.

Limitazioni del processo di ripetizione

Invio dell’aggiornamento dei registri

Nel processo di esecuzione dei nuovi tentativi, i registri di invio della nuova consegna esecuzione non vengono aggiornati immediatamente, poiché tale procedura avviene tramite un flusso di lavoro pianificato. Ciò significa che il messaggio potrebbe trovarsi nello stato Pending anche se l’evento sulle transazioni è stato elaborato dalla nuova consegna di esecuzione.

Consegna di esecuzione non riuscita

Non è possibile interrompere la consegna dell’esecuzione. Tuttavia, se la consegna dell’esecuzione corrente ha esito negativo, ne viene creata una nuova non appena viene ricevuto un nuovo evento, e tutti i nuovi eventi vengono elaborati dalla nuova consegna dell’esecuzione. Nessun nuovo evento viene elaborato dalla consegna dell’esecuzione non riuscita.

Se alcuni eventi già assegnati a una consegna dell’esecuzione sono stati posticipati e se tale consegna ha esito negativo, il sistema dei tentativi non assegna gli eventi posticipati alla nuova consegna dell’esecuzione, il che significa che tali eventi andranno perduti.

In questa pagina