Aggiunta di contenuti personalizzati ai modelli di messaggio - Amazon Pinpoint

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiunta di contenuti personalizzati ai modelli di messaggio

Per offrire contenuti dinamici e personalizzati nei messaggi che utilizzano un modello, aggiungi variabili di messaggio al modello di messaggio. Una variabile di messaggio è un segnaposto che fa riferimento a un attributo specifico creato da te o da Amazon Pinpoint per archiviare le informazioni sugli utenti. Ogni attributo corrisponde in genere a una caratteristica di un utente, ad esempio il nome o la città in cui vive. Aggiungendo variabili di messaggio ai modelli, è possibile utilizzare questi attributi per offrire contenuti personalizzati a ciascun destinatario di un messaggio che usa un modello.

Se un modello contiene variabili di messaggio, Amazon Pinpoint sostituisce ogni variabile con il valore corrente corrispondente dell'attributo per ciascun destinatario. Esegue questa operazione ogni volta che invia un messaggio che utilizza il modello. Ciò significa che puoi inviare contenuti personalizzati a ciascun destinatario senza creare più versioni personalizzate di un messaggio o di un modello di messaggio. Puoi anche avere la certezza che il messaggio contiene le informazioni più recenti disponibili su un destinatario.

Ad esempio, se il progetto è un'applicazione di fitness per chi corre e include attributi su nome, attività preferita e record personale di ciascun utente, potresti utilizzare le seguenti variabili di testo e messaggio in un modello:

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

Quando invii un messaggio che utilizza il modello, Amazon Pinpoint sostituisce le variabili con il valore corrente di ciascun attributo per ciascun destinatario, come mostrato negli esempi seguenti.

Esempio 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

Esempio 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

Se un valore di attributo non esiste per un destinatario, Amazon Pinpoint può sostituire una variabile con un valore predefinito specificato per la variabile. Ad esempio, se un utente di un'applicazione di fitness non ha scelto la propria attività preferita, puoi utilizzare running come valore predefinito della variabile {{User.UserAttributes.Activity}}. In questo caso, Amazon Pinpoint sostituisce la variabile nel modo illustrato negli esempi seguenti:

Esempio 1

Hi Jane, congratulations on your new running record of 1:42:17!

Esempio 2

Hi John, congratulations on your new running record of 20:52!

Se non specifichi un valore predefinito e un valore non esiste per un destinatario, Amazon Pinpoint omette tutto il testo della variabile quando invia un messaggio a tale destinatario. Per esempio:

Hi Mary, congratulations on your new record of 20:52!

Come best practice, si consiglia di specificare un valore predefinito per ogni variabile inclusa in un modello.

Aggiunta di variabili di messaggio

Puoi aggiungere attributi di messaggio a un nuovo modello o a un modello esistente. Se aggiungi variabili a un modello esistente, Amazon Pinpoint non applica necessariamente le modifiche ai messaggi che utilizzano il modello e che non sono ancora stati inviati, ad esempio i messaggi di una campagna di cui è pianificato l'invio in un secondo momento. Questo dipende dalla versione del modello a cui aggiungi le variabili e dal modo in cui sono stati configurati i messaggi che utilizzano il modello. Per ulteriori informazioni, consulta Gestione delle versioni dei modelli di messaggio.

Nota

I modelli di messaggistica in-app non supportano l'uso di variabili di messaggio.

