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á.
# Métricas de envio de e-mail do Amazon SES FAQs
O Amazon SES coleta várias métricas sobre os e-mails que você envia. Essas métricas permitem que você analise a eficácia de seu programa de e-mail e monitore estatísticas importantes, como taxas de devolução e reclamação.
**Topics**
+ [Perguntas gerais](#faqs-metrics-general)
+ [Rastreamento de abertura](#faqs-metrics-opens)
+ [Rastreamento de cliques](#faqs-metrics-clicks)
**nota**
O rastreamento de eventos depende do provedor de serviços de e-mail (ESP) do destinatário e de como eles definiram suas configurações de privacidade, que estão além do controle do Amazon SES. A contagem de eventos de rastreamento pode ser distorcida (retornando contagens imprecisas) em condições como:
O destinatário do e-mail está usando um provedor de serviços de e-mail (ESP) que protege sua privacidade.
O destinatário do e-mail explicitamente não dá permissão ESP para compartilhar seus dados.
O ESP do destinatário do e-mail armazena em cache imagens ou links; o SES só pode contar a abertura inicial, mas não poderá contar aberturas subsequentes.
## Perguntas gerais
### P1. Após um e-mail ser entregue, por quanto tempo o Amazon SES continua a coletar métricas de aberturas e cliques?
O Amazon SES coleta métricas de aberturas e cliques por 60 dias após cada e-mail ser enviado.
### P2. Se um usuário abrir um e-mail várias vezes ou clicar em um link de e-mail várias vezes, cada um desses eventos será rastreado separadamente?
Se um destinatário abrir um e-mail várias vezes, o Amazon SES contará cada abertura como um evento de abertura único. Da mesma forma, se um destinatário clicar no mesmo link várias vezes, o Amazon SES conta cada clique como um evento de clique único. No entanto, essas contagens podem ser distorcidas pelos cenários descritos acima na caixa de notas.
### P3. As métricas de abertura e clique são somadas ou podem ser medidas até o nível do destinatário?
As aberturas e os cliques são rastreados até o nível do destinatário. Com o rastreamento de aberturas e cliques, você pode determinar quais destinatários abriram um e-mail ou clicaram em um link de um e-mail.
### P4. Posso recuperar métricas de aberturas e cliques usando a API do Amazon SES?
A API do Amazon SES não fornece um método para recuperação de métricas de abertura e clique. No entanto, você pode recuperar métricas de abertura e clique para o Amazon SES usando a CloudWatch API. Por exemplo, você pode usar o AWS CLI para recuperar métricas de cliques usando a CloudWatch API emitindo o seguinte comando:
```
1. aws cloudwatch get-metric-statistics --namespace AWS/SES --metric-name Click \
2. --statistics Sum --period 86400 --start-time 2017-01-01T00:00:00Z \
3. --end-time 2017-12-31T23:59:59Z
```
O comando exibido acima recupera o número total de eventos de clique para cada dia em 2017. Para recuperar métricas de abertura, altere o valor do parâmetro `metric-name` para `Open`. Você também pode modificar os parâmetros `start-time` e `end-time` para alterar o período de análise, ou o parâmetro `period` para uma análise mais refinada.
## Rastreamento de abertura
### P1. Como funciona o rastreamento de abertura?
Uma imagem GIF transparente, de um pixel por um, é inserida em cada e-mail enviado por meio do Amazon SES e inclui uma referência exclusiva para esse arquivo de imagem. Quando a imagem é baixada, o SES consegue dizer exatamente qual mensagem foi aberta e por quem.
Por padrão, esse pixel é inserido na parte inferior do e-mail; no entanto, algumas aplicações de provedores de e-mail truncam a visualização de um e-mail quando ele excede determinado tamanho e podem fornecer um link para a exibição do restante da mensagem. Nesse cenário, a imagem de rastreamento de pixels do SES não será carregada e descartará as taxas de abertura que você está tentando rastrear. Para contornar isso, você pode, opcionalmente, colocar o pixel no início do e-mail, ou em qualquer outro lugar, inserindo o espaço reservado `{{ses:openTracker}}` no corpo do e-mail. Depois que o SES receber a mensagem com o espaço reservado, ele será substituído pela imagem de pixel de rastreamento aberta.
**Importante**
Basta adicionar um espaço reservado `{{ses:openTracker}}`, pois mais de um vai gerar um código de erro `400 BadRequestException`.
A adição desse pixel de rastreamento não altera a aparência do seu e-mail.
### P2. O rastreamento de abertura é habilitado por padrão?
O rastreamento de abertura está disponível a todos os usuários do Amazon SES por padrão. Para usar o rastreamento de abertura, você deve fazer o seguinte:
1. Criar um conjunto de configurações.
1. No conjunto de configurações, crie um destino de evento.
1. Configure o destino do evento para publicar notificações de evento de abertura em um destino.
1. Em todos os e-mails dos quais você deseja rastrear a abertura, especifique o conjunto de configurações criado na etapa 1.
Para obter detalhes sobre como habilitar o rastreamento aberto por meio do destino de eventos de um conjunto de configurações, consulte [Criar destinos de eventos do Amazon SES](event-destinations-manage.md). Você pode usar o espaço reservado em pixels no [e-mail SMTP](send-email-smtp.md) de algumas maneiras, como um e-mail [formatado, bruto e modelado](send-email-api.md).
Saiba mais sobre como [Monitorar o envio de e-mails usando a publicação de eventos](monitor-using-event-publishing.md).
### P3. Posso omitir o pixel de rastreamento de abertura de alguns e-mails?
Há duas maneiras de omitir o pixel de rastreamento de abertura do seu e-mails. O primeiro método é enviar o e-mail sem especificar um conjunto de configurações. Como alternativa, você pode especificar um conjunto de configurações que não está configurado para publicar dados sobre eventos de abertura.
### P4. Vocês rastreiam as aberturas de e-mails em texto simples?
O rastreamento de abertura só funciona com e-mails HTML. Como o rastreamento de abertura depende da inclusão de uma imagem, não é possível coletar métricas de abertura para usuários que abrem e-mails usando um cliente de e-mail somente em texto (não HTML).
## Rastreamento de cliques
### P1. Como funciona o rastreamento de cliques?
Para rastrear cliques, o Amazon SES modifica cada link no corpo do e-mail. Quando os destinatários clicarem em um link, eles são enviados a um servidor do Amazon SES e imediatamente encaminhados para o endereço de destino. Assim como ocorre com o rastreamento de abertura, cada link do redirecionamento é exclusivo. Isso permite que o Amazon SES determine qual destinatário clicou no link, quando o fez e o e-mail a partir do qual ele chegou ao link.
**Importante**
Se você enviar uma única mensagem para vários destinatários, cada destinatário salvará o mesmo link de rastreamento de clique. Para monitorar a atividade dos cliques de cada destinatário, envie e-mails para um destinatário por operação de envio.
### P2. Posso desabilitar o rastreamento de cliques?
Você pode desabilitar o rastreamento de cliques para links individuais adicionando um atributo `ses:no-track` às tags de âncora no corpo HTML do seu e-mail. Por exemplo, se você criar um link para a página AWS inicial, um link âncora normal será semelhante ao seguinte:
```
Amazon Web Services
```
Para desabilitar o rastreamento de cliques para esse link, modifique-o para ficar semelhante ao seguinte:
```
Amazon Web Services
```
Como `ses:no-track` não é um atributo HTML padrão, o Amazon SES automaticamente o remove da versão do e-mail que chega nas caixas de entrada dos seus destinatários.
Você também poderá desabilitar o rastreamento de cliques para todas as mensagens que enviar usando um conjunto de configurações específico. Para desabilitar o rastreamento de cliques, modifique o destino de eventos do conjunto de configurações para que ele não capture eventos de clique.
Para obter detalhes sobre como habilitar e desabilitar o rastreamento de cliques por meio do destino de eventos de um conjunto de configurações, consulte [Criar destinos de eventos do Amazon SES](event-destinations-manage.md).
Saiba mais sobre como [Monitorar o envio de e-mails usando a publicação de eventos](monitor-using-event-publishing.md).
### P3. Quantos links podem ser rastreados em cada e-mail?
O sistema de rastreamento de cliques pode rastrear um máximo de 250 links.
### P4. As métricas de cliques são coletadas para links em e-mails com texto sem formatação?
Só é possível rastrear cliques em e-mails HTML.
### P5. Posso usar tags em links com identificadores exclusivos?
Você pode adicionar um número ilimitado de tags, como pares de chave-valor, a links no seu e-mail usando o atributo `ses:tags`. Quando você usar esse atributo, especifique as chaves e os valores usando o mesmo formato que usaria para passar propriedades CSS em linha: digite a chave seguida por dois pontos (:) e seguida pelo valor. Se você precisar passar vários pares de chave-valor, separe cada um deles com ponto-e-vírgula (;).
Por exemplo, vamos supor que você deseje adicionar as tags `product:book, genre:fiction, subgenre:scifi, type:newrelease` a um link. O link resultante se parecerá com o seguinte:
```
New Releases in Science Fiction
```
Essas tags são passadas para seu destino de publicação de eventos, para que você possa executar análises adicionais nos links específicos que seus usuários clicaram.
**nota**
Tags de link podem incluir números de 0-9, as letras A-Z (letras maiúsculas e minúsculas), hífens (-) e sublinhados (\$1).
### P6. Os links rastreados usam o protocolo HTTP ou HTTPS?
Os links de rastreamento usam o mesmo protocolo que os links originais no seu e-mail.
Por exemplo, se seu e-mail incluir um link para `https://www.amazon.com`, o link será substituído por um link de rastreamento que usa o protocolo HTTPS. Se seu e-mail incluir um link para `http://www.example.com`, o link será substituído por um link de rastreamento que usa HTTP. Se seu e-mail incluir os dois links mencionados anteriormente, o link HTTPS será substituído por um link de rastreamento que usa o protocolo HTTPS, e o link HTTP é substituído por um link de rastreamento que usa o protocolo HTTP.
### P7. Um link no meu e-mail não está sendo acompanhado. Por que não?
O Amazon SES espera que os links em seus e-mails estejam devidamente codificados. URLs Especificamente, seus links devem estar URLs em conformidade com a [RFC 3986](https://tools.ietf.org/html/rfc3986). Se um link em um e-mail não estiver codificado corretamente, os destinatários ainda vêm o link no e-mail, mas o Amazon SES não acompanha os eventos de clique desse link.
Problemas relacionados à codificação imprópria geralmente ocorrem quando contêm cadeias de URLs caracteres de consulta. *Por exemplo, se o URL de um link em seu e-mail contiver um caractere de espaço não codificado na string de consulta (como o espaço entre "" e John "Doe" no exemplo a seguir: http://www.example. com/path/to/page? name=John Doe), o* Amazon SES não rastreará esse link. *No entanto, se o URL usar um caractere de espaço codificado em vez disso (como “%20" no exemplo a seguir: http://www.example. com/path/to/page? name=john%20doe*), o Amazon SES o rastreia conforme o esperado.