Riferimento alle promozioni via email
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive i tipi utilizzati per annotare le email promozionali e le relative proprietà associate. Questi tipi e proprietà sono inclusi nell'intestazione di un'email promozionale come JSON-LD.
Per scoprire di più, consulta la guida Introduzione al markup delle email.
Organizzazione
Il tipo Organization ti consente di specificare un logo da includere nella promozione.
DiscountOffer
Il tipo DiscountOffer ti consente di creare annotazioni
sulle offerte, che promuovono i dettagli di un'offerta, come il codice sconto o la data di scadenza.
Il tipo PromotionCard ti consente di includere un'anteprima visiva della promozione.
| Nome |
Tipo |
Descrizione |
image |
ImageObject o URL |
Obbligatorio. L'anteprima dell'immagine dell'email in formato PNG o JPEG. Le proporzioni supportate sono 4:5, 1:1 e 1.91:1. Le immagini vengono ritagliate automaticamente al centro. Consulta le best practice per le immagini. Per i caroselli di prodotti, ogni PromotionCard deve avere un'immagine univoca e utilizzare le stesse proporzioni. |
url |
URL |
Obbligatorio. L'URL della promozione. Quando gli utenti fanno clic sul image dell'email, vengono indirizzati a questo URL. |
headline |
Testo |
Facoltativo. Una descrizione della promozione di 1-2 righe visualizzata sotto image. |
price |
Testo |
Facoltativo. Il prezzo della promozione. Se imposti un discountValue, price viene visualizzato come prezzo originale della promozione prima dell'applicazione dello sconto. |
priceCurrency |
Testo |
Facoltativo. La valuta del prezzo in formato ISO 4217 a tre lettere, ad esempio USD. Determina il simbolo della valuta visualizzato con il prezzo. |
discountValue |
Testo |
Facoltativo. L'importo sottratto a price per visualizzare un prezzo adeguato. Il prezzo adeguato viene visualizzato accanto al prezzo originale. Ad esempio, se discountValue è impostato su 25, price è impostato su 100 e priceCurrency è USD, il prezzo adeguato viene visualizzato come $75. |
position |
Testo |
Facoltativo. La posizione della scheda nel carosello. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-03-24 UTC.
[null,null,["Ultimo aggiornamento 2025-03-24 UTC."],[],[],null,["# Email promotions reference\n\nThis page describes the types used to annotate promotional email and their\nassociated properties. These types and properties are included in a\npromotional email's header as\n[JSON-LD](/workspace/gmail/markup/reference/formats/json-ld).\n\nTo learn more, review\nthe [Email Markup Getting Started](/workspace/gmail/markup/getting-started) guide.\n\nOrganization\n------------\n\nThe `Organization` type lets you specify a logo to include in the promotion.\n\n| Name | Type | Description |\n|--------|--------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `logo` | [ImageObject](/workspace/gmail/markup/reference/types/ImageObject) or [URL](/workspace/gmail/markup/reference/types/URL) | The logo that displays as an icon for the sender. Recommended to use an HTTPS URL. See [best practices for Logo URL](/workspace/gmail/promotab/best-practices#logo_url). |\n\nDiscountOffer\n-------------\n\nThe `DiscountOffer` type lets you create [deal\nannotations](/workspace/gmail/promotab/overview#deal-annotation), which promote the\ndetails of an offer such as the discount code or expiration date.\n\n| Name | Type | Description |\n|----------------------|-------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `description` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. A short text that displays next to the deal badge icon, such as `Free shipping` or `20% off`. See [best practices for the deal badge](/workspace/gmail/promotab/best-practices#deal_badge). |\n| `discountCode` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The discount or promotion code of the offer, such as `20PROMO`. See [best practices for discount codes](/workspace/gmail/promotab/best-practices#discount_code). |\n| `availabilityStarts` | [DateTime](/workspace/gmail/markup/reference/datetime-formatting) | Optional. The date and time when the offer begins in [ISO 8601](https://support.google.com/merchants/answer/7055760) format, such as `2023-09-25T18:44:37-07:00`. |\n| `availabilityEnds` | [DateTime](/workspace/gmail/markup/reference/datetime-formatting) | Optional. The end date and time of the promotion in [ISO 8601](https://support.google.com/merchants/answer/7055760) format, such as `2023-10-25T18:44:37-07:00`. See [best practices for Expiration Date](/workspace/gmail/promotab/best-practices#expiration_date). |\n\nPromotionCard\n-------------\n\nThe `PromotionCard` type lets you include a visual preview of your promotion.\n\n| Name | Type | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `image` | [ImageObject](/workspace/gmail/markup/reference/types/ImageObject) or [URL](/workspace/gmail/markup/reference/types/URL) | Required. The image preview of the email in PNG or JPEG format. The supported aspect ratios are 4:5, 1:1, and 1.91:1. Images are center-cropped automatically. See [best practices for images](/workspace/gmail/promotab/best-practices#images). For product carousels, each `PromotionCard` must have a unique image and use the same aspect ratio. |\n| `url` | [URL](/workspace/gmail/markup/reference/types/URL) | Required. The URL for the promotion. When users click on the email's `image`, they are directed to this URL. |\n| `headline` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. A 1 to 2-line description of the promotion that is displayed under the `image`. |\n| `price` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The price of the promotion. If you set a `discountValue`, the `price` displays as the original price of the promotion before the discount is applied. |\n| `priceCurrency` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The currency of the price in 3-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, such as `USD`. Determines the currency symbol displayed with the price. |\n| `discountValue` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The amount subtracted from the `price` to display an adjusted price. The adjusted price is displayed next to the original price. For example, if the `discountValue` is set to `25`, the `price` is set to `100`, and the `priceCurrency` is `USD`, the adjusted price is displayed as `$75`. |\n| `position` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The position of the card in the carousel. |"]]