Per aggiungere una variabile di messaggio a un modello di messaggio
  1. Apri la console Amazon Pinpoint all'indirizzo. https://console.aws.amazon.com/pinpoint/

  2. Nel riquadro di navigazione scegliere Message templates (Modelli di messaggio).

  3. Nella pagina Message templates (Modelli di messaggio), eseguire una delle seguenti operazioni:

    • Per creare un nuovo modello e aggiungervi una variabile di messaggio, scegliere Create template (Crea modello). Quindi, nella pagina del modello, immettere un nome per il modello e, facoltativamente, una descrizione del modello.

    • Per aggiungere una variabile di messaggio a un modello esistente, selezionare il modello a cui si desidera aggiungere una variabile. Quindi, nella pagina del modello, selezionare Edit (Modifica). In Template details (Dettagli modello) utilizzare il selettore di versione per scegliere la versione da utilizzare come punto di partenza. Se si sceglie la versione più recente, è possibile salvare le modifiche direttamente in quella versione del modello. In caso contrario, è possibile salvare le modifiche come nuova versione del modello.

  4. Nella sezione dei dettagli del messaggio, determinare la posizione dove si desidera aggiungere una variabile di messaggio. Puoi aggiungere una variabile al corpo del messaggio di qualsiasi tipo di modello. Per i modelli e-mail e di notifica push, puoi anche aggiungere una variabile all'oggetto o al titolo del messaggio.

  5. In Attribute finder (Ricerca attributi), espandere la sezione relativa al tipo di attributo per cui si desidera aggiungere una variabile di messaggio. È possibile scegliere tra i seguenti tipi di attributi:

    Standard attributes (Attributi standard)

    Questi sono attributi creati automaticamente da Amazon Pinpoint per qualsiasi progetto. Ciò significa che è possibile utilizzarli nei messaggi inviati per qualsiasi progetto. Per informazioni dettagliate su ciascuno di questi attributi, vedere Attributi supportati.

    Per aggiungere una variabile per un attributo standard, scegliere l'attributo dall'elenco.

    Attributi personalizzati

    Si tratta di attributi che puoi creare facoltativamente per singoli progetti. Poiché questi attributi potrebbero non essere disponibili per alcuni dei tuoi progetti, Amazon Pinpoint potrebbe non essere in grado di sostituire la variabile con un valore per ogni destinatario di un messaggio che utilizza il modello. Per evitare questo problema, in Amazon Pinpoint sono disponibili opzioni che consentono di scegliere un attributo esistente per progetti specifici o per tutti i progetti.

    Per aggiungere un attributo personalizzato

    1. Scegli Attributi personalizzati, quindi scegli Carica attributi personalizzati. Nella finestra visualizzata, Amazon Pinpoint elenca tutti i progetti che hai creato. Quando scegli i singoli progetti, gli attributi comuni ai progetti selezionati vengono visualizzati nel riquadro di navigazione a destra. Se non viene visualizzato alcun attributo, significa che non vi sono attributi comuni tra tali progetti.

    2. Esegui una di queste operazioni:

      • Per utilizzare tutti gli attributi comuni ai progetti selezionati, scegli Carica attributi personalizzati.

      • Per utilizzare un attributo specifico dall'elenco, inserisci una parte qualsiasi del nome dell'attributo nel campo di ricerca. Vengono visualizzati gli attributi corrispondenti al testo inserito. Scegli Carica attributi personalizzati quando viene visualizzato l'attributo che desideri utilizzare. La funzionalità Localizzatore di attributi mostra i nuovi attributi personalizzati aggiunti.

        Nota

        Non puoi aggiungere attributi comuni da diversi set di progetti o modificare la sezione Attributi personalizzati del Finder Attributi. Per modificare gli attributi personalizzati, scegli X per cancellare la finestra di ricerca degli attributi, quindi ricomincia.

    3. In Attribute finder (Ricerca attributi), scegliere l'attributo per cui si desidera aggiungere una variabile.

    Recommended attributes (Attributi suggeriti)

    Si tratta di attributi che è possibile creare per il proprio account quando si configura Amazon Pinpoint per recuperare raccomandazioni personalizzate da un modello della funzione di raccomandazione. Per informazioni sull'utilizzo dei modelli della funzione di suggerimento, consulta Modelli di machine learning. Puoi aggiungere variabili per questo tipo di attributo ai modelli di email, ai modelli di notifica push e ai SMS modelli. Non è possibile aggiungerli ai modelli vocali.

    Per aggiungere una variabile per un attributo suggerito, scegliere l'attributo dall'elenco. Se lo strumento di ricerca degli attributi non elenca alcun attributo consigliato, devi prima connettere il modello a un modello di raccomandazione.

    Per aggiungere un attributo consigliato

    1. Scegli Modello Connect.

    2. Seleziona il modello da cui desideri recuperare le raccomandazioni quando invii messaggi che utilizzano il modello.

    3. Scegli Modello Connect.

  6. Quando scegli un attributo nella finestra Localizzatore di attributi, Amazon Pinpoint crea una variabile di messaggio per l'attributo e la copia negli appunti. Incollare la variabile nella posizione desiderata. Se è presente un lungo elenco di attributi, inserisci il testo di ricerca per restringere l'elenco. Scegli X per cancellare il campo di ricerca.

    Dopo aver incollato la variabile, Amazon Pinpoint la visualizza come il nome dell'attributo associato, ad esempio racchiuso tra due serie di parentesi graffe, ad esempio {{User.UserAttributes.FirstName}}.

  7. Ripeti i passaggi da 4 a 6 per ogni variabile di messaggio che desideri aggiungere.

  8. Per specificare un valore predefinito per una variabile di messaggio, espandere la sezione Default attribute values (Valori attributo predefiniti) . Quindi, nell'elenco delle variabili, inserire il valore predefinito che si desidera utilizzare per la variabile.

    Nota

    Si consiglia di eseguire questa operazione per ogni variabile nel modello. In caso contrario, è possibile che Amazon Pinpoint non sia in grado di inviare un messaggio che utilizza il modello o che il messaggio venga visualizzato in modi imprevisti o indesiderati.

  9. Al termine, effettuare una delle seguenti operazioni:

    • Se sono state aggiunte variabili di messaggio a un nuovo modello, scegliere Create (Crea).

    • Se sono state aggiunte variabili di messaggio a un modello esistente e si vuole salvare le modifiche come nuova versione del modello, scegliere Save as new version (Salva come nuova versione).

    • Se sono state aggiunte variabili di messaggio a un modello esistente e si vuole salvare le modifiche come aggiornamento della versione recente del modello, scegliere Update version (Aggiorna versione). Questa opzione è disponibile solo se è stata aperta la versione più recente del modello nel passaggio 3.

