Documentazione Campaign Documentazione di Campaign Standard

Notifiche push transazionali

Ultimo aggiornamento: 19 luglio 2024

Argomenti:

Creato per:

Intermedio
Utente

Puoi utilizzare Adobe Campaign per inviare notifiche push transazionali su dispositivi mobili iOS e Android. Questi messaggi vengono ricevuti sulle app mobili che configuri in Adobe Campaign sfruttando l’SDK di Experience Cloud Mobile.

NOTE

Il canale push è opzionale. Controlla il contratto di licenza. Per ulteriori informazioni sulle notifiche push standard, vedere Informazioni sulle notifiche push.

Per poter inviare notifiche push transazionali, devi configurare Adobe Campaign di conseguenza. Vedi Configurazione di un'app mobile.

Puoi inviare due tipi di notifiche push transazionali:

Notifiche push transazionali con targeting di un evento
Notifiche push transazionali con targeting di profili dal database di Adobe Campaign

Notifiche push transazionali con targeting di un evento

Puoi utilizzare Adobe Campaign per inviare notifiche push transazionali anonime a tutti gli utenti che hanno acconsentito alla ricezione di notifiche dalla tua app mobile.

In questo caso, solo i dati contenuti nell'evento stesso vengono utilizzati per definire la destinazione della consegna. Non vengono utilizzati dati dal database dei profili integrato di Adobe Campaign.

Configurazione di una notifica push transazionale basata su eventi

Per inviare una notifica push transazionale a tutti gli utenti che hanno acconsentito alla ricezione di notifiche dall’app mobile, devi innanzitutto creare e configurare un evento che punti ai dati contenuti nell’evento stesso.

NOTE

Puoi comunque personalizzare il contenuto di una notifica push transazionale basata su eventi utilizzando attributi evento (dati dell'evento) e arricchimento evento (dati dal database di Campaign). Vedi l'esempio seguente.

L’evento deve contenere i tre elementi seguenti:

Un token di registrazione, che è l'ID utente per un'applicazione mobile e un dispositivo. Potrebbe non corrispondere ad alcun profilo dal database di Adobe Campaign.
Un nome applicazione mobile (uno per tutti i dispositivi: Android e iOS). Questo è l’ID dell’app mobile configurata in Adobe Campaign che verrà utilizzata per ricevere notifiche push sui dispositivi degli utenti. Per ulteriori informazioni, consulta Configurazione di un'app mobile.
Una piattaforma push ("gcm" per Android o "apns" per iOS).

Per configurare l’evento, effettua le seguenti operazioni:

Durante la creazione della configurazione dell'evento, selezionare il canale Push notification e la dimensione di targeting Real-time event (vedere Creazione di un evento).
Aggiungi campi all’evento. In questo modo potrai personalizzare il messaggio transazionale (vedi Definizione degli attributi dell'evento). In questo esempio, definisci i campi "gateNumber", "lastname" e "firstname".
Puoi anche arricchire il contenuto del messaggio. A questo scopo, aggiungi i campi dalla tabella collegata alla configurazione dell'evento (vedi Arricchimento dell'evento).
Anteprima e pubblicazione dell'evento.

Durante l’anteprima dell’evento, l’API REST contiene gli attributi "registrationToken", "application" e "pushPlatform" che verranno utilizzati per eseguire il targeting della consegna.

Dopo la pubblicazione dell’evento, viene creata automaticamente una notifica push transazionale collegata al nuovo evento. È ora possibile modificare e pubblicare il messaggio appena creato (vedere questa sezione).
Integrare l'evento nel sito Web (vedere Integrare l'attivazione dell'evento).

Invio di una notifica push transazionale basata su eventi

Ad esempio, una compagnia aerea desidera invitare gli utenti delle sue app mobili a passare al gate pertinente per l’imbarco.

L’azienda invierà una notifica push transazionale per utente (identificato con un token di registrazione), utilizzando un’app mobile, tramite un singolo dispositivo.

Vai al messaggio transazionale creato per modificarlo. Consulta Accesso ai messaggi transazionali.
Fai clic sul blocco Content per modificare il titolo e il corpo del messaggio.
È possibile inserire campi di personalizzazione per aggiungere elementi definiti al momento della creazione dell'evento (vedere Definizione degli attributi dell'evento).

Per trovare questi campi, fare clic sulla matita accanto a un elemento, fare clic su Insert personalization field e selezionare Context > Real-time event > Event context.

