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

Nesta página, descrevemos os tipos usados para anotar o e-mail promocional e as propriedades associadas. Esses tipos e propriedades estão incluídos no cabeçalho de um e-mail promocional como JSON-LD.

Para saber mais, consulte o guia Primeiros passos com a marcação de e-mail.

Organização

O tipo Organization permite que você especifique um logotipo para incluir na promoção.

Nome Tipo Descrição
logo ImageObject ou URL O logotipo que aparece como um ícone para o remetente. É recomendável usar um URL HTTPS. Veja as práticas recomendadas para URL de logotipo.

Oferta de desconto

O tipo DiscountOffer permite criar anotações de transação, 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 exibido ao lado do ícone do selo da transação, como Free shipping ou 20% off. Veja as práticas recomendadas para o selo da oferta.
discountCode Texto Opcional. O código de desconto ou promoção da oferta, como 20PROMO. Veja 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. Veja as práticas recomendadas para data de validade.

Card promocional

O tipo PromotionCard permite incluir uma visualização da sua promoção.

Nome Tipo Descrição
image ImageObject ou URL

Obrigatório. A visualização da imagem do e-mail no formato PNG ou JPEG.

As proporções compatíveis são 4:5, 1:1 e 1, 91:1. As imagens são cortadas automaticamente. Veja 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 no 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 exibida em image.
price Texto

Opcional. O preço da promoção. Se você definir um discountValue, o price será exibido como o preço original da promoção antes que o desconto seja aplicado.

priceCurrency Texto Opcional. É a moeda do preço no formato ISO 4217 com três letras, como USD. Determina o símbolo de moeda exibido com o preço.
discountValue Texto

Opcional. O valor subtraído de price para exibir um preço ajustado. O preço ajustado é exibido ao lado do preço original.

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

position Texto

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