Configurar um domínio para lidar com redirecionamentos do link de abertura e clique Especificar seu domínio de redirecionamento personalizado e a política de HTTPS Especificar tipos de eventos de aberturas e cliques

Configurar domínios personalizados para lidar com rastreamento de abertura e clique

Ao usar a publicação de eventos para capturar eventos de abertura e clique, o Amazon SES faz pequenas alterações nos e-mails enviados. Para capturar eventos abertos, o SES adiciona uma imagem GIF transparente, de um pixel por um, em cada e-mail enviado por meio do SES. Isso inclui um nome de arquivo exclusivo para cada e-mail e é hospedado em um servidor operado pelo SES. Quando a imagem é baixada, o SES pode 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

Qualquer espaço reservado de {{ses:openTracker}} que exceda um será removido no envio pelo SES.
Adicione apenas um espaço reservado de {{ses:openTracker}} se você o estiver usando em um modelo de e-mail, pois mais de um vai gerar um código de erro 400 BadRequestException.

Para capturar eventos de clique em link, o SES substitui os links dos seus e-mails por links para um servidor operado pelo SES. Isso imediatamente redireciona o destinatário ao destino pretendido. O tamanho total dos cabeçalhos, incluindo cookies, das solicitações feitas a esse servidor não deve exceder 8.192 bytes, caso contrário, um código de erro 400 BadRequestException será gerado.

Você também tem a opção de usar seus próprios domínios, em vez de domínios de propriedade do SES e operados por ele, para criar uma experiência mais coesa para seus destinatários, o que significa que todos os indicadores do SES são removidos. Você pode configurar vários domínios personalizados para lidar com eventos de rastreamento de abertura e clique. Esses domínios personalizados estão associados a conjuntos de configurações. Quando você envia um e-mail usando um conjunto de configurações, se ele estiver configurado para usar um domínio personalizado, os links de abertura e clique nesse e-mail usarão automaticamente o domínio personalizado especificado no conjunto de configurações.

Esta seção contém procedimentos para configurar um subdomínio em um servidor que você tem para redirecionar automaticamente os usuários aos servidores de rastreamento de aberturas e cliques operados pelo SES. Há três etapas envolvidas na configuração desses domínios. Primeiro, configure o subdomínio em si e defina um conjunto de configurações personalizadas para usar o domínio. Depois, defina seu destino de eventos para publicar eventos de abertura e cliques. Este tópico contém procedimentos para concluir todas as etapas.

No entanto, se você simplesmente quiser habilitar o rastreamento de abertura ou cliques sem configurar um domínio personalizado, poderá prosseguir diretamente para definir destinos de eventos para o conjunto de configurações, o que permite a publicação de eventos acionados com base nos tipos de evento especificados, incluindo eventos de abertura e clique. Um conjunto de configurações pode ter vários destinos de eventos com diversos tipos de eventos definidos. Consulte Criar destinos de eventos do Amazon SES.

Parte 1: Configurar um domínio para lidar com redirecionamentos do link de abertura e clique

Os procedimentos específicos para configurar um domínio de redirecionamento variam de acordo com o seu provedor de hospedagem na web (e sua rede de entrega de conteúdo, se você usar um servidor HTTPS). Os procedimentos nas seções a seguir fornecem orientação geral em vez de etapas específicas.

Opção 1: Configurar um domínio HTTP

Para usar um domínio HTTP para lidar com links de abertura e clique (ao contrário de um domínio HTTPS), o processo para configurar o subdomínio envolve apenas algumas etapas.

nota

Se você configurar um domínio personalizado que usa o protocolo HTTP e enviar um e-mail que contém links que usam o protocolo HTTPS, os clientes verão uma mensagem de aviso quando clicarem nos links no seu e-mail. Se você planeja enviar e-mails que contêm links que usam o protocolo HTTPS, deve usar um domínio HTTPS para lidar com eventos de rastreamento de clique.

Para configurar um subdomínio HTTP para lidar com links de abertura e clique

Crie um subdomínio a ser usado para links de rastreamento de abertura e clique. A SES recomenda que esse subdomínio seja especificamente dedicado ao tratamento desses links e que um subdomínio seja criado para cada e-mail que Região da AWS você envia e deseja rastrear.
Verifique o subdomínio para uso com o SES. Para obter mais informações, consulte Criar uma identidade de domínio.

Adicione um novo registro CNAME às configurações de DNS do seu subdomínio que redireciona as solicitações para o domínio de rastreamento do SES. O endereço para o qual você redireciona deve ser o mesmo Região da AWS do seu subdomínio personalizado.

A tabela a seguir contém uma lista dos domínios de rastreamento para a Regiões da AWS onde o SES está disponível: selecione aquele que está na mesma região do domínio personalizado:

