Come abilitare e utilizzare le annotazioni delle e-mail per Gmail
Cosa imparerai
Scopri le annotazioni per le e-mail, che ti consentono di mostrare informazioni chiave nella visualizzazione elenco delle caselle di posta Gmail (cioè prima che qualcuno apra l’e-mail). Le annotazioni per le e-mail ti consentono di evidenziare un’offerta o una promozione (ad esempio, un codice coupon) oppure di mostrare immagini di prodotto direttamente nella casella di posta.
Il codice necessario per implementare le annotazioni di Gmail è supportato solo nelle e-mail HTML personalizzate o ibride. Non è possibile utilizzare questo codice con l'editor e-mail drag-and-drop di Klaviyo.
Consigliamo di usare le annotazioni per le e-mail solo ai marketer con competenze tecniche, o a chiunque abbia accesso a uno sviluppatore. Anche se il nostro prodotto supporta questa funzionalità, il nostro team di assistenza non può aiutarti a creare i tuoi modelli personalizzati oltre a fornirti le indicazioni generali incluse in questa documentazione. Al fine di garantire la sicurezza dei tuoi dati, il team di assistenza di Klaviyo non è in grado di aprire i tuoi file HTML.
Informazioni sulle annotazioni e-mail
Le annotazioni e-mail sono supportate nelle caselle di posta in arrivo mobili di Gmail per gli utenti con la scheda Promozioni abilitata. Queste annotazioni compaiono solo nella scheda Promozioni, non nella posta in arrivo principale.
Esistono 3 tipi di annotazioni:
- Offerta/promozione
Metti in evidenza una promozione o un'offerta, come un codice coupon o la spedizione gratuita, includendo la data di scadenza dell'offerta.
- Carosello di prodotti
Mostra un carosello di immagini dei prodotti, includendo facoltativamente dettagli del prodotto come nome e prezzo.
- Immagine singola
Mostra una sola immagine, insieme a testo aggiuntivo facoltativo.
L'aggiunta di questo codice offre a Gmail l'opzione di visualizzare annotazioni per la tua e-mail. Anche se un'e-mail contiene il codice per le annotazioni, queste potrebbero non essere visualizzate per ogni destinatario. Gmail sceglie quando e come mostrare le annotazioni in base alle impostazioni del destinatario e alla densità della posta in arrivo..
Prima di iniziare
Google mantiene una lista consentita di mittenti che possono utilizzare le annotazioni. Prima di utilizzare le annotazioni, devi richiedere che il tuo brand venga aggiunto a questa lista consentita.
Per richiedere a Google di aggiungerti alla lista consentita per le annotazioni, invia un'e-mail a p-Promo-Outreach@google.com con le seguenti informazioni:
- Tutti i domini (ad esempio example.com)
- Tutti i sottodomini (ad es. send.example.com, blog.example.com, marketing-messages.example.com)
- L’URL o gli URL della tua landing page (ad esempio, la tua homepage)
Qualsiasi codice di annotazioni aggiunto ai tuoi messaggi verrà ignorato finché non sarai aggiunto alla lista consentita di Google, il che può richiedere 7–10 giorni lavorativi o più.
Klaviyo non ha visibilità sul processo di allowlisting e non può accelerare la tua richiesta. Se hai domande sul processo di whitelisting o sullo stato della tua richiesta, contatta p-Promo-Outreach@google.com.
Aggiungi annotazioni alle tue e-mail
Aggiungi il seguente codice nella sezione body del tuo modello di e-mail HTML per aggiungere annotazioni e-mail. Sono disponibili 3 tipi di annotazioni:
Offerta
<div itemscope itemtype="http://schema.org/DiscountOffer">
<meta itemprop="description" content="DESCRIPTION"/>
<meta itemprop="discountCode" content="DISCOUNT_CODE"/>
<meta itemprop="availabilityStarts" content="START_DATE_TIME"/>
<meta itemprop="availabilityEnds" content="END_DATE_TIME"/>
</div>
Sostituisci i seguenti segnaposto nel codice:
- DESCRIZIONE
Una breve descrizione testuale (1-2 righe) dell’offerta - DISCOUNT_CODE
Il codice che un destinatario può inserire al momento del pagamento per ricevere l’offerta - START_DATE_TIME
La data/ora di inizio dell'offerta, usando il formato ISO 8601 - END_DATE_TIME
La data/ora di fine dell'offerta, utilizzando il formato ISO 8601
Carosello dei prodotti
<div itemscope itemtype="http://schema.org/PromotionCard">
<meta itemprop="image" content="IMAGE_URL1"/>
<meta itemprop="url" content="PROMO_URL1"/>
// Optionally, include the following PromotionCard properties:
<meta itemprop="headline" content="HEADLINE1"/>
<meta itemprop="price" content="PRICE1"/>
<meta itemprop="priceCurrency" content="PRICE_CURRENCY1"/>
<meta itemprop="discountValue" content="DISCOUNT_VALUE1"/>
<meta itemprop="position" content="POSITION"/>
</div>
// Build the second image preview in your product carousel:
<div itemscope itemtype="http://schema.org/PromotionCard">
<meta itemprop="image" content="IMAGE_URL2"/>
<meta itemprop="url" content="PROMO_URL2"/>
// Optionally, include the following PromotionCard properties:
<meta itemprop="headline" content="HEADLINE2"/>
<meta itemprop="price" content="PRICE2"/>
<meta itemprop="priceCurrency" content="PRICE_CURRENCY2"/>
<meta itemprop="discountValue" content="DISCOUNT_VALUE2"/>
<meta itemprop="position" content="POSITION"/>
</div>
// To include more image previews, add additional PromotionCard objects.
// You can include up to 10 image previews in a product carousel.
Sostituisci i seguenti segnaposto nel codice:
- IMAGE_URL1, IMAGE_URL2, ecc.
L'URL di un'immagine del prodotto da visualizzare nel carosello. I rapporti di aspetto supportati sono 4:5, 1:1 e 1,91:1. Il rapporto di aspetto per ogni immagine deve essere lo stesso. - PROMO_URL1, PROMO_URL2, ecc.
L’URL di una landing page per i destinatari che fanno clic sull’immagine del prodotto. - TITOLO1, TITOLO2, ecc.
Una breve descrizione del prodotto di 1-2 righe. - PRICE1, PRICE2, ecc.
Il prezzo base del prodotto (solo numero, senza valuta). - PRICE_CURRENCY1, PRICE_CURRENCY2 e così via
Il codice valuta a 3 lettere (ad esempio USD) per il prezzo dell'articolo. - DISCOUNT_VALUE1, DISCOUNT_VALUE2, ecc.
Se applicabile, l’importo dello sconto applicato a un articolo (solo numero, senza valuta). - POSIZIONE
(Facoltativo) un numero che indica la posizione di questo elemento nel carosello.
Immagine singola
<div itemscope itemtype="http://schema.org/PromotionCard">
<meta itemprop="image" content="IMAGE_URL1"/>
<meta itemprop="url" content="PROMO_URL1"/>
</div>
Sostituisci i seguenti segnaposto nel codice:
- IMAGE_URL1
L'URL di un'immagine del prodotto da mostrare nel carosello. I formati supportati sono 4:5, 1:1 e 1,91:1. - PROMO_URL1
L'URL di una landing page per i destinatari che fanno clic sull'immagine del prodotto.
Informazioni sull'estrazione automatica delle annotazioni
A volte Google estrae automaticamente i dati delle e-mail per aggiungere annotazioni, anche quando un mittente non ha aggiunto il codice descritto sopra. Questo dipende dalla discrezione di Google e non può essere controllato dal mittente.
Risoluzione dei problemi delle annotazioni
Google applica requisiti rigorosi per le annotazioni e potrebbero non essere visualizzate per diversi motivi. Se le tue annotazioni non vengono visualizzate dopo aver seguito le istruzioni di configurazione di questo articolo indicate sopra, prova i passaggi di risoluzione dei problemi riportati di seguito:
Assicurati che il tuo brand sia inserito nella allowlist
Google gestisce una lista consentita limitata di brand approvati che possono usare le annotazioni e-mail, per prevenire spam e abusi. Se non hai accesso, potresti doverlo richiedere a Google:
- Contatta Google utilizzando i passaggi descritti sopra.
- Attendi 7–10 giorni lavorativi per ricevere una risposta.
Non c'è alcuna garanzia che il tuo brand venga aggiunto alla lista consentita una volta richiesta, poiché è gestita esclusivamente a discrezione di Google.
Controlla la qualità delle immagini
Tutte le immagini usate per le annotazioni per le e-mail devono superare il filtro qualità di Google. Le immagini che non soddisfano i requisiti non verranno visualizzate nella casella di posta. Assicurati che le tue immagini soddisfino questi criteri:
- Alta qualità (ovvero superiore a 500 KB)
- Avere pochissimo testo, se non nessuno
- Sono rettangolari (non usare una maschera per rendere l’immagine rotonda o di un’altra forma)
- Hanno dimensioni di almeno 256 × 256 pixel
Non usare immagini univoche per destinatario
La stessa immagine deve essere usata per tutti i destinatari. Puoi aggiungere parametri di tracciamento univoci all’URL promozionale, ma non all’URL dell’immagine.
Evita di usare strumenti che generano immagini CID (ovvero immagini univoche per destinatario), perché le annotazioni non verranno mostrate se vengono utilizzate.
Considera il limite di densità di Gmail
Google limita il numero di immagini di annotazione che un utente può vedere nella propria casella di posta in un dato momento (cioè un "limite di densità"). Se la casella di posta di un destinatario contiene già diverse e-mail recenti con annotazioni, la tua potrebbe non essere visualizzata per evitare confusione. Questo limite è applicato esclusivamente a discrezione di Google e non può essere controllato dal mittente.
Tieni presente che le annotazioni potrebbero non comparire nell’invio di e-mail di anteprima
In genere, le annotazioni non appariranno nella posta in arrivo per le e-mail di test inviate solo a pochi destinatari. La funzionalità delle annotazioni è progettata per invii in blocco, quindi è probabile che le annotazioni appaiano solo quando un messaggio viene inviato a > 100 destinatari.
Assicurati di guardare nella scheda Gmail supportata.
Le annotazioni sono supportate per essere visualizzate solo nell'app per dispositivi mobili Gmail nella scheda Promozioni.
Le annotazioni non sono supportate per la visualizzazione in:
- Qualsiasi altra scheda nell'app Gmail, oltre a Promozioni
- Gmail visualizzato in qualsiasi browser web (ad esempio, il sito per dispositivi mobili o desktop)
- Posta in arrivo per gli utenti che non hanno attivato la scheda Promozioni nelle impostazioni di Gmail