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 Primeiros passos com a marcação de e-mail.

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 para o remetente. Recomenda-se usar um URL HTTPS. Consulte as práticas recomendadas para o URL do logotipo.

DiscountOffer

O tipo DiscountOffer permite criar anotações de transações, 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 de oferta, como Free shipping ou 20% off. Consulte as práticas recomendadas para o selo de 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 a data de validade.

PromotionCard

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

Nome	Tipo	Descrição
image	ImageObject ou URL	Obrigatório. A visualização da imagem do e-mail em 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 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 no image do e-mail, eles são direcionados a esse URL.
headline	Texto	Opcional. Uma descrição de uma a duas linhas da promoção exibida em 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 aparece ao lado do original. Por exemplo, se discountValue for definido como 25, price como 100 e priceCurrency como USD, o preço ajustado será exibido como $75.
position	Texto	Opcional. A posição do card no carrossel.