AWS Região	AWS domínio de rastreamento
Leste dos EUA (Ohio)	`r.us-east-2.awstrack.me`
Leste dos EUA (Norte da Virgínia)	`r.us-east-1.awstrack.me`
Oeste dos EUA (Norte da Califórnia)	`r.us-west-1.awstrack.me`
Oeste dos EUA (Oregon)	`r.us-west-2.awstrack.me`
África (Cidade do Cabo)	`r.af-south-1.awstrack.me`
Ásia-Pacífico (Jacarta)	`r.ap-southeast-3.awstrack.me`
Ásia-Pacífico (Mumbai)	`r.ap-south-1.awstrack.me`
Ásia-Pacífico (Osaka)	`r.ap-northeast-3.awstrack.me`
Ásia-Pacífico (Seul)	`r.ap-northeast-2.awstrack.me`
Ásia-Pacífico (Singapura)	`r.ap-southeast-1.awstrack.me`
Ásia-Pacífico (Sydney)	`r.ap-southeast-2.awstrack.me`
Ásia-Pacífico (Jacarta)	r.ap-southeast-3.awstrack.me
Ásia-Pacífico (Jacarta)	r.ap-southeast-3.awstrack.me
Ásia-Pacífico (Tóquio)	`r.ap-northeast-1.awstrack.me`
Canadá (Central)	`r.ca-central-1.awstrack.me`
Europa (Frankfurt)	`r.eu-central-1.awstrack.me`
Europa (Irlanda)	`r.eu-west-1.awstrack.me`
Europa (Londres)	`r.eu-west-2.awstrack.me`
Europa (Milão)	`r.eu-south-1.awstrack.me`
Europa (Estocolmo)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Middle East (Bahrain)	`r.me-south-1.awstrack.me`
South America (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (Oeste dos EUA)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (Leste dos EUA)	`r.us-gov-east-1.awstrack.me`

nota

Dependendo do seu provedor de hospedagem na web, pode levar vários minutos para que as alterações feitas no registro DNS do subdomínio surtam efeito. O seu provedor de hospedagem na web ou organização de TI podem fornecer informações adicionais sobre esses atrasos.

Opção 2: Configurar um domínio HTTPS

Você só pode usar um domínio HTTPS para rastrear aberturas e cliques em links. Para configurar um domínio HTTPS para rastrear aberturas e cliques em links, é necessário executar algumas etapas adicionais, além das necessárias para configurar um domínio HTTP.

Para configurar um subdomínio HTTPS para lidar com links de abertura e clique

Crie um subdomínio a ser usado para links de rastreamento de abertura e clique. A SES recomenda que esse subdomínio seja especificamente dedicado ao tratamento desses links e que um subdomínio seja criado para cada e-mail que Região da AWS você envia e deseja rastrear.
Verifique o subdomínio para uso com o SES. Para obter mais informações, consulte Criar uma identidade de domínio.
Crie uma nova conta com uma rede de distribuição de conteúdo (CDN), como a Amazon CloudFront, consulte Comece com uma CloudFront distribuição básica.

Configure o CDN com a origem que é o domínio de rastreamento do SES, como r.us-east-1.awstrack.me. A CDN deve apontar para o domínio de AWS rastreamento que está na mesma região do seu domínio personalizado. A CDN deve passar o cabeçalho de Host fornecido pelo solicitante para a origem. Para obter mais informações, consulte este artigo re:Post da AWS.

A tabela a seguir contém uma lista dos domínios de rastreamento para a Regiões da AWS onde o SES está disponível: selecione aquele que está na mesma região do domínio personalizado:

AWS Região	AWS domínio de rastreamento
Leste dos EUA (Ohio)	`r.us-east-2.awstrack.me`
Leste dos EUA (Norte da Virgínia)	`r.us-east-1.awstrack.me`
Oeste dos EUA (Norte da Califórnia)	`r.us-west-1.awstrack.me`
Oeste dos EUA (Oregon)	`r.us-west-2.awstrack.me`
África (Cidade do Cabo)	`r.af-south-1.awstrack.me`
Ásia-Pacífico (Jacarta)	`r.ap-southeast-3.awstrack.me`
Ásia-Pacífico (Mumbai)	`r.ap-south-1.awstrack.me`
Ásia-Pacífico (Osaka)	`r.ap-northeast-3.awstrack.me`
Ásia-Pacífico (Seul)	`r.ap-northeast-2.awstrack.me`
Ásia-Pacífico (Singapura)	`r.ap-southeast-1.awstrack.me`
Ásia-Pacífico (Sydney)	`r.ap-southeast-2.awstrack.me`
Ásia-Pacífico (Tóquio)	`r.ap-northeast-1.awstrack.me`
Canadá (Central)	`r.ca-central-1.awstrack.me`
Europa (Frankfurt)	`r.eu-central-1.awstrack.me`
Europa (Irlanda)	`r.eu-west-1.awstrack.me`
Europa (Londres)	`r.eu-west-2.awstrack.me`
Europa (Milão)	`r.eu-south-1.awstrack.me`
Europa (Estocolmo)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Middle East (Bahrain)	`r.me-south-1.awstrack.me`
South America (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (Oeste dos EUA)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (Leste dos EUA)	`r.us-gov-east-1.awstrack.me`

Se você usa o Route 53 para gerenciar a configuração de DNS para seu domínio e CloudFront como sua CDN, crie um registro de alias no Route 53 que se refira à sua CloudFront distribuição (como d111111abcdef8.cloudfront.net). Para obter informações, consulte Criação de um registro usando o console do Amazon Route 53 no Guia do desenvolvedor do Amazon Route 53.

Caso contrário, na configuração do DNS do subdomínio, adicione um registro CNAME que faça referência ao endereço de sua CDN.
Adquira um certificado SSL de uma autoridade de certificação confiável. O certificado deve cobrir o subdomínio que você criou na etapa 1, bem como o CDN configurado nas etapas 3 a 5. Faça upload do certificado para a CDN.
Você pode usar o comando curl a seguir para validar se seu domínio personalizado recém-criado está usando a região e o protocolo HTTPS corretos. No exemplo a seguir, tudo é literal, exceto o nome do seu domínio:
```
curl --head https://custom.domain.com/favicon.ico
```
Uma resposta é retornada como no exemplo a seguir:
```
(python-sdk-test) jdoe@12a34567b89c BaconRedirectService % curl --head https://custom.domain.com/favicon.ico
HTTPS/1.1 200 OK
x-amz-ses-region: us-east-1
x-amz-ses-request-protocol: https
Content-Type: image/x-icon
Transfer-Encoding: chunked
Date: Fri, 30 Aug 2024 13:50:14 GMT
```
Essa resposta contém as seguintes propriedades:
- O valor do cabeçalho de x-amz-ses-region é a região do SES que recebeu a solicitação.
- O valor do cabeçalho de x-amz-ses-request-protocol é o protocolo usado para a solicitação entre a CDN e o SES no cabeçalho.
Se sua configuração estiver correta, a região deverá refletir a região em que seu domínio foi criado e o protocolo deverá ser HTTPS.

Parte 2: especificar seu domínio de redirecionamento personalizado e a política de HTTPS por meio de um conjunto de configurações

Depois de configurar seu domínio para lidar com redirecionamentos de rastreamento de aberturas e cliques, é necessário especificar seu domínio personalizado e a política de HTTPS em um conjunto de configurações.

Ao enviar um e-mail usando um conjunto de configurações, se esse conjunto de configurações estiver configurado para usar um domínio de redirecionamento personalizado, os links de abertura e clique nesse e-mail usarão automaticamente o domínio personalizado e as opções de política de HTTPS especificadas no conjunto de configurações.

Você pode realizar esta etapa usando o console do SES ou a operação da API CreateConfigurationSet v2.

Para especificar um domínio de redirecionamento personalizado e uma política de HTTPS usando o console

Ao criar ou editar um conjunto de configurações, use as Opções de rastreamento na Etapa 4 de Criar um conjunto de configurações para especificar seu domínio de redirecionamento personalizado e as opções de política de HTTPS.

Para especificar um domínio de redirecionamento personalizado e uma política HTTPS usando o AWS CLI

Você pode usar a operação CreateConfigurationSet na API v2 do SES e usar a propriedade TrackingOptions para especificar seu domínio de redirecionamento personalizado e a política de HTTPS. Você pode chamar essa operação a partir do AWS CLI , conforme mostrado no exemplo a seguir.

Crie o conjunto de configurações no Região da AWS local para onde você deseja enviar e rastrear e-mails:
```
aws sesv2 create-configuration-set --cli-input-json file://create.json
```
Neste exemplo, o arquivo de entrada está usando parâmetros da propriedade TrackingOptions: CustomRedirectDomain especifica o domínio personalizado a ser usado para rastrear links abertos e clicados e HttpsPolicy especifica uma opção de política de HTTPS:
```
{
    "ConfigurationSetName": "my-config-set",
    "TrackingOptions": {
        "CustomRedirectDomain": "marketing.example.com",
        "HttpsPolicy": "REQUIRE"
    },
    "SendingOptions": {
        "SendingEnabled": true
    }
}
```
Para o parâmetro HttpsPolicy, os valores a seguir podem ser especificados para definir o protocolo dos links de rastreamento de aberturas e cliques do seu domínio de redirecionamento personalizado:
- OPTIONAL: (comportamento padrão) os links de rastreamento de aberturas serão agrupados usando HTTP. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.
- REQUIRE: os links de rastreamento de aberturas e cliques serão agrupados usando HTTPS.
- REQUIRE_OPEN_ONLY: os links de rastreamento de aberturas serão agrupados usando HTTPS. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.

Parte 3: especificar tipos de eventos de aberturas e cliques por meio de um conjunto de configurações

Depois de especificar seu domínio personalizado e a política de HTTPS no conjunto de configurações na etapa anterior, é necessário especificar os tipos de eventos de aberturas e/ou cliques a serem rastreados em um destino de evento por meio de um conjunto de configurações.

Você pode realizar esta etapa usando o console do SES ou a operação da API CreateConfigurationSetEventDestination v2.

Para selecionar tipos de eventos de aberturas e/ou cliques usando o console

Ao criar ou modificar um destino de evento, use Rastreamento de aberturas e cliques na Etapa 6 de Criação de um destino de eventos para especificar os tipos de eventos.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Atribuir grupos de IP

Especificar conjuntos de configurações no e-mail