Attributi supportati

Ogni progetto può avere attributi standard e attributi personalizzati. Gli attributi standard sono attributi forniti automaticamente da Amazon Pinpoint per qualsiasi progetto. Gli attributi personalizzati sono attributi che è possibile creare per un progetto. Esistono tre tipi di attributi personalizzati:

  • Attributi utente: questi attributi descrivono un utente, ad esempio il nome, il cognome e la data di nascita di un utente. Un utente è un utente che ha un ID utente univoco per un progetto.

  • Attributi endpoint: questi attributi descrivono un endpoint specifico per un utente. Un endpoint è una destinazione alla quale puoi inviare messaggi, ad esempio un indirizzo e-mail, un numero di telefono o un dispositivo mobile. Ciascun utente può essere associato a uno o più endpoint. Ad esempio, se comunichi con un utente tramite e-mail e telefonoSMS, l'utente potrebbe essere associato a tre endpoint: uno per l'indirizzo e-mail dell'utente, un altro per il numero di cellulare dell'utente e un altro per il numero di telefono di casa (rete fissa) dell'utente.

  • Attributi metriche: questi attributi sono metriche numeriche che l'applicazione trasmette ad Amazon Pinpoint per i singoli endpoint, come il numero di sessioni per un'app per dispositivi mobili o il numero di articoli rimasti nel carrello.

  • Attributi Pinpoint: questi attributi sono identificatori univoci per la tua applicazione, campagna o percorso.

Oltre agli attributi personalizzati e standard creati da te o da Amazon Pinpoint per i progetti, Amazon Pinpoint supporta gli attributi consigliati. Un attributo consigliato è un attributo che archivia temporaneamente le raccomandazioni personalizzate per utenti o endpoint. Amazon Pinpoint recupera queste raccomandazioni dai modelli di raccomandazione che configuri per l'uso. Gli attributi consigliati non sono associati a progetti specifici. Sono invece associati al tuo account Amazon Pinpoint. Per informazioni sull'utilizzo dei modelli della funzione di suggerimento, consulta Modelli di machine learning.

Puoi utilizzare qualsiasi attributo standard, personalizzato o suggerito in una variabile di messaggio. Nella tabella seguente sono indicati il testo che appare nella variabile di messaggio per ogni attributo supportato e la descrizione di ciascun attributo. Nella tabella, custom_attribute indica il testo che appare in una variabile per un attributo personalizzato. In questi casi, sostituisci custom_attribute con il nome dell'attributo personalizzato. Ad esempio, se il progetto memorizza i nomi degli utenti in un attributo utente personalizzato denominato FirstName e aggiungi una variabile per tale attributo, il testo per la variabile è {{User.UserAttributes.FirstName}}.

Attributo Descrizione
Address Indirizzo di destinazione per i messaggi o le notifiche push che invii all'endpoint, ad esempio un indirizzo e-mail, un numero di telefono o un token del dispositivo.
Pinpoint.ApplicationId L'identificatore univoco dell'applicazione.
Attributes.custom_attribute Un attributo endpoint personalizzato che descrive l'endpoint.
Pinpoint.CampaignId L'identificatore univoco per la campagna.
ChannelType Il canale da utilizzare per l'invio di messaggi o notifiche push all'endpoint. Per esempio:
  • APNS— Per un endpoint in grado di ricevere notifiche push inviate tramite il canale del servizio Apple Push Notification (APNs) alle app in esecuzione su dispositivi iOS.

  • EMAIL: per un endpoint che può ricevere messaggi e-mail.

  • GCM— Per un endpoint in grado di ricevere notifiche push inviate tramite il canale Firebase Cloud Messaging (FCM) alle app in esecuzione su dispositivi Android.

  • SMS— Per un endpoint in grado di ricevere messaggi di testo. SMS

  • VOICE: per un endpoint che può ricevere messaggi vocali.

