As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Para permitir que você acompanhe seu envio de e-mail em um nível granular, você pode configurar o Amazon SES para publicar eventos de envio de e-mail para a Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint ou Amazon Simple Notification Service com base nas características que você define.

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, você pode publicar seus dados de envio de e-mail CloudWatch e criar painéis que acompanham o desempenho 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 tags de mensagens

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 usada, você fornece a tag da mensagem como um parâmetro para o EmailTagscampo da operação da SendEmailAPI ou adiciona a tag da mensagem ao cabeçalho de e-mail específico do SES. X-SES-MESSAGE-TAGS Para obter mais informações sobre os conjuntos de configurações, consulte Uso de conjuntos de configurações no Amazon SES.

Além das tags de mensagem que você especificar, o Amazon SES também adiciona 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 tags automáticas aplicadas automaticamente às mensagens enviadas usando o Amazon SES.

Feedback refinado para campanhas de e-mail

A ses:feedback-id-<a or b> tag é uma tag de mensagem opcional que você pode considerar uma tag híbrida ou semiautomática. Embora seja semelhante às tags 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 tags definidas como ses:feedback-id-a ses:feedback-id-b e.

Quando você especifica essas tags, o SES as anexa automaticamente ao Feedback-ID cabeçalho 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 Feedback-ID cabeçalho é composto pelo identificador SESInternalID, usado pelo SES para coletar informações de reclamações, e pela tag estática, AmazonSES, identificando o SES como a plataforma de envio, como:

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, como para mensagens enviadas como parte de uma campanha de e-mail. Você pode usá-la ses:feedback-id-<a or b> especificando-a como uma tag de mensagem no EmailTagscampo da solicitação de SendEmailoperação, 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ê adicionaria ses:feedback-id-<a or b> como uma tag de mensagem ao cabeçalho específico do SES. X-SES-MESSAGE-TAGS

A tag da ses:feedback-id-<a or b> mensagem também pode ser rastreada na Amazon CloudWatch especificando-a como uma fonte de CloudWatch valor, assim como qualquer outra tag de mensagem, consulte Adicionar um destino de evento do CloudWatch (Cobranças adicionais se aplicam, consulte Preço por métrica para 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 Amazon SES.

Terminologia de publicação de eventos

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