Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Impostazioni account
Prima di iniziare a risolvere un problema, controlla le impostazioni a livello di account.
Assicurati di aver attivato le impostazioni riportate di seguito per testare le
esperienze più recenti nella scheda Promozioni di Gmail. Queste sono le impostazioni predefinite.
Immagini:mostra sempre.
Visualizzazione per conversazione:attiva.
Attiva il raggruppamento per la prima email:On.
Sfide relative alla creazione di email
Se hai problemi durante la creazione dell'email, le seguenti sezioni
possono esserti d'aiuto:
Impossibile inserire il codice nell'intestazione
A seconda di come funziona la creazione delle email, il sistema responsabile dell'offerta/del prodotto nel corpo dell'email è separato da quello che gestisce l'intestazione HTML (potrebbe non sapere quale offerta inserire nell'intestazione). Puoi inserire
una parte o l'intero tag script nel corpo dell'email, in modo che la parte del
sistema che gestisce le informazioni sull'offerta possa inserire l'intero tag script o la
parte contenente l'offerta <script>{"@type": "DiscountOffer", …}</script> nel
corpo.
I tag script vengono rimossi dal tuo fornitore di servizi email
Schema.org ha un modo per annotare i microdati che potrebbe essere consentito se la tua ESP non fa eccezioni.
Anziché <head><script>...</script></head>, un esempio di microdati potrebbe trovarsi
ovunque nell'HTML e avere questo aspetto:
Tag script separato per semplificare l'implementazione
Puoi dividere l'annotazione per evitare di inviare contenuti precedenti o se le funzionalità provengono
da un blocco di contenuti. Inserisci una parte del tag script nell'intestazione e il
resto in un blocco del corpo.
Ecco un esempio di inserimento solo del logo e dell'oggetto alternativo nell'intestazione, con i badge, la data di scadenza e l'anteprima dell'immagine dell'annotazione nel corpo dell'email:
In <head>
<scripttype="application/ld+json">
[{"@context":"http://schema.org/","@type":"Organization","logo":"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png"},{"@context":"http://schema.org/","@type":"EmailMessage",// An alternative subject line shown when deal badge or discount code is also displayed."subjectLine":"Alternate Subject Line"}]
</script>
Le sezioni seguenti illustrano i problemi comuni riscontrati quando si tenta di visualizzare
o testare l'email:
Non visualizzare i bundle di email
Assicurati di utilizzare un dispositivo con l'ultima versione dell'app Gmail.
Aggiorna l'email tirando verso il basso lo schermo nella scheda Promozioni.
Prova a riavviare il dispositivo.
Il problema persiste? Prova a visualizzare la pagina su un altro dispositivo. Ad esempio, un tablet
potrebbe avere una versione diversa di Gmail e mostrare il bundle in modo diverso.
Solo i consumatori vedono i bundle di email. L'esperienza non influisce sugli utenti di
.
L'email non viene inserita nella scheda Promozioni
Controlla se l'email è stata inviata dal solito sottodominio da cui vengono inviate le email di marketing. L'invio da sottodomini meno riconosciuti può confondere il classificatore della scheda Gmail
e impedire che un'email venga inserita nella scheda Promozioni.
Verifica che il tuo account non abbia filtri email che inviano email
alla scheda Principale.
Inviare da sottodomini mittente separati per assicurarsi che l'email finisca nella scheda corretta. Per maggiori dettagli sul classificatore di Gmail, consulta le linee guida per i mittenti collettivi.
Se utilizzi un account promotabtesting@gmail.com, questo è il comportamento previsto per la prima email. Trascina l'email nella scheda Promozioni
e invia un'email dallo stesso indirizzo mittente, con un oggetto diverso,
all'account di test. Ora dovresti essere in grado di visualizzarlo.
Visualizzazione di bundle, ma non dell'email annotata del tuo brand in un bundle
Controlla se l'email si trova nella scheda Promozioni di Gmail.
Assicurati che l'email non sia ancora stata aperta e non sia stata inviata in un giorno precedente.
Se un'email in un bundle viene visualizzata su un dispositivo, non viene visualizzata
di nuovo in un bundle su un altro dispositivo. Devi inviare una nuova email di prova per
visualizzare l'anteprima.
Ti consigliamo di creare più account di test se vuoi visualizzare i risultati su più dispositivi. Uno dei membri del tuo team potrebbe aprire l'email, impedendo
che venga inserita nel bundle per il resto del team.
Assicurati che l'annotazione nel codice dell'email inviata sia corretta (la scadenza
può impedire la visualizzazione dell'email se precedente alla data di inizio o scaduta).
Assicurati di utilizzare l'ultima versione dell'app Gmail. Prova a visualizzare l'email su un altro dispositivo. Ad esempio, un tablet potrebbe avere una versione diversa dell'app Gmail e mostrare l'email in modo diverso.
Aggiorna l'app Gmail trascinando verso il basso la schermata della scheda Promozioni di Gmail.
Prova a riavviare il dispositivo.
Non puoi utilizzare categorie sensibili nella scheda Promozioni di Gmail (ad esempio,
contenuti per adulti o recupero crediti).
Nessuna anteprima dell'immagine viene visualizzata quando l'immagine è inclusa nell'annotazione
Controlla il tag script per assicurarti che l'URL corretto sia nell'immagine inviata.
Aggiorna l'app Gmail trascinando verso il basso la schermata della scheda Promozioni di Gmail.
Se la tua immagine è considerata un argomento sensibile, potrebbe non essere
mostrata nella scheda Promozioni di Gmail (ad esempio, contenuti per adulti o recupero
dei crediti).
Visualizzazione del bundle su un dispositivo, ma non su un altro
Assicurati di visualizzare i contenuti dallo stesso account email.
Se l'email viene aperta prima su un dispositivo, la classificazione potrebbe cambiare e
non essere visualizzata nel bundle sull'altro dispositivo.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-04 UTC."],[],[],null,["# Troubleshooting\n\n| **Note:** For assistance with troubleshooting or to learn more about the following annotation features, send an email to [p-Promo-Outreach@google.com](mailto:p-Promo-Outreach@google.com).\n\nAccount settings\n----------------\n\nBefore you begin troubleshooting a problem, check your account-level settings.\nBe sure you've enabled the settings below in order to test the\nlatest experiences in the Gmail Promotions tab. These are the default settings.\n\n- **Images:** Always show.\n- **Conversation view:** On.\n- **Enable Bundling of Top Email:** On.\n\nChallenges with email construction\n----------------------------------\n\nIf you are having issues when building your email, the following sections\nmay help:\n\n### Can't put code into the head\n\nDepending upon how your email construction works, the system responsible for the\ndeal/product in the body of the email is separate from what handles the HTML\nhead (it may not know what deal to inject into the head). Feel free to insert\npart or all of the script tag in the body of the email, so that the part of the\nsystem handling the deal information can inject the entire script tag or the\npart containing the deal `\u003cscript\u003e{\"@type\": \"DiscountOffer\", ...}\u003c/script\u003e` into\nthe body.\n\n### Script tags get stripped by your email service provider\n\nSchema.org has a microdata way to annotate that may be allowed if your ESP won't\nmake an exception.\n\nInstead of `\u003chead\u003e\u003cscript\u003e...\u003c/script\u003e\u003c/head\u003e`, a microdata example could be\nanywhere in the html and look like this: \n\n \u003cdiv itemscope itemtype=\"http://schema.org/Organization\"\u003e\n \u003cmeta itemprop=\"logo\" content=\"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png\" /\u003e\n \u003c/div\u003e\n \u003cdiv itemscope itemtype=\"http://schema.org/DiscountOffer\"\u003e\n \u003cmeta itemprop=\"description\" content=\"20% off\" /\u003e\n \u003cmeta itemprop=\"discountCode\" content=\"PROMO\" /\u003e\n \u003cmeta itemprop=\"availabilityStarts\" content=\"2018-01-01T08:00:00-07:00\" /\u003e\n \u003cmeta itemprop=\"availabilityEnds\" content=\"2018-04-30T23:59:59-07:00\" /\u003e\n \u003c/div\u003e\n \u003cdiv itemscope itemtype=\"http://schema.org/PromotionCard\"\u003e\n \u003cmeta itemprop=\"image\" content=\"https://www.google.com/gmail-for-marketers/promo-tab/markup-tool/sample.png\" /\u003e\n \u003c/div\u003e\n\nThis alternate method can also be tested in our [preview tool](/workspace/gmail/promotab/overview).\n\n### Separate script tag for easier implementation\n\nYou can split the annotation to avoid sending old content or if features come\nfrom a content block. Place a portion of the script tag in the head and the\nrest in a block of the body.\n\nHere is an example of placing only the logo and alternate subject line in the\nhead, with the badges, expiration date, and image preview of the annotation in\nthe body of the email:\n\n#### In the `\u003chead\u003e`\n\n \u003cscript type=\"application/ld+json\"\u003e\n [{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"Organization\",\n \"logo\": \"https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png\"\n },{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"EmailMessage\",\n // An alternative subject line shown when deal badge or discount code is also displayed.\n \"subjectLine\": \"Alternate Subject Line\"\n }]\n \u003c/script\u003e\n\n#### In the `\u003cbody\u003e`\n\n \u003cscript type=\"application/ld+json\"\u003e\n [{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"DiscountOffer\",\n \"description\": \"20% Off\",\n \"discountCode\": \"PROMO\",\n \"availabilityStarts\": \"2019-01-01T08:00:00-07:00\",\n \"availabilityEnds\": \"2019-12-30T23:59:59-07:00\"\n },{\n \"@context\": \"http://schema.org/\",\n \"@type\": \"PromotionCard\",\n \"image\": \"https://www.google.com/gmail-for-marketers/promo-tab/markup-tool/sample.png\"\n }]\n \u003c/script\u003e\n\n| **Note:** You can't distribute your annotation fields between the head and body. For example, you can't place the deal badge and promo code of a discount offer (`\"@type\": \"DiscountOffer\"`) in the body while placing the expiration date in the head. If you attempt this, only one indeterminate portion of the annotation is displayed.\n\nChallenges seeing or testing email\n----------------------------------\n\nThe following sections discuss common issues encountered when attempting to view\nor test email:\n\n### Not seeing email bundles at all\n\n- Make sure you are on a device with the latest version of the Gmail App. Refresh email by pulling down on the screen within the Promotions tab.\n- Try restarting your device.\n- Still not working? Try viewing on another device---for example, a tablet may have a different Gmail version and show the bundle differently.\n- Only consumers see the email bundles. The experience does not impact Google Workspace users.\n\n| **Note:** There is a chance your email could be in a holdback group. If none of the above worked, create a new account ending in `promotabtesting@gmail.com`. For example, create `mycompanypromotabtesting@gmail.com` and use that new account for testing.\n\n### Email not going into the Promotions tab\n\n- Check if the email was sent from the usual subdomain marketing email are sent from. Sending from less recognized subdomains can confuse the Gmail tab classifier and prevent an email from being placed on the Promotions tab.\n- Check to make sure your account has no email filters which are sending email to the primary tab.\n- Send from separate sender subdomains to ensure email ends up in the correct tab. See [Bulk Senders Guidelines](https://support.google.com/mail/answer/81126) for more detail about the Gmail classifier.\n- If you are using a promotabtesting@gmail.com account this is the intended behaviour for the first email. Please drag the email into the Promotions tab, and send an email from the same sender address, with a different subject line, to the testing account. You should now be able to visualize it.\n\n### Seeing bundles, but not seeing your brand's annotated email in a bundle\n\n- Check if the email is in the Gmail Promotions tab.\n- Ensure the email has not yet been opened, and was not sent on a previous day.\n- If email in a bundle is viewed on one device, then that email doesn't populate in a bundle again on another device. You must send a new test email to preview.\n- We recommend creating multiple testing accounts if you want to visualize on multiple devices. One of the members of your team might open the email thus causing it not to populate in the bundle for the rest of the team.\n- Make sure the annotation in the sent email's code is correct (the expiration can cause email not to display if before the start date or expired).\n- Be sure you are using the latest version of the Gmail app. Try viewing on another device---for example, a tablet may have a different version of Gmail app and show email differently.\n- Refresh the Gmail app by pulling down the Gmail Promotions tab screen.\n- Try restarting your device.\n- You cannot use sensitive categories in the Gmail Promotions tab (for example, adult content or debt collection).\n\n### Not seeing an image preview display when image is included in the annotation\n\n- Check the script tag to ensure the correct URL is in your sent image.\n- Refresh the Gmail app by pulling down the Gmail Promotions tab screen.\n- If your image is considered to be a sensitive topic, the image may not be shown in the Gmail Promotions tab (for example, adult content or debt collection).\n\n### Seeing bundle on one device but not another\n\n- Make sure you are viewing from the same email account.\n- If email is opened on one device first, it may change the ranking and not show in bundle in the other device."]]