Referencia de promociones por correo electrónico
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describen los tipos que se usan para anotar correos electrónicos promocionales y sus propiedades asociadas. Estos tipos y propiedades se incluyen en el encabezado de un correo electrónico promocional como JSON-LD.
Para obtener más información, consulta la guía de Introducción al lenguaje de marcado de correos electrónicos.
Organización
El tipo Organization te permite especificar un logotipo para incluirlo en la promoción.
DiscountOffer
El tipo DiscountOffer te permite crear anotaciones de oferta, que promocionan los detalles de una oferta, como el código de descuento o la fecha de vencimiento.
El tipo PromotionCard te permite incluir una vista previa visual de tu promoción.
| Nombre |
Tipo |
Descripción |
image |
ImageObject o URL |
Obligatorio. La vista previa de la imagen del correo electrónico en formato PNG o JPEG Las relaciones de aspecto admitidas son 4:5, 1:1 y 1.91:1. Las imágenes se recortan automáticamente en el centro. Consulta las prácticas recomendadas para las imágenes. En el caso de los carruseles de productos, cada PromotionCard debe tener una imagen única y usar la misma relación de aspecto. |
url |
URL |
Obligatorio. Es la URL de la promoción. Cuando los usuarios hacen clic en el image del correo electrónico, se los dirige a esta URL. |
headline |
Texto |
Opcional. Es una descripción de 1 a 2 líneas de la promoción que se muestra en image. |
price |
Texto |
Opcional. Es el precio de la promoción. Si estableces un discountValue, el price se mostrará como el precio original de la promoción antes de que se aplique el descuento. |
priceCurrency |
Texto |
Opcional. Es la moneda del precio en formato ISO 4217 de 3 letras, como USD. Determina el símbolo de moneda que se muestra con el precio. |
discountValue |
Texto |
Opcional. Es el importe que se resta de price para mostrar un precio ajustado. El precio ajustado se muestra junto al precio original. Por ejemplo, si discountValue se establece en 25, price se establece en 100 y priceCurrency es USD, el precio ajustado se muestra como $75. |
position |
Texto |
Opcional. Es la posición de la tarjeta en el carrusel. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-03-24 (UTC)
[null,null,["Última actualización: 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. |"]]
