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
<a name="monitor-using-event-publishing"></a>

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, 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 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
<a name="event-publishing-how-works"></a>

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, toda 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 name/value pares, para categorizar 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 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) da operação de API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) ou adicionar a etiqueta de mensagem às [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) 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](using-configuration-sets.md).

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.


**Etiquetas automáticas do SES**  

| Nome da tag automática | Description | 
| --- | --- | 
| ses:caller-identity | A identidade do IAM do usuário do SES que enviou o e-mail. | 
| ses:configuration-set | O nome do conjunto de configurações associado ao e-mail. | 
| ses:from-domain | O domínio do endereço "From". | 
| ses:outgoing-ip | O endereço IP que o SES usou para enviar o e-mail. | 
| ses:source-ip | O endereço IP que o chamador usou para enviar o e-mail. | 
| ses:source-tls-version | A versão do protocolo TLS que o agente de chamada usou para enviar o e-mail. | 
| ses:outgoing-tls-version | A versão do protocolo TLS que o SES usou para enviar o e-mail. | 

## Feedback refinado para campanhas de e-mail
<a name="event-publishing-fine-grained-feedback"></a>

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](faqs-enforcement.md#cm-feedback-loop). O `Feedback-ID` cabeçalho é composto pelo identificador, *SESInternalID*, usado pelo SES para coletar informações de reclamação, e a 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, 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 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) da solicitação de operação [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html), 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`](event-publishing-send-email.md#event-publishing-using-ses-headers) de cabeçalho específico do SES.

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 [Adicionando um destino de CloudWatch evento](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add) *(Cobranças adicionais se aplicam, consulte [Preço por métrica para CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)*.)

## Como usar a publicação de eventos
<a name="event-publishing-how-to-use"></a>

As seções a seguir contêm as informações necessárias para configurar e usar a publicação de eventos do SES.
+ [Configurar a publicação de eventos](monitor-sending-using-event-publishing-setup.md)
+ [Trabalhar com dados de eventos](working-with-event-data.md)

## Terminologia de publicação de eventos
<a name="event-publishing-terminology"></a>

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

**Evento de envio de e-mails**  
Informações associadas ao resultado de um e-mail que você envia ao SES. Os eventos de envio incluem o seguinte:  
+ **Send** (Envio): a solicitação de envio foi bem-sucedida e o Amazon SES tentará entregar a mensagem ao servidor de e-mail do destinatário. (Se a supressão global ou no nível da conta estiver sendo usada, o SES ainda contará como um envio, mas a entrega está suprimida.)
+ **RenderingFailure**— O e-mail não foi enviado devido a um problema de renderização do modelo. Esse tipo de evento pode ocorrer quando estão faltando dados no modelo ou quando há uma incompatibilidade entre os parâmetros e os dados do modelo. (Esse tipo de evento só ocorre quando você envia e-mails usando as operações de API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html))
+ **Reject (Rejeição)**: o Amazon SES aceitou o e-mail, mas determinou que ele continha um vírus e não tentou entregá-lo ao servidor de e-mail do destinatário.
+ **Delivery** (Entrega): o Amazon SES entregou com êxito o e-mail ao servidor de e-mail do destinatário.
+ **Devolução**: uma *devolução definitiva* em que o servidor de e-mail do destinatário rejeitou permanentemente o e-mail. (Os *soft bounces* só são incluídos quando o SES não está mais tentando entregar o e-mail novamente. Geralmente, esses soft bounces indicam uma falha na entrega, embora em alguns casos um soft bounce possa ser devolvido mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso geralmente ocorre quando o destinatário envia uma resposta out-of-office automática. Saiba mais sobre soft bounces neste artigo do [AWS re:POST](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint** (Reclamação): o e-mail foi entregue com sucesso ao servidor de e-mail do destinatário, mas o destinatário marcou-o como spam.
+ **DeliveryDelay**— O e-mail não pôde ser entregue ao servidor de e-mail do destinatário porque ocorreu um problema temporário. Atrasos de entrega podem ocorrer, por exemplo, quando a caixa de entrada do destinatário está cheia ou quando o servidor de recebimento de e-mail enfrenta um problema transitório.
+ **Subscription** (Assinatura): o e-mail foi entregue com êxito, mas o destinatário atualizou as preferências de assinatura clicando em `List-Unsubscribe` no cabeçalho do e-mail ou no link `Unsubscribe` no rodapé.
+ **Open** (Abertura): o destinatário recebeu a mensagem e a abriu em seu cliente de e-mail.
+ **Click** (Clique): o destinatário clicou em um ou mais links no e-mail.

**Conjunto de configurações**  
Um conjunto de regras que define o destino no qual o SES publica eventos de envio de e-mail e os tipos de eventos de envio de e-mail que você deseja publicar. Quando você envia um e-mail que deseja usar com a publicação do evento, precisa especificar o conjunto de configurações a ser associado ao e-mail.

**Destino do evento**  
Um AWS serviço para o qual você publica eventos de envio de e-mails do SES. Cada destino de evento que você configura pertence a um, e apenas um, conjunto de configurações.

**Tag de mensagem**  
Um name/value par que você usa para categorizar um e-mail para fins de publicação de eventos. Alguns exemplos são *campanha/livro* e *campanha/roupas*. Quando você envia um e-mail, especifica a etiqueta de mensagem como um parâmetro para a chamada de API ou como um cabeçalho de e-mail específico do SES.

**Tag automática**  
Tags de mensagens que são incluídas automaticamente nos relatórios de publicação de eventos. Há uma etiqueta automática para o nome do conjunto de configurações, o domínio do endereço do remetente, o endereço IP de saída do autor da chamada, o endereço IP de saída do SES e a identidade do IAM do autor da chamada.