Configurazione di un dominio per gestire i reindirizzamenti ai collegamenti di apertura e clic Specificazione del dominio di reindirizzamento personalizzato e della politica HTTPS Specificazione dei tipi di eventi di apertura e di clic

Configurazione di domini personalizzati per gestire il monitoraggio di aperture e clic

Quando utilizzi la pubblicazione di eventi per acquisire eventi di apertura e clic, Amazon SES apporta modifiche secondarie alle e-mail inviate. Per catturare eventi aperti, SES aggiunge un'immagine GIF trasparente da 1 pixel per 1 pixel in ogni e-mail inviata tramite SES che include un nome di file univoco per ogni e-mail ed è ospitata su un server gestito da SES; quando l'immagine viene scaricata, SES può indicare esattamente quale messaggio è stato aperto e da chi.

Di default, questo pixel viene inserito nella parte inferiore dell'e-mail; tuttavia, alcune applicazioni dei provider di posta elettronica troncano l'anteprima di un'e-mail quando supera una certa dimensione e potrebbero fornire un collegamento per visualizzare il resto del messaggio. In questo scenario, l'immagine di tracciamento dei pixel SES non viene caricata ed eliminerà le percentuali di aperture che stai cercando di tracciare. Per aggirare questo problema, puoi opzionalmente posizionare il pixel all'inizio dell'e-mail o in qualsiasi altro luogo inserendo il segnaposto {{ses:openTracker}} nel corpo dell'e-mail. Una volta che SES riceve il messaggio con il segnaposto, verrà sostituito con l'immagine pixel di tracciamento aperta.

Importante

Qualsiasi {{ses:openTracker}} segnaposto superiore a uno verrà rimosso al momento dell'invio da parte di SES.
Aggiungi un solo {{ses:openTracker}} segnaposto se lo utilizzi in un modello di email, poiché più di uno genereranno la restituzione di un codice di 400 BadRequestException errore.

Per registrare gli eventi relativi ai clic sui link, SES sostituisce i link contenuti nelle e-mail con collegamenti a un server gestito da SES. Questo reindirizza immediatamente il destinatario alla destinazione prevista. La dimensione totale delle intestazioni, compresi i cookie, delle richieste fatte a questo server non deve superare gli 8192 byte, altrimenti viene restituito un codice di 400 BadRequestException errore.

Hai anche la possibilità di utilizzare i tuoi domini, anziché i domini di proprietà e gestiti da SES, per creare un'esperienza più coerente per i tuoi destinatari, il che significa che tutti gli indicatori SES vengono rimossi. Puoi configurare più domini personalizzati per gestire eventi di traccia di aperture e clic. Tali domini personalizzati sono associati ai set di configurazione. Quando invii un'e-mail tramite un set di configurazione, se quest'ultimo è configurato per l'utilizzo di un dominio personalizzato, i collegamenti di apertura e clic di quell'e-mail utilizzeranno automaticamente il dominio personalizzato specificato nel set di configurazione.

Questa sezione contiene le procedure per configurare un sottodominio su un server di tua proprietà per reindirizzare automaticamente gli utenti ai server di tracciamento delle aperture e dei clic gestiti da SES. La configurazione di questi domini comprende tre fasi. In primo luogo, puoi configurare il sottodominio stesso, in seguito puoi impostare un set di configurazione per utilizzare il dominio personalizzato e poi impostare la destinazione dell'evento per pubblicare eventi aperti e di clic. Questo argomento contiene le procedure per completare entrambe le fasi.

Tuttavia, se si desidera semplicemente abilitare il tracciamento aperto o clic senza impostare un dominio personalizzato, è possibile procedere direttamente alla definizione delle destinazioni degli eventi per il set di configurazione che consente la pubblicazione di eventi attivata sui tipi di eventi specificati, inclusi gli eventi aperti e clic. Un set di configurazione può avere più destinazioni di eventi con più tipi di eventi definiti. Per informazioni, consulta Creazione delle destinazioni degli eventi Amazon SES.

Fase 1: configurazione di un dominio per gestire i reindirizzamenti ai collegamenti di tracciamento di apertura e clic

