Fonti dati e tag di personalizzazione

I tag di personalizzazione ti permettono di personalizzare ogni email con dati reali. Scrivi {{field}} in qualsiasi punto di un blocco di testo — Hi {{first_name}}, your {{plan}} renews soon — e ogni destinatario vedrà i propri valori. Un progetto può collegare più fonti dati contemporaneamente: ciascuna riceve un breve alias, e i campi di una fonte diversa dal pubblico si scrivono come {{alias.field}} (per esempio {{products.name}}).

Tipi di fonte dati

Le fonti dati si gestiscono dalla sezione Fonti dati della tua dashboard (le liste contatti si trovano sotto Contatti). Esistono due tipi:

Tabelle ospitate

Una tabella memorizzata in MailInApp. Definisci le colonne, aggiungi righe dalla dashboard, e ogni colonna diventa un campo di personalizzazione. Ideale quando oggi i tuoi dati vivono in un foglio di calcolo. Le liste contatti sono tabelle ospitate con una colonna email garantita.

Connessioni API

Punta MailInApp verso un tuo endpoint HTTP che restituisce JSON. Le righe vengono recuperate lato server — dai nostri server, mai dalla casella di posta del destinatario né dai browser dei tuoi visitatori.

Tre modi per autenticare la connessione, scelti dal menu a tendina Autenticazione quando la configuri:

• Header statici — aggiungi header di richiesta (per esempio un header Authorization) con un valore fisso. L'opzione più semplice, e l'unica che avesse senso prima che un token potesse scadere.
• OAuth2 Client Credentials — un URL del token più un client ID e un secret. MailInApp li scambia con un token di accesso lato server, lo memorizza in cache e lo rinnova automaticamente prima della scadenza — lo schema più comune per la maggior parte delle integrazioni enterprise basate su chiave API e secret.
• OAuth2 JWT Bearer — un URL del token, issuer, subject, audience, e una chiave privata RSA (PEM). MailInApp firma una nuova asserzione JWT e la scambia con un token di accesso, senza login interattivo e senza refresh token da gestire — è così che si autenticano le integrazioni server-to-server di Salesforce (vedi la guida all'integrazione con Salesforce), e funziona allo stesso modo per un account di servizio Google o qualsiasi altro IdP che supporti questo flusso.

Qualunque modalità tu scelga, il bearer token risultante viene iniettato automaticamente come header Authorization — eventuali header aggiuntivi che aggiungi vengono comunque inviati insieme ad esso, unendosi (un header letteralmente chiamato Authorization lì viene ignorato, dato che il token generato ha sempre la precedenza). Tutti i campi delle credenziali — valori degli header, client secret, chiave privata — seguono la stessa regola:

• memorizzati solo lato server,
• mai inviati al browser,
• mascherati in ogni risposta API dopo averli salvati.

Modificare una connessione il cui secret appare mascherato e cliccare Verifica queste impostazioni richiede prima di reinserire il valore reale; Verifica connessione salvata invece esegue il controllo sulla credenziale esattamente come è memorizzata, senza mai reinviarla al tuo browser.

Collegare le fonti: il pannello Dati

Il pannello Dati dello Studio è dove un progetto dichiara quali fonti utilizza. + Aggiungi fonte dati… ne collega una (fino a 10 per progetto); ogni connessione ha tre parti:

• Alias — il nome breve usato dai suoi tag di personalizzazione: lettere minuscole, cifre e underscore, che inizia con una lettera (per esempio contacts, products, open_invoices). Rinominare un alias aggiorna automaticamente ogni blocco di ripetizione ad esso associato.
• Fonte — la tabella ospitata, la lista contatti o la connessione API che ci sta dietro.
• Ruolo — come l'email la utilizza:
  • Pubblico — la lista contatti a cui l'email viene inviata. Al massimo una per progetto, e deve essere una lista contatti. I suoi campi sono i tag semplici — {{first_name}}, {{email}} — risolti per ogni destinatario dalla propria riga al momento dell'invio. Il pubblico determina anche il selettore "Anteprima come" e l'attribuzione delle risposte per destinatario.
  • Campi di personalizzazione — campi leggibili sotto l'alias: {{alias.field}}, risolti dalla prima riga della fonte quando l'email viene renderizzata. Usalo per contenuti condivisi — il prodotto in evidenza, le statistiche della settimana — piuttosto che per dati per destinatario.
  • Righe di ripetizione — righe che alimentano i blocchi di ripetizione associati all'alias. Non contribuisce con alcun campo di personalizzazione al di fuori della ripetizione. Lo stesso ruolo collection alimenta anche i blocchi grafico KPI/a barre/lineare/a torta — vedi Associare i grafici a dati reali.

Ogni fonte collegata elenca i suoi campi come chip cliccabili — clicca su uno per copiare il tag di personalizzazione esatto e incollarlo in qualsiasi proprietà di testo. Gli editor delle condizioni di visualizzazione raggruppano il loro menu a tendina dei campi allo stesso modo: campi del destinatario (pubblico) più un gruppo per ogni fonte di personalizzazione.

Tag integrati

Un piccolo gruppo di tag è fornito dalla piattaforma stessa anziché da una fonte dati — il pannello Variabili nella barra laterale sinistra dello Studio li elenca insieme a qualsiasi variabile tu definisca; clicca su uno per copiarne il tag.

• {{recipient_email}} — l'indirizzo a cui viene inviata l'email.
• {{today}} / {{now}} — la data (o data e ora) in cui l'email viene aperta.
• {{unsubscribe_url}} — un link di disiscrizione con un clic, specifico per destinatario. Il preset Footer lo include già — vedi Invio ai tuoi contatti.

Un codice sconto del negozio monouso e specifico per destinatario non è un tag di personalizzazione — inserisci invece nell'email il blocco Sconto E-Commerce (solo per pubblici collegati a Shopify/WooCommerce), che genera e mostra automaticamente il proprio codice. Vedi Offerta sconto.

I tag integrati si risolvono solo negli invii reali (manuali, pianificati, o un invio di test in stile "Backfill") — l'anteprima e la tela dello Studio li mostrano vuoti o con un placeholder, come qualsiasi campo senza un valore di esempio.

Contenuti ripetuti

Il blocco ripetizione renderizza i suoi elementi figli una volta per ogni riga della fonte a cui è associato — una griglia di prodotti, un digest di articoli, un elenco di fatture aperte. Scegli la fonte per alias nell'Ispettore; all'interno della ripetizione, i tag si risolvono rispetto alla riga di ciascuna ripetizione.

Anteprima con dati reali

Il selettore dei dati di anteprima dello Studio renderizza la tela con qualsiasi riga della lista pubblico, così puoi verificare che {{first_name}} dica davvero Amina e non {{first_name}} prima di inviare. È possibile assegnare valori di anteprima anche ai campi di altre fonti.

Da sapere

• I campi mancanti per un destinatario vengono renderizzati come stringhe vuote — progetta in modo che un valore vuoto si legga comunque in modo naturale.
• Le pagine ospitate (vista live, moduli ospitati) risolvono i tag di personalizzazione per ogni destinatario al momento del rendering, così la personalizzazione sopravvive anche quando un destinatario lascia la propria casella di posta.
• I progetti creati prima del supporto multi-fonte continuano a funzionare senza modifiche: la loro unica fonte collegata compare automaticamente nel pannello Dati, e i tag semplici {{field}} si risolvono sempre rispetto al pubblico.