Per ulteriori informazioni sulla modifica di un contenuto di notifica push, vedere Preparazione e invio di una notifica push.
Puoi anche arricchire il contenuto dei messaggi transazionali se desideri utilizzare informazioni aggiuntive dal database di Adobe Campaign (vedi Arricchimento dell'evento).
Salva le modifiche e pubblica il messaggio. Consulta Pubblicazione di un messaggio transazionale.
Utilizzando l’API REST di Adobe Campaign Standard, invia un evento a un token di registrazione (ABCDEF123456789), utilizzando un’app mobile (WeFlight), su Android (gcm), contenente i dati di imbarco:
{ "registrationToken":"ABCDEF123456789", "application":"WeFlight", "pushPlatform":"gcm", "ctx": { "gateNumber":"Gate B18", "lastname":"Green", "firstname":"Jane" } }
Per ulteriori informazioni sull'integrazione dell'attivazione di un evento in un sistema esterno, vedere Integrare l'attivazione dell'evento.

Se il token di registrazione esiste, l’utente corrispondente riceve una notifica push transazionale con il seguente contenuto:

"Ciao Jane Green, l'imbarco è appena iniziato! Procedere al gate B18."

Notifiche push transazionali con targeting di profilo

Puoi inviare una notifica push transazionale ai profili Adobe Campaign che si sono abbonati alla tua app mobile. Questa consegna può contenere campi di personalizzazione, ad esempio il nome del destinatario, recuperati direttamente dal database di Adobe Campaign.

In questo caso, l'evento deve contenere alcuni campi che consentono la riconciliazione con un profilo dal database di Adobe Campaign.

Quando si esegue il targeting di profili, viene inviata una notifica push transazionale per app mobile e per dispositivo. Ad esempio, se un utente di Adobe Campaign si è abbonato a due applicazioni, riceverà due notifiche. Se un utente si è abbonato alla stessa applicazione con due dispositivi diversi, riceverà una notifica su ciascun dispositivo.

Le applicazioni mobili a cui un profilo si è abbonato sono elencate nella scheda Mobile App Subscriptions di questo profilo. Per accedere a questa scheda, selezionare un profilo e fare clic sul pulsante Edit profile properties a destra.

Per ulteriori informazioni sull'accesso e la modifica dei profili, vedere Informazioni sui profili.

Configurazione di una notifica push transazionale basata su profilo

Per inviare una notifica push transazionale ai profili Adobe Campaign che si sono abbonati alla tua app mobile, devi innanzitutto creare e configurare un evento che punti al database di Adobe Campaign.

Durante la creazione della configurazione dell'evento, selezionare il canale Push notification e la dimensione di targeting Profile (vedere Creazione di un evento).

Per impostazione predefinita, la notifica push transazionale viene inviata a tutte le app mobili a cui i destinatari si sono abbonati. Per inviare la notifica push a una specifica app mobile, selezionala nell’elenco. Le altre app mobili saranno oggetto del messaggio, ma saranno escluse dall’invio.
Aggiungere campi all'evento se si desidera personalizzare il messaggio transazionale (vedere Definizione degli attributi dell'evento).

NOTE
Devi aggiungere almeno un campo per creare un arricchimento. Non è necessario creare altri campi, ad esempio Nome e Cognome, poiché sarà possibile utilizzare i campi di personalizzazione del database di Adobe Campaign.
Creare un arricchimento per collegare l'evento alla risorsa Profile (vedere Arricchimento dell'evento) e selezionare l'arricchimento come Targeting enrichment.

IMPORTANT
Questo passaggio è obbligatorio per gli eventi basati su profilo.
Anteprima e pubblicazione dell'evento.

Durante la visualizzazione dell'anteprima dell'evento, l'API REST non contiene un attributo che specifica il token di registrazione, il nome dell'applicazione e la piattaforma push in quanto verranno recuperati dalla risorsa Profile.

Dopo la pubblicazione dell’evento, viene creata automaticamente una notifica push transazionale collegata al nuovo evento. È ora possibile modificare e pubblicare il messaggio appena creato (vedere questa sezione).
Integrare l'evento nel sito Web (vedere Integrare l'attivazione dell'evento).

Invio di una notifica push transazionale basata su profilo

Ad esempio, una compagnia aerea desidera inviare un’ultima chiamata per l’imbarco a tutti gli utenti di Adobe Campaign che si sono abbonati alla sua app mobile.

Vai al messaggio transazionale creato per modificarlo. Consulta Accesso ai messaggi transazionali.
Fai clic sul blocco Content per modificare il titolo e il corpo del messaggio.

A differenza delle configurazioni basate su eventi in tempo reale, puoi accedere direttamente a tutte le informazioni sul profilo per personalizzare il messaggio. Consulta Inserimento di un campo di personalizzazione.

Per ulteriori informazioni sulla modifica di un contenuto di notifica push, vedere Preparazione e invio di una notifica push.
Salva le modifiche e pubblica il messaggio. Consulta Pubblicazione di un messaggio transazionale.
Utilizzando l’API REST di Adobe Campaign Standard, invia un evento a un profilo:
{ "ctx": { "email":"janegreen@email.com", "gateNumber":"D16", } }

Per ulteriori informazioni sull'integrazione dell'attivazione di un evento in un sistema esterno, vedere Integrare l'attivazione dell'evento.

L’utente corrispondente riceve una notifica push transazionale contenente tutti gli elementi di personalizzazione recuperati dal database di Adobe Campaign.

NOTE

Non sono presenti campi del token di registrazione, dell’applicazione e della piattaforma push. In questo esempio, la riconciliazione viene eseguita con il campo e-mail.

Modifica della mappatura di destinazione in una notifica push transazionale

Le notifiche push transazionali utilizzano una mappatura di destinazione specifica contenente le impostazioni tecniche necessarie per inviare questo tipo di consegne.

Per modificare questa mappatura di destinazione, effettua le seguenti operazioni:

Dall’elenco dei messaggi transazionali, seleziona una notifica push.
Nel dashboard dei messaggi fare clic sul pulsante Edit properties.
Espandere la sezione Advanced parameters.
Fai clic su Select a ‘Target mapping’ element.
Seleziona una mappatura di destinazione dall’elenco.

NOTE
Per ottimizzare i tempi di preparazione e le prestazioni durante l'invio di notifiche push transazionali basate sul profilo, utilizza la mappatura di destinazione Profile - Real-time event for Push (mapRtEventAppSubRcp).
Conferma la modifica e pubblica il messaggio. Consulta Pubblicazione di un messaggio transazionale.

IMPORTANT
Devi pubblicare nuovamente il messaggio affinché la modifica sia effettiva, altrimenti verrà ancora utilizzata la mappatura di destinazione precedente.

recommendation-more-help