Le procedure specifiche di configurazione di un dominio di reindirizzamento variano a seconda del provider di hosting Web (e della rete per la distribuzione di contenuti, se utilizzi un server HTTPS). Le procedure descritte nelle sezioni seguenti rappresentano indicazioni generali, piuttosto che fasi specifiche.

Opzione 1: configurazione di un dominio HTTP

Se intendi utilizzare un dominio HTTP per gestire i collegamenti di apertura e clic (anziché un dominio HTTPS), il processo di configurazione del sottodominio richiede solo pochi passaggi.

Nota

Se configuri un dominio personalizzato che utilizza il protocollo HTTP e invii un'e-mail contenente collegamenti che utilizzano il protocollo HTTPS, i tuoi clienti potrebbero visualizzare un messaggio di avviso quando fanno clic sul collegamento contenuto nell'e-mail. Se intendi inviare e-mail contenenti collegamenti che utilizzano il protocollo HTTPS, è consigliabile utilizzare un dominio HTTPS per gestire gli eventi di tracciamento di clic.

Configurazione di un sottodominio HTTP per gestire i collegamenti di apertura e clic

Crea un sottodominio da utilizzare per i collegamenti di traccia di apertura e clic. SES consiglia che questo sottodominio sia specificamente dedicato alla gestione di questi collegamenti e che venga creato un sottodominio per ogni Regione AWS e-mail inviata e che desideri monitorare.
Verifica che il sottodominio sia utilizzabile con SES. Per ulteriori informazioni, consulta Creazione di un'identità dominio.

Aggiungi un nuovo record CNAME alle impostazioni DNS del sottodominio che reindirizza le richieste al dominio di tracciamento SES. L'indirizzo a cui effettui il reindirizzamento deve essere lo stesso del sottodominio personalizzato. Regione AWS

La tabella seguente contiene un elenco di domini di tracciamento per i paesi Regioni AWS in cui è disponibile SES: seleziona quello che si trova nella stessa regione del dominio personalizzato:

