Referência de promoções por e-mail

Esta página descreve os tipos usados para anotar e-mails promocionais e as propriedades associadas a eles. Esses tipos e propriedades são incluídos no cabeçalho de um e-mail promocional como JSON-LD.

Para saber mais, consulte o guia de introdução à marcação de e-mails.

Organização

O tipo Organization permite especificar um logotipo para incluir na promoção.

Nome Tipo Descrição
logo ImageObject ou URL O logotipo que aparece como um ícone do remetente. Use HTTPS em vez de HTTP para o URL.

DiscountOffer

O tipo DiscountOffer permite criar anotações de ofertas, que promovem os detalhes de uma oferta, como o código de desconto ou a data de validade.

Nome Tipo Descrição
description Texto Opcional. Um texto curto que aparece ao lado do ícone do selo da oferta, como Free shipping ou 20% off. Consulte as práticas recomendadas para o selo da oferta.
discountCode Texto Opcional. O código de desconto ou promoção da oferta, como 20PROMO. Consulte as práticas recomendadas para códigos de desconto.
availabilityStarts DateTime Opcional. A data e a hora em que a oferta começa no formato ISO 8601, como 2023-09-25T18:44:37-07:00.
availabilityEnds DateTime Opcional. A data e a hora de término da promoção no formato ISO 8601, como 2023-10-25T18:44:37-07:00. Consulte as práticas recomendadas para datas de validade.

PromotionCard

O tipo PromotionCard permite incluir uma prévia visual da sua promoção.

Nome Tipo Descrição
image ImageObject ou URL

Obrigatório. A prévia da imagem do e-mail no formato PNG ou JPEG.

As proporções aceitas são 4:5, 1:1 e 1, 91:1. As imagens são cortadas automaticamente no centro. Consulte as práticas recomendadas para imagens.

Para carrosséis de produtos, cada PromotionCard precisa ter uma imagem exclusiva e usar a mesma proporção.
url URL Obrigatório. O URL da promoção. Quando os usuários clicam na image do e-mail, eles são direcionados para esse URL.
headline Texto Opcional. Uma descrição de uma ou duas linhas da promoção que aparece abaixo da image.
price Texto

Opcional. O preço da promoção. Se você definir um discountValue, o price vai aparecer como o preço original da promoção antes da aplicação do desconto.
priceCurrency Texto Opcional. A moeda do preço no formato ISO 4217 de três letras, como USD. Determina o símbolo da moeda exibido com o preço.
discountValue Texto

Opcional. O valor subtraído do price para mostrar um preço ajustado. O preço ajustado é mostrado ao lado do preço original.

Por exemplo, se o discountValue for definido como 25, o price for definido como 100 e o priceCurrency for USD, o preço ajustado será mostrado como $75.

position Texto

Opcional. A posição do card no carrossel.