Esta página foi traduzida pela API Cloud Translation.

Fazer anotações em e-mails na guia "Promoções"

As anotações de e-mail dão vida às mensagens de e-mail na guia "Promoções" com recursos como imagens, ofertas e datas de validade.

Quando você faz anotações em e-mails, os usuários do Gmail visualizam e interagem com suas promoções diretamente na caixa de entrada. Na guia "Promoções", os usuários podem clicar no texto ou na imagem com anotação para saber mais sobre a promoção sem precisar abrir o e-mail.

Esta página explica como fazer anotações em e-mails usando JSON-LD e microdados. Para saber mais sobre a marcação de e-mails, consulte o Guia de primeiros passos. Para conferir uma lista de campos de marcação que podem ser usados em anotações de e-mail, acesse a documentação de referência.

Criar anotações de e-mail

É possível fazer anotações em e-mails para exibir os seguintes recursos na guia "Promoções":

Anotações de transação
Carrosséis de produtos

As seções a seguir explicam como criar cada tipo de anotação de e-mail.

Criar uma anotação da transação

As notas de transação exibem detalhes baseados em texto sobre uma promoção, como código promocional ou data de validade.

Para criar uma anotação de transação:

Na sua plataforma de e-mail de marketing, crie um e-mail e abra o editor HTML dele.

Na seção head, adicione uma tag script que inclua o tipo de dados DiscountOffer:

JSON-LD

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
  <head>
    <script type="application/ld+json">
      [{
        "@context": "http://schema.org/",
        "@type": "DiscountOffer",
        "description": "DESCRIPTION",
        "discountCode": "DISCOUNT_CODE",
        "availabilityStarts": "START_DATE_TIME",
        "availabilityEnds": "END_DATE_TIME"
      }]
    </script>
  </head>

  <body>
    // The message of your email
  </body>
</html>

Microdados

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
  <head>
    <div itemscope itemtype="http://schema.org/DiscountOffer">
      <meta itemprop="description" content="DESCRIPTION"/>
      <meta itemprop="discountCode" content="DISCOUNT_CODE"/>
      <meta itemprop="availabilityStarts" content="START_DATE_TIME"/>
      <meta itemprop="availabilityEnds" content="END_DATE_TIME"/>
    </div>
  </head>

  <body>
    // The message of your email.
  </body>
</html>

Substitua os valores a seguir. Todas as propriedades são opcionais. Para cada propriedade, você pode incluir um valor ou omitir a propriedade do seu código.

DESCRIPTION (opcional): o texto mostrado com o selo da oferta, como 20% off ou Free shipping.
DISCOUNT_CODE (opcional): o desconto ou código promocional da oferta, como 20TODAY.
START_DATE_TIME (opcional): a data e a hora em que a oferta começa no formato ISO 8601, como 2023-09-25T18:44:37-07:00.
END_DATE_TIME (opcional): a data e a hora de término da promoção no formato ISO 8601, como 2023-10-25T18:44:37-07:00.

Na tag body, escreva a mensagem do seu e-mail.

Criar um carrossel de produtos

Os carrosséis de produtos mostram várias visualizações de imagens para uma promoção, como estas:

Um e-mail promocional que mostra um carrossel com três imagens de ofertas de meias.

É possível incluir até 10 visualizações de imagem em um carrossel, e cada imagem precisa ser única.

Para criar um carrossel de produtos:

Na sua plataforma de e-mail de marketing, crie um e-mail e abra o editor HTML dele.

Na seção head, adicione uma tag script. Para cada imagem no carrossel de produtos, adicione um objeto PromotionCard:

JSON-LD

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
  <head>
    <script type="application/ld+json">
      [
        // Build the first image preview in your product carousel:
        {
          "@context": "http://schema.org/",
          "@type": "PromotionCard",
          "image": "IMAGE_URL1",
          "url": "PROMO_URL1",

          // Optionally, include the following PromotionCard properties:
          "headline": "HEADLINE1",
          "price": PRICE1,
          "priceCurrency": "PRICE_CURRENCY1",
          "discountValue": DISCOUNT_VALUE1,
          "position": POSITION
        },

        // Build the second image preview in your product carousel:
        {
          "@context": "http://schema.org/",
          "@type": "PromotionCard",
          "image": "IMAGE_URL2",
          "url": "PROMO_URL2",

          // Optionally, include the following PromotionCard properties:
          "headline": "HEADLINE2",
          "price": PRICE2,
          "priceCurrency": "PRICE_CURRENCY2",
          "discountValue": DISCOUNT_VALUE2,
          "position": POSITION
        }

        // To include more image previews, add additional PromotionCard objects.
        // You can include up to 10 image previews in a product carousel.

      ]
    </script>
  </head>

  <body>
    // The message of your email
  </body>
</html>

Microdados

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
  <head>
    // Build the first image preview in your product carousel:
    <div itemscope itemtype="http://schema.org/PromotionCard">
      <meta itemprop="image" content="IMAGE_URL1"/>
      <meta itemprop="url" content="PROMO_URL1"/>

      // Optionally, include the following PromotionCard properties:
      <meta itemprop="headline" content="HEADLINE1"/>
      <meta itemprop="price" content="PRICE1"/>
      <meta itemprop="priceCurrency" content="PRICE_CURRENCY1"/>
      <meta itemprop="discountValue" content="DISCOUNT_VALUE1"/>
      <meta itemprop="position" content="POSITION"/>
    </div>

    // Build the second image preview in your product carousel:
    <div itemscope itemtype="http://schema.org/PromotionCard">
      <meta itemprop="image" content="IMAGE_URL2"/>
      <meta itemprop="url" content="PROMO_URL2"/>

      // Optionally, include the following PromotionCard properties:
      <meta itemprop="headline" content="HEADLINE2"/>
      <meta itemprop="price" content="PRICE2"/>
      <meta itemprop="priceCurrency" content="PRICE_CURRENCY2"/>
      <meta itemprop="discountValue" content="DISCOUNT_VALUE2"/>
      <meta itemprop="position" content="POSITION"/>
    </div>

    // To include more image previews, add additional PromotionCard objects.
    // You can include up to 10 image previews in a product carousel.
  </head>

  <body>
    // The message of your email
  </body>
</html>

Para cada objeto PromotionCard, substitua os valores a seguir. Para as propriedades opcionais, você pode incluir um valor ou omitir a propriedade do seu código.

IMAGE_URL: o URL da imagem no formato PNG ou JPEG, como https://www.example.com/image.png. As proporções aceitas são 4:5, 1:1 e 1, 91:1. Para carrosséis de produtos, cada imagem precisa ter um URL exclusivo e usar a mesma proporção.
PROMO_URL: o URL da promoção. Quando os usuários clicam na imagem da guia "Promoções", eles acessam esse URL.
HEADLINE (opcional): uma descrição de uma a duas linhas da promoção exibida sob a imagem de visualização.
PRICE (opcional): o preço da promoção.
PRICE_CURRENCY (opcional): a moeda do preço no formato ISO 4217 de três letras, como USD. Determina o símbolo da moeda mostrado com o price.
DISCOUNT_VALUE (opcional): o valor subtraído de price para mostrar um preço ajustado. O preço ajustado aparece ao lado do original.

Por exemplo, se discountValue for 25, price for 100 e priceCurrency for USD, o preço ajustado será mostrado como $75.
POSITION (opcional): a posição do card no carrossel.

Na tag body, escreva a mensagem do seu e-mail.

Próximas etapas

Consulte a documentação de referência para saber mais sobre os campos de marcação de e-mail disponíveis.
Saiba mais sobre as práticas recomendadas para anotações de e-mail.