Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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
-
{{ses:openTracker}}Eventuali segnaposti superiori a uno verranno rimossi al momento dell'invio da parte di SES. -
Aggiungi un solo
{{ses:openTracker}}segnaposto se li utilizzi in un modello di email, poiché più di uno comporteranno la restituzione di un codice di400 BadRequestExceptionerrore.
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, inclusi i cookie, delle richieste fatte a questo server non deve superare 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ù coesa 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 link e che venga creato un sottodominio per ogni Regione AWS messaggio di posta elettronica che si desidera tracciare.
-
Verifica il sottodominio da utilizzare 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 reindirizzate deve corrispondere al sottodominio personalizzato. Regione AWS
-
Utilizza la tabella Domini di tracciamento nella tabella dei domini di tracciamento Riferimenti generali di AWS per selezionare il dominio di tracciamento che si trova nella stessa regione del tuo dominio personalizzato.
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, devi eseguire alcuni passaggi aggiuntivi, oltre a quelli necessari per configurare 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 messaggio di posta elettronica che si desidera tracciare.
-
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 Inizia con una distribuzione di base CloudFront . -
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.-
Utilizza la tabella dei domini di tracciamento nella tabella dei domini di tracciamento Riferimenti generali di AWS per selezionare il dominio di tracciamento che si trova nella stessa regione del tuo dominio personalizzato.
-
-
Se utilizzi Route 53 per gestire la configurazione DNS per il tuo dominio e CloudFront come CDN, crea un record Alias in Route 53 che si riferisce 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 stia utilizzando la regione e il protocollo HTTPS corretti. Nel seguente esempio, tutto è letterale tranne il nome del tuo dominio:
curl --head https://custom.domain.com/favicon.icoViene 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 GMTQuesta 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 deve 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 delle aperture e dei clic, 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 collegamenti di apertura e clic contenuti nell'e-mail utilizzano automaticamente il dominio personalizzato e le opzioni dei criteri HTTPS specificate nel set di configurazione.
È possibile completare questa operazione utilizzando la console SES o l'operazione API CreateConfigurationSet v2.
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, utilizza 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 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 chiamare questa operazione da AWS CLI come mostrato nell'esempio seguente.
-
Crea il set di configurazione nel Regione AWS punto in cui desideri inviare e tenere traccia delle email:
aws sesv2 create-configuration-set --cli-input-json file://create.json -
In questo esempio, il file di input utilizza i parametri della
TrackingOptionsproprietà:CustomRedirectDomainspecifica il dominio personalizzato da utilizzare per tracciare i collegamenti aperti e cliccati eHttpsPolicyspecifica un'opzione di policy HTTPS:{ "ConfigurationSetName": "my-config-set", "TrackingOptions": { "CustomRedirectDomain": "marketing.example.com", "HttpsPolicy": "REQUIRE" }, "SendingOptions": { "SendingEnabled": true } }Per il
HttpsPolicyparametro, è 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 raggruppati tramite HTTP. I link di tracciamento dei clic verranno raggruppati utilizzando il protocollo originale del collegamento. -
REQUIRE— I link di tracciamento di Open e Click verranno entrambi racchiusi utilizzando HTTPS. -
REQUIRE_OPEN_ONLY— I link di tracciamento aperti verranno raggruppati utilizzando HTTPS. I link di tracciamento dei clic verranno raggruppati utilizzando il protocollo originale del collegamento.
-
Parte 3: Specificazione dei tipi di eventi di apertura e clic tramite un set di configurazione
Dopo aver specificato il dominio personalizzato e la politica HTTPS nel set di configurazione del passaggio precedente, è necessario specificare i tipi di eventi open and/or click da tracciare nella destinazione di un evento tramite un set di configurazione.
È possibile completare questa operazione utilizzando la console SES o l'operazione API CreateConfigurationSetEventDestination v2.
Per selezionare i tipi di eventi aperti, and/or fai clic sulla console
-
Durante la creazione o la modifica della destinazione di un evento, utilizza Apri e fai clic sul tracciamento nel passaggio 6 di Creazione di una destinazione degli eventi per specificare i tipi di evento.
Parte 4 (opzionale): configurazione di segmenti di percorso personalizzati per Universal Links e App Links
Questa sezione è facoltativa. Completalo solo se hai un'app mobile e desideri che iOS Universal Links o Android App Links aprano l'app direttamente quando i destinatari fanno clic sui link di tracciamento. Completa la sottosezione per ogni piattaforma mobile supportata dalla tua app: iOS, Android o entrambe. Prima di iniziare, completa la Parte 1 per configurare un dominio di reindirizzamento personalizzato e la Parte 2 per configurare il set di configurazione per l'utilizzo di quel dominio.
Se utilizzi iOS Universal Links o Android App Links, il sistema operativo controlla un file di verifica ospitato nel dominio di tracciamento dei clic per decidere quale app deve aprire il link. Se l'app è installata, il link si apre direttamente nell'app. Se l'app non è installata, il collegamento rimanda al browser web. Poiché questi file di verifica utilizzano la corrispondenza tra percorso e prefisso, devi controllare il segmento di percorso negli URL di tracciamento.
Utilizza l'ses:custom-pathattributo sui singoli <a> tag nell'HTML della tua email per aggiungere un segmento di percorso fisso all'URL di tracciamento:
<a href="https://example.com/product/123" ses:custom-path="myapp">View product</a>
I seguenti esempi mostrano la differenza tra un URL di tracciamento senza e conses:custom-path:
-
Senza
ses:custom-path(impostazione predefinita):https://{your-custom-redirect-domain}/CL0/{encodedUrl}/{index}/{messageId}/{hmac} -
Con
ses:custom-path="myapp":https://{your-custom-redirect-domain}/CL1/myapp/{encodedUrl}/{index}/{messageId}/{hmac}
Il ses:custom-path valore deve soddisfare i seguenti requisiti:
-
Solo lettere (A—Z, a—z), cifre (0—9), trattini (-), punti (.) o trattini bassi (_)
-
1—32 caratteri, con distinzione tra maiuscole e minuscole
-
SES rimuove questo attributo dall'email prima della consegna
-
Torna al formato predefinito se il valore non è valido (equivale a
ses:custom-pathometterlo)
Il ses:custom-path valore non viene visualizzato nei dati degli eventi click. Per identificare su quale link è stato fatto clic negli eventi, usases:tags.
Collegamenti universali iOS
Per autorizzare la tua app iOS a gestire gli Universal Links sul tuo dominio di reindirizzamento personalizzato, ospita il seguente file su: https://{your-custom-redirect-domain}/.well-known/apple-app-site-association
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.myapp",
"paths": ["/CL1/myapp/*"]
}
]
}
}
Sostituisci. TEAMID com.example.myappcon il tuo ID Apple Team e l'identificatore del pacchetto di app e myapp con il valore in cui specifichi. ses:custom-path
Collegamenti alle app Android
Per autorizzare la tua app Android a gestire i link alle app sul tuo dominio di reindirizzamento personalizzato, ospita il seguente file su: https://{your-custom-redirect-domain}/.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.myapp",
"sha256_cert_fingerprints": ["certificate-fingerprint"]
}
}]
Sostituiscilo com.example.myapp con il nome del pacchetto dell'app e certificate-fingerprint con l'impronta digitale del certificato di firma dell'app.
Nota
Android gestisce la corrispondenza tra percorso e prefisso in modo diverso rispetto a iOS. Invece di definire i prefissi di percorso nel assetlinks.json file, configura un filtro di intento nel campo AndroidManifest.xml with della tua appandroid:pathPrefix="/CL1/, dove si myapp/"myapp trova il valore specificato. ses:custom-path Per ulteriori informazioni, consulta la documentazione Android App Links sul sito Web Android Developers.