Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES

Para habilitar o rastreamento detalhado do envio de e-mails, configure o Amazon SES para publicar eventos de envio de e-mail no Amazon CloudWatch, no Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service ou no Amazon EventBridge com base nas características que você definir.

Você pode rastrear vários tipos de eventos de envio de e-mail, incluindo envios, entregas, aberturas, cliques, devoluções, reclamações, rejeições, falhas de renderização e atrasos de entrega. Essas informações podem ser úteis para fins analíticos e operacionais. Por exemplo, é possível publicar seus dados de envio de e-mail no CloudWatch e criar painéis que acompanham a performance de suas campanhas de e-mail, ou você pode usar o Amazon SNS para enviar notificações quando determinados eventos ocorrerem.

Como a publicação de eventos funciona com conjuntos de configurações e etiquetas de mensagem

Para usar a publicação de eventos, primeiro você deve configurar um ou mais conjuntos de configurações. Um conjunto de configurações especifica onde publicar seus eventos e quais eventos publicar. Em seguida, cada vez que você envia um e-mail, você fornece o nome do conjunto de configurações e uma ou mais tags de mensagem, na forma de pares de nome/valor, para classificar o e-mail. Por exemplo, se você anuncia livros, poderia dar um nome a uma tag de mensagem genre e atribuir o valor sci-fi ou western ao enviar um e-mail para a campanha associada.

Dependendo da interface de envio de e-mail que você usa, será possível fornecer a etiqueta de mensagem como um parâmetro para o campo EmailTags da operação de API SendEmail ou adicionar a etiqueta de mensagem às X-SES-MESSAGE-TAGS de cabeçalho de e-mail específico do SES. Para obter mais informações sobre os conjuntos de configurações, consulte Uso de conjuntos de configurações no Amazon SES.

Além das etiquetas de mensagem que você especificar, o SES também adicionará etiquetas automáticas para as mensagens enviadas. Você não precisa realizar nenhuma etapa adicional para usar tags automáticas.

A tabela a seguir lista as etiquetas automáticas aplicadas automaticamente às mensagens enviadas pelo SES.

Feedback refinado para campanhas de e-mail

A etiqueta ses:feedback-id-<a or b> é uma etiqueta de mensagem opcional que você pode considerar uma etiqueta híbrida ou semiautomática. Embora seja semelhante às etiquetas automáticas discutidas na seção anterior, a diferença é que você precisa adicioná-la manualmente e usar a tecla de prefixo ses:. Você pode usar até duas dessas etiquetas definidas como ses:feedback-id-a e ses:feedback-id-b.

Quando você especifica essas etiquetas, o SES as anexa automaticamente ao cabeçalho Feedback-ID padrão que é usado para fornecer estatísticas de entrega, como taxas de reclamações e spam, como parte de um ciclo de feedback (FBL). Consulte Encaminhamentos de feedback. O cabeçalho Feedback-ID é composto pelo identificador SESInternalID, usado pelo SES para coletar informações de reclamações, e pela etiqueta estática AmazonSES, que identifica o SES como a plataforma de envio. Por exemplo:

FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))

Essas etiquetas de identificação de feedback opcionais são oferecidas como uma forma de gerar feedback refinado, por exemplo, para mensagens enviadas como parte de uma campanha de e-mail. Você pode usar ses:feedback-id-<a or b> especificando-a como uma etiqueta de mensagem no campo EmailTags da solicitação de operação SendEmail, conforme mostrado no exemplo a seguir:

{
  "FromEmailAddress": "noreply@example.com",
  "Destination": {
    "ToAddresses": [
      "customer@example.net"
    ]
  },
  "Content": {
    "Simple": {
      "Subject": {
        "Data": "Hello and welcome"
      },
      "Body": {
        "Text": {
          "Data": "Lorem ipsum dolor sit amet."
        },
        "Html": {
          "Data": "Lorem ipsum dolor sit amet."
        }
      }
    }
  },
  "EmailTags": [
    {
      "Name": "ses:feedback-id-a",
      "Value": "new-members-campaign"
    },
    {
      "Name": "ses:feedback-id-b",
      "Value": "football-campaign"
    }
  ],
  "ConfigurationSetName": "football-club"
}

Se estiver enviando em formato bruto, você adicionará ses:feedback-id-<a or b> como uma etiqueta de mensagem às X-SES-MESSAGE-TAGS de cabeçalho específico do SES.

A etiqueta de mensagem ses:feedback-id-<a or b> também pode ser rastreada no Amazon CloudWatch especificando-a como uma fonte de valor do CloudWatch, assim como qualquer outra etiqueta de mensagem. Consulte Adicionar um destino de evento do CloudWatch (sujeito a cobranças adicionais; consulte Preço por métrica para o CloudWatch).

Como usar a publicação de eventos

As seções a seguir contêm as informações necessárias para configurar e usar a publicação de eventos do SES.

Terminologia de publicação de eventos

A lista a seguir define os termos relacionados à publicação de eventos do SES.