CreationDate La data e l'ora in cui l'endpoint è stato aggiunto al progetto, in formato ISO8601. Ad esempio, 2019-06-30T11:45:25.220Z per le 11:45 del 30 UTC giugno 2019.
Demographic.AppVersion Il numero di versione dell'applicazione associata all'endpoint.
Demographic.Locale La localizzazione dell'endpoint, nel seguente formato: il codice ISO639-1 alpha-2, seguito da un trattino basso (_), seguito da un valore alfa-2 3166-1. ISO Ad esempio, en_US è l'impostazione locale della lingua inglese per gli Stati Uniti.
Demographic.Make Il produttore del dispositivo endpoint, ad esempio apple o samsung.
Demographic.Model Il nome del modello o il numero del dispositivo endpoint, ad esempio iPhone o SM-G900F.
Demographic.ModelVersion La versione del modello del dispositivo endpoint.
Demographic.Platform Il sistema operativo del dispositivo endpoint, ad esempio ios o android.
Demographic.PlatformVersion La versione del sistema operativo del dispositivo endpoint.
Demographic.Timezone Il fuso orario dell'endpoint, espresso come valore del database tz. Ad esempio, America/Los_Angeles per l'ora del Pacifico (Nord America).
EffectiveDate La data e l'ora dell'ultimo aggiornamento dell'endpoint, in formato 8601. ISO Ad esempio, 2019-08-23T10:54:35.220Z per le 10:54 del 23 UTC agosto 2019.
EndpointId L'identificatore univoco per l'endpoint.
EndpointStatus Se inviare messaggi o notifiche push all'endpoint: ACTIVE inviare messaggi all'endpoint oppureINACTIVE, non inviare messaggi all'endpoint.
Id L'identificatore univoco per l'endpoint.
Pinpoint.JourneyId L'identificatore univoco del viaggio.
Location.City La città in cui si trova l'endpoint.
Location.Country Il codice a due caratteri, in formato ISO 3166-1 alfa-2, per il paese o la regione in cui si trova l'endpoint. Ad esempio, US per gli Stati Uniti.
Location.Latitude La latitudine della posizione dell'endpoint, arrotondata a una posizione decimale.
Location.Longitude La longitudine della posizione dell'endpoint, arrotondata a una posizione decimale.
Location.PostalCode Il codice postale o il ZIP codice dell'area in cui si trova l'endpoint.
Location.Region Nome della regione, ad esempio uno stato o una provincia, in cui si trova l'endpoint.
Metrics.custom_attribute Una metrica numerica personalizzata che la applicazione trasmette ad Amazon Pinpoint per l'endpoint.
OptOut Se l'utente ha scelto di non ricevere messaggi e notifiche push da te: ALL o se l'utente ha scelto di non ricevere messaggi o notifiche push, oppure se non ha scelto di non ricevere messaggi o notifiche push e desidera ricevere tutti i messaggi e le notifiche push. NONE
RecommendationItems Attributo standard suggerito che memorizza un suggerimento per l'endpoint o l'utente. Questo attributo contiene testo fornito direttamente da un modello della funzione di suggerimento.
RecommendationItems.[#]

Attributo consigliato standard che archivia un elenco ordinato di 2–5 raccomandazioni per l'endpoint o l'utente. Questo attributo contiene testo fornito direttamente da un modello della funzione di suggerimento.

Il placeholder numerico (.[#]) indica che l'attributo contiene più valori. Una variabile di messaggio per questo attributo può fare riferimento a un valore specifico nell'elenco.

Recommendations.custom_attribute Attributo suggerito personalizzato che memorizza un suggerimento per l'endpoint o l'utente. Questo attributo contiene contenuti forniti da un modello di raccomandazione e migliorati da una funzione. AWS Lambda
Recommendations.custom_attribute.[#]

Attributo suggerito personalizzato che memorizza più suggerimenti per l'endpoint o l'utente. Questo attributo contiene contenuti forniti da un modello della funzione di suggerimento e migliorati da una funzione AWS Lambda .

Il placeholder numerico (.[#]) indica che l'attributo contiene più valori. Una variabile di messaggio per questo attributo può fare riferimento a uno di questi valori in modo specifico.

RequestId L'Identificatore univoco della richiesta più recente per aggiornare l'endpoint.
User.UserAttributes.custom_attribute Un attributo utente personalizzato che descrive l'utente.
User.UserId Un identificatore univoco per l'utente.