Risoluzione dei problemi relativi al canale e-mail

Per semplificare l'identificazione della causa dell'errore, verifica che la registrazione dei log sia attivata. Per ulteriori informazioni, consulta Monitoraggio e registrazione dei log.

I messaggi non vengono visualizzati

Problemi e risoluzione

• Quando si utilizza un modello di e-mail, si verifica un errore di rendering quando le variabili tmessage risultano mancanti, sono formattate in modo errato o quando si è verificata una mancata corrispondenza tra le variabili del messaggio e i dati dell'endpoint.

• Esamina la CloudWatch metrica di Amazon SES RenderingFailure durante l'intervallo di tempo in cui è stata pubblicata la campagna per confermare se il problema è rappresentato dal rendering. Gli errori di rendering vengono visualizzati nei log degli eventi di Amazon Pinpoint come eventi _email.rendering_failure.

• Prova a eseguire la campagna senza il modello per verificare che gli endpoint riescano a ricevere correttamente i messaggi. Questa azione può aiutare a verificare se il problema è correlato alle variabili del modello.

• Per risolvere il problema, verifica che tutte le variabili del messaggio abbiano un attributo endpoint corrispondente e che siano nel formato corretto. Per ulteriori informazioni, consulta Aggiunta di contenuti personalizzati ai modelli di messaggio.

• Configura i valori predefiniti per tutte le variabili del messaggio nel modello per garantire il recapito agli endpoint se un attributo di un endpoint non è presente nel segmento.

Stato di rimbalzo

Soluzione per e-mail non recapitate

• Un evento di tipo e-mail non recapitata si verifica a causa di un errore temporaneo e nei log verrà visualizzato sotto il tipo di evento _email.softbounce. Amazon Pinpoint gestisce le e-mail non recapitate cercando di riconsegnare le e-mail non recapitate per un determinato periodo di tempo.

• Un'e-mail non recapitata può verificarsi nei seguenti scenari:

  • La casella postale del destinatario è piena.

  • La casella postale del destinatario è temporaneamente non disponibile.

  • I limiti del server sono stati superati.

  • Il server è sovraccarico.

• I codici di errore specifici relativi alle e-mail non recapitate sono 421, 450, 451 o 452. Per le descrizioni di questi codici di errore, consulta l'argomento relativo al registro dei codici di stato avanzati del protocollo SMPT (Simple Mail Transfer Protocol). La voce smtp_response nei log riporta il codice di errore per l'evento di mancato recapito.

Soluzione per il mancato recapito permanente

• Un mancato recapito permanente è un errore di recapito persistente che compare nei log sotto il tipo di evento _email.hardbounce. Per questi errori non viene eseguito un nuovo tentativo di esecuzione.

• Un mancato recapito permanente può verificarsi nei seguenti scenari:

  • L'indirizzo e-mail non esiste.

  • Il nome di dominio non esiste.

  • Il server e-mail del destinatario ha bloccato le e-mail.

  • L'indirizzo e-mail si trova nell'elenco di eliminazione degli account.

• Monitora il numero di mancati recapiti permanenti nel progetto e rimuovi gli indirizzi che li provocano dall'elenco di destinatari. I mancati recapiti permanenti possono influire negativamente sulla reputazione di invio e sulla recapitabilità del messaggio e-mail. Per ulteriori informazioni, consulta le best practice relative ai Mancati recapiti.