Configurazione di un dominio per gestire i reindirizzamenti ai collegamenti di apertura e clic Specificazione del dominio e della politica di reindirizzamento personalizzati 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 aperti e cliccati, Amazon SES apporta modifiche minori alle e-mail che invii. Per acquisire eventi aperti, SES aggiunge un'GIFimmagine trasparente di 1 pixel per 1 pixel in ogni e-mail inviata, SES che include un nome di file univoco per ogni e-mail, ed è ospitata su un server gestito daSES; quando l'immagine viene scaricata, SES può dire 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 in SES pixel non viene caricata e ridurrà i tassi di apertura che stai cercando di monitorare. 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 SES ricevuto il messaggio con il segnaposto, questo verrà sostituito con un'immagine con pixel di tracciamento aperta.

Importante

Tutti i {{ses:openTracker}} segnaposto in numero superiore a uno verranno rimossi al momento dell'invio. SES
Aggiungi un solo {{ses:openTracker}} segnaposto se li utilizzi in un modello di email, poiché più di uno genereranno la restituzione di un codice di 400 BadRequestException errore.

Per acquisire 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 effettuate 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, per creare un'esperienza più coerente per i destinatariSES, il che significa che tutti gli indicatori vengono rimossi. SES 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 di destinazioni SES per eventi Amazon.

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

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

Opzione 1: configurazione di un dominio HTTP

Se prevedi di utilizzare un HTTP dominio per gestire i link aperti e cliccati (anziché un HTTPS dominio), il processo di configurazione del sottodominio richiede solo pochi passaggi.

Nota

Se configuri un dominio personalizzato che utilizza il HTTP protocollo e invii un'e-mail contenente link che utilizzano il HTTPS protocollo, i tuoi clienti potrebbero visualizzare un messaggio di avviso quando fanno clic sui link contenuti nell'e-mail. Se prevedi di inviare e-mail contenenti link che utilizzano il HTTPS protocollo, dovresti utilizzare un HTTPS dominio per gestire gli eventi di tracciamento dei clic.

Per configurare un HTTP sottodominio per la gestione dei link, apri e clicca

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

Aggiungi un nuovo CNAME record alle DNS impostazioni 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 il dominio Regioni AWS where SES è disponibile. Seleziona quello che si trova nella stessa area 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 web hosting, potrebbero essere necessari alcuni minuti prima che le modifiche apportate al DNS record del sottodominio abbiano effetto. 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 HTTPS dominio per tracciare i clic di apertura e sui link. Per configurare un HTTPS dominio per il monitoraggio delle aperture e dei clic sui link, devi eseguire alcuni passaggi aggiuntivi, oltre a quelli necessari per la configurazione di un HTTP dominio.

Per configurare un HTTPS sottodominio per la gestione dei link aperti e cliccati

Crea un sottodominio da utilizzare per i collegamenti di traccia di apertura e clic. SESconsiglia che questo sottodominio sia specificamente dedicato alla gestione di questi collegamenti e che venga creato un sottodominio per ogni Regione AWS messaggio di posta elettronica inviato e che desideri monitorare.
Verifica il sottodominio da utilizzare 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 CDN l'origine che è il dominio di SES tracciamento, ad r.us-east-1.awstrack.me esempio. CDNDeve puntare al dominio di AWS tracciamento che si trova nella stessa regione del dominio personalizzato. CDNÈ necessario 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 il dominio Regioni AWS where SES è disponibile: seleziona quello che si trova nella stessa area del tuo 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 usi Route 53 per gestire la DNS configurazione del tuo dominio e CloudFront come tuoCDN, 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.

Altrimenti, nella DNS configurazione del tuo sottodominio, aggiungi un record che si riferisce all'indirizzo del tuo. CNAME CDN
Acquisisci un SSL certificato da un'autorità di certificazione affidabile. Il certificato deve coprire sia il sottodominio creato nel passaggio 1 sia CDN quello configurato nei passaggi 3—5. Carica il certificato su. CDN
Puoi usare il seguente comando curl per verificare che il tuo dominio personalizzato appena creato utilizzi la regione e HTTPS il protocollo 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-request-regionintestazione è la SES regione che ha ricevuto la richiesta.
- Il valore dell'x-amz-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 dovrebbe esserlo il protocollo. HTTPS

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

Dopo aver configurato il dominio per gestire i reindirizzamenti di tracciamento aperti e cliccati, devi specificare il dominio e la HTTPS policy personalizzati 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 collegamenti apri e clicca contenuti in tale e-mail utilizzano automaticamente il dominio personalizzato e le opzioni di HTTPS policy specificate nel set di configurazione.

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

Per specificare un dominio e una HTTPS policy di reindirizzamento personalizzati 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 e le opzioni di HTTPS policy personalizzate.

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

È possibile utilizzare l'CreateConfigurationSetoperazione nella SES API 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 HTTPS politica:
```
{
    "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 inseriti 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 inclusi. HTTPS
- REQUIRE_OPEN_ONLY— I link di tracciamento aperti verranno inseriti 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 e la HTTPS policy personalizzati 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 SES console o l'operazione CreateConfigurationSetEventDestinationv2API.

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

Assegnare pool di indirizzi IP

Specifica di set di configurazione nell'e-mail