AWS Regione	AWS dominio di tracciamento
Stati Uniti orientali (Ohio)	`r.us-east-2.awstrack.me`
Stati Uniti orientali (Virginia settentrionale)	`r.us-east-1.awstrack.me`
Stati Uniti occidentali (California settentrionale)	`r.us-west-1.awstrack.me`
Stati Uniti occidentali (Oregon)	`r.us-west-2.awstrack.me`
Africa (Città del Capo)	`r.af-south-1.awstrack.me`
Asia Pacifico (Giacarta)	`r.ap-southeast-3.awstrack.me`
Asia Pacifico (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pacific (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seul)	`r.ap-northeast-2.awstrack.me`
Asia Pacifico (Singapore)	`r.ap-southeast-1.awstrack.me`
Asia Pacifico (Sydney)	`r.ap-southeast-2.awstrack.me`
Asia Pacifico (Giacarta)	r.ap-southeast-3.awstrack.me
Asia Pacifico (Giacarta)	r.ap-southeast-3.awstrack.me
Asia Pacifico (Tokyo)	`r.ap-northeast-1.awstrack.me`
Canada (Centrale)	`r.ca-central-1.awstrack.me`
Europa (Francoforte)	`r.eu-central-1.awstrack.me`
Europa (Irlanda)	`r.eu-west-1.awstrack.me`
Europa (Londra)	`r.eu-west-2.awstrack.me`
Europa (Milano)	`r.eu-south-1.awstrack.me`
Europa (Stoccolma)	`r.eu-north-1.awstrack.me`
Israele (Tel Aviv)	`r.il-central-1.awstrack.me`
Medio Oriente (Bahrein)	`r.me-south-1.awstrack.me`
Sud America (San Paolo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (Stati Uniti occidentali)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (Stati Uniti orientali)	`r.us-gov-east-1.awstrack.me`

Nota

A seconda del provider di hosting Web, potrebbero essere necessari alcuni minuti perché le modifiche apportate al record DNS del sottodominio siano effettive. Il tuo provider di hosting Web o l'organizzazione IT può fornire ulteriori informazioni relative a questi ritardi.

Opzione 2: configurazione di un dominio HTTPS

Puoi anche utilizzare un dominio HTTPS per tracciare le aperture e i clic sui link. Per configurare un dominio HTTPS per il monitoraggio delle aperture e dei clic sui link, è necessario eseguire alcuni passaggi aggiuntivi, oltre a quelli necessari per la configurazione di un dominio HTTP.

Configurazione di un sottodominio HTTPS per gestire i collegamenti di apertura e clic

Crea un sottodominio da utilizzare per i collegamenti di traccia di apertura e clic. SES consiglia che questo sottodominio sia specificamente dedicato alla gestione di questi link e che venga creato un sottodominio per ogni Regione AWS e-mail inviata e che si desidera monitorare.
Verifica che il sottodominio sia utilizzabile con SES. Per ulteriori informazioni, consulta Creazione di un'identità dominio.
Crea un nuovo account con un Content Delivery Network (CDN), come Amazon CloudFront, vedi Introduzione a una CloudFront distribuzione di base.

Configura il CDN sull'origine che è il dominio di tracciamento SES, ad esempio r.us-east-1.awstrack.me. Il CDN deve puntare al dominio di AWS tracciamento che si trova nella stessa regione del dominio personalizzato. Il CDN deve passare l'Hostintestazione fornita dal richiedente all'origine, consulta questo articolo di AWS re:POST per maggiori informazioni.

La tabella seguente contiene un elenco di domini di tracciamento per i paesi Regioni AWS in cui è disponibile SES: seleziona quello che si trova nella stessa regione del dominio personalizzato:

AWS Regione	AWS dominio di tracciamento
Stati Uniti orientali (Ohio)	`r.us-east-2.awstrack.me`
Stati Uniti orientali (Virginia settentrionale)	`r.us-east-1.awstrack.me`
Stati Uniti occidentali (California settentrionale)	`r.us-west-1.awstrack.me`
Stati Uniti occidentali (Oregon)	`r.us-west-2.awstrack.me`
Africa (Città del Capo)	`r.af-south-1.awstrack.me`
Asia Pacifico (Giacarta)	`r.ap-southeast-3.awstrack.me`
Asia Pacifico (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pacific (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seul)	`r.ap-northeast-2.awstrack.me`
Asia Pacifico (Singapore)	`r.ap-southeast-1.awstrack.me`
Asia Pacifico (Sydney)	`r.ap-southeast-2.awstrack.me`
Asia Pacifico (Tokyo)	`r.ap-northeast-1.awstrack.me`
Canada (Centrale)	`r.ca-central-1.awstrack.me`
Europa (Francoforte)	`r.eu-central-1.awstrack.me`
Europa (Irlanda)	`r.eu-west-1.awstrack.me`
Europa (Londra)	`r.eu-west-2.awstrack.me`
Europa (Milano)	`r.eu-south-1.awstrack.me`
Europa (Stoccolma)	`r.eu-north-1.awstrack.me`
Israele (Tel Aviv)	`r.il-central-1.awstrack.me`
Medio Oriente (Bahrein)	`r.me-south-1.awstrack.me`
Sud America (San Paolo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (Stati Uniti occidentali)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (Stati Uniti orientali)	`r.us-gov-east-1.awstrack.me`

Se utilizzi Route 53 per gestire la configurazione DNS per il tuo dominio e CloudFront come CDN, crea un record di alias in Route 53 che faccia riferimento alla tua CloudFront distribuzione (ad esempio d111111abcdef8.cloudfront.net). Per maggiori informazioni, consulta Creazione di registro utilizzando la console Amazon Route 53 nella Guida per gli sviluppatori Amazon Route 53.

In caso contrario, nella configurazione DNS per il tuo sottodominio, aggiungi un record CNAME che faccia riferimento all'indirizzo della tua CDN.
Acquisisci un certificato SSL da un'autorità di certificazione attendibile. Il certificato dovrebbe coprire sia il sottodominio creato nella fase 1, sia la CDN è configurata nelle fasi 3-5. Carica il certificato nella CDN.
Puoi usare il seguente comando curl per verificare che il tuo dominio personalizzato appena creato utilizzi la regione e il protocollo HTTPS corretti. Nell'esempio seguente, tutto è letterale tranne il nome del tuo dominio:
```
curl --head https://custom.domain.com/favicon.ico
```
Viene restituita una risposta come nell'esempio seguente:
```
(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
```
Questa risposta contiene le seguenti proprietà:
- Il valore dell'x-amz-ses-regionintestazione è la regione SES che ha ricevuto la richiesta.
- Il valore dell'x-amz-ses-request-protocolintestazione è il protocollo utilizzato per la richiesta tra CDN e SES nell'intestazione.
Se la configurazione è corretta, la regione dovrebbe riflettere la regione in cui è stato creato il dominio e il protocollo dovrebbe essere HTTPS.

Parte 2: Specificazione del dominio di reindirizzamento personalizzato e della politica HTTPS tramite un set di configurazione

Dopo aver configurato il dominio per gestire i reindirizzamenti di tracciamento aperti e cliccati, devi specificare il dominio personalizzato e la politica HTTPS in un set di configurazione.

Quando invii un'e-mail utilizzando un set di configurazione, se tale set di configurazione è configurato per utilizzare un dominio di reindirizzamento personalizzato, i link apri e clicca contenuti in tale e-mail utilizzano automaticamente il dominio personalizzato e le opzioni della politica HTTPS specificate nel set di configurazione.

È possibile completare questa operazione utilizzando la console SES o l'operazione API CreateConfigurationSetv2.

Per specificare un dominio di reindirizzamento personalizzato e una politica HTTPS utilizzando la console

Durante la creazione o la modifica di un set di configurazione, utilizzate le opzioni di tracciamento nel passaggio 4 di Creazione di set di configurazione per specificare il dominio di reindirizzamento personalizzato e le opzioni della politica HTTPS.

Per specificare un dominio di reindirizzamento personalizzato e una politica HTTPS utilizzando il AWS CLI

È possibile utilizzare l'CreateConfigurationSetoperazione nell'API SES v2 e utilizzare la TrackingOptions proprietà per specificare il dominio di reindirizzamento personalizzato e la politica HTTPS. È possibile richiamare questa operazione da AWS CLI come illustrato nell'esempio seguente.

Create il set di configurazione nel Regione AWS punto in cui desiderate inviare e tenere traccia delle e-mail:
```
aws sesv2 create-configuration-set --cli-input-json file://create.json
```
In questo esempio, il file di input utilizza i parametri della TrackingOptionsproprietà: CustomRedirectDomain specifica il dominio personalizzato da utilizzare per tenere traccia dei link aperti e cliccati e HttpsPolicy specifica un'opzione di policy HTTPS:
```
{
    "ConfigurationSetName": "my-config-set",
    "TrackingOptions": {
        "CustomRedirectDomain": "marketing.example.com",
        "HttpsPolicy": "REQUIRE"
    },
    "SendingOptions": {
        "SendingEnabled": true
    }
}
```
Per il HttpsPolicy parametro, è possibile specificare i seguenti valori per impostare il protocollo dei link di tracciamento delle aperture e dei clic per il dominio di reindirizzamento personalizzato:
- OPTIONAL— (Comportamento predefinito) I link di tracciamento aperti verranno racchiusi utilizzando HTTP. I link di tracciamento dei clic verranno inseriti utilizzando il protocollo originale del collegamento.
- REQUIRE— I link di tracciamento Open e Click verranno entrambi protetti tramite HTTPS.
- REQUIRE_OPEN_ONLY— I link di tracciamento aperti verranno avvolti utilizzando HTTPS. I link di tracciamento dei clic verranno inseriti utilizzando il protocollo originale del collegamento.

Parte 3: Specificazione dei tipi di eventi aperti e cliccati tramite un set di configurazione

Dopo aver specificato il dominio personalizzato e la politica HTTPS nella configurazione impostata nel passaggio precedente, è necessario specificare i tipi di eventi di apertura e/o clic di cui tenere traccia nella destinazione di un evento tramite un set di configurazione.

È possibile completare questa operazione utilizzando la console SES o l'operazione API CreateConfigurationSetEventDestinationv2.

Per selezionare, aprire e/o fare clic sui tipi di eventi utilizzando la console

Durante la creazione o la modifica della destinazione di un evento, utilizzate Apri e fate clic sul tracciamento nel passaggio 6 di Creazione di una destinazione degli eventi per specificare i tipi di evento.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Assegnazione di pool di IP

Specifica di set di configurazione nell'e-mail