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.

Etiquetas automáticas do Amazon SES
Nome da tag automática	Descrição
ses:caller-identity	A identidade do IAM do usuário do Amazon 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 Amazon 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.

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.

• Configurar a publicação de eventos

• Trabalhar com dados de eventos

Terminologia de publicação de eventos

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

Evento de envio de e-mails

Informações associadas ao resultado de um e-mail enviado ao Amazon 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 SendTemplatedEmail ou SendBulkTemplatedEmail)

• 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. (Soft bounces (Devoluções flexíveis) só são incluídas quando o Amazon SES deixa de entregar o e-mail depois de várias tentativas durante um período de tempo.)

• 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 Amazon 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 Amazon SES. Cada destino de evento que você configura pertence a um, e apenas um, conjunto de configurações.

Tag de mensagem

Um par de nome/valor que você usa para classificar um e-mail para a finalidade de publicação de eventos. Alguns exemplos são campanha/livro e campanha/roupas. Quando você envia um e-mail, especifica a etiqueta da mensagem como parâmetro para a chamada de API ou como um cabeçalho de e-mail específico do Amazon 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 de oritem, o endereço IP de saída do chamador, o endereço IP de saída do Amazon SES e a identidade do IAM do autor da chamada.