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á.

Monitore o envio de e-mails usando a publicação de SES eventos da Amazon

Para permitir que você acompanhe seu envio de e-mail em um nível granular, você pode configurar SES a Amazon para publicar eventos de envio de e-mail para a Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service ou EventBridge Amazon 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 SNS a Amazon 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 SendEmailAPIoperação ou adiciona a tag da mensagem ao cabeçalho SES X-SES-MESSAGE-TAGSespecífico do e-mail. Para obter mais informações sobre os conjuntos de configurações, consulte Usando conjuntos de configurações na Amazon SES.

Além das tags de mensagem que você especifica, SES também adiciona tags automáticas às mensagens enviadas. Você não precisa realizar nenhuma etapa adicional para usar tags automáticas.

A tabela a seguir lista as tags automáticas que são aplicadas automaticamente às mensagens que você envia usandoSES.

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, as anexa SES automaticamente ao Feedback-ID cabeçalho padrão que é usado para fornecer estatísticas de entrega, como taxas de reclamação e spam, como parte de um ciclo de feedback (FBL), consulteEncaminhamentos de feedback. O Feedback-ID cabeçalho é composto pelo identificador SESInternalID, usado por SES para coletar informações de reclamação, e pela tag estática, Amazon SES, identificada 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 SES X-SES-MESSAGE-TAGSespecífico.

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 SES eventos.

Terminologia de publicação de eventos

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