Informazioni sulla gestione della quarantena

Informazioni sulla quarantena

Adobe Campaign gestisce un elenco di indirizzi in quarantena. I destinatari il cui indirizzo è stato messo in quarantena sono esclusi per impostazione predefinita durante l’analisi della consegna e non saranno oggetto di targeting. Un indirizzo e-mail può essere posto in quarantena, ad esempio, quando la casella di posta è piena o se l’indirizzo non esiste. In ogni caso, la procedura di quarantena è conforme alle norme specifiche descritte di seguito.

Ottimizzazione della consegna tramite quarantena

I profili con indirizzi e-mail o numeri di telefono in quarantena vengono automaticamente esclusi durante la preparazione dei messaggi (vedi Identificazione degli indirizzi messi in quarantena per una consegna). In questo modo le consegne sono più rapide, poiché il tasso di errore ha un effetto significativo sulla velocità di consegna.

Alcuni provider di accesso a Internet considerano automaticamente le e-mail come spam se il tasso di indirizzi non validi è troppo alto. Quarantine quindi consente di evitare di essere aggiunti al elenco Bloccati da questi provider.

Inoltre, le quarantene contribuiscono a ridurre i costi di invio degli SMS escludendo numeri di telefono errati dalle consegne. Per ulteriori informazioni sulle best practice per proteggere e ottimizzare le consegne, consulta questa pagina .

Quarantena e elenco Bloccati

La quarantena si applica solo a un indirizzo, non a tutto il profilo. Ciò significa che se due profili hanno lo stesso indirizzo e-mail, vengono entrambi coinvolti se l’indirizzo viene messo in quarantena.

Allo stesso modo, un profilo con un indirizzo e-mail messo in quarantena potrebbe aggiornare il profilo e immettere un nuovo indirizzo e potrebbe quindi essere nuovamente indirizzato mediante azioni di consegna.

Essere sul elenco Bloccati, d'altro canto, il profilo non sarà più oggetto di alcuna consegna, ad esempio dopo un annullamento dell'iscrizione (opt-out).

Identificazione degli indirizzi messi in quarantena

È possibile elencare gli indirizzi messi in quarantena per una consegna specifica o per l’intera piattaforma.

Identificazione di indirizzi messi in quarantena per una consegna

Gli indirizzi in quarantena per una consegna specifica sono elencati durante la fase di preparazione della consegna, nei registri di consegna del dashboard di consegna (vedere Registri di consegna e cronologia).

Identificazione degli indirizzi messi in quarantena per l’intera piattaforma

Gli amministratori possono elencare gli indirizzi in quarantena per l'intera piattaforma dal nodo Administration > Campaign Management > Non deliverables Management > Non deliverables and addresses.

Per ogni indirizzo sono disponibili le seguenti informazioni:

Identificazione degli indirizzi in quarantena nei report di consegna

I seguenti rapporti forniscono informazioni sugli indirizzi in quarantena:

• Per ogni consegna, il rapporto Delivery summary mostra il numero di indirizzi in quarantena nella destinazione di consegna. Viene visualizzato:

  • il numero di indirizzi messi in quarantena durante l'analisi della consegna,

  • Numero di indirizzi posti in quarantena dopo l'azione di consegna.

• Il rapporto Non-deliverables and bounces visualizza informazioni sugli indirizzi in quarantena, sui tipi di errori rilevati, ecc., e una suddivisione non riuscita per dominio.

Potete cercare queste informazioni per tutte le consegne della piattaforma (Home page > Reports) o per una consegna specifica. Potete anche creare rapporti personalizzati e selezionare le informazioni da visualizzare.

Identificazione di indirizzi in quarantena per un destinatario

Puoi cercare lo stato dell’indirizzo e-mail di qualsiasi destinatario. A tal fine, selezionare il profilo del destinatario e fare clic sulla scheda Deliveries. Per tutte le consegne a quel destinatario, potete verificare se l'indirizzo ha avuto esito negativo, è stato messo in quarantena durante l'analisi, ecc. Per ogni cartella, potete visualizzare solo i destinatari il cui indirizzo e-mail è in quarantena. A questo scopo, utilizzare il filtro dell'applicazione Quarantined email address.

Rimozione di un indirizzo in quarantena

Se necessario, è possibile rimuovere manualmente un indirizzo dall'elenco di quarantena. Inoltre, gli indirizzi che corrispondono a condizioni specifiche vengono eliminati automaticamente dall'elenco di quarantena dal flusso di lavoro Database cleanup.

Per rimuovere manualmente un indirizzo dall'elenco di quarantena:

• È possibile modificarne lo stato in Valid dal nodo Administration > Campaign Management > Non deliverables Management > Non deliverables and addresses.

  

• È inoltre possibile modificarne lo stato in Allowlisted. In questo caso, l'indirizzo rimane nell'elenco di quarantena, ma sarà mirato sistematicamente, anche se si verifica un errore.

Gli indirizzi vengono rimossi automaticamente dall'elenco di quarantena nei seguenti casi:

• Gli indirizzi in uno stato With errors verranno rimossi dall'elenco di quarantena dopo la corretta consegna.
• Gli indirizzi in uno stato With errors saranno rimossi dall'elenco di quarantena se l'ultimo rimbalzo morbido si è verificato più di 10 giorni fa. Per ulteriori informazioni sulla gestione degli errori software, vedere questa sezione.
• Gli indirizzi in uno stato With errors rimbalzato con l'errore Mailbox full verranno rimossi dall'elenco di quarantena dopo 30 giorni.

Il relativo stato viene quindi modificato in Valid.

È possibile modificare il numero di errori e il periodo compreso tra due errori. A questo scopo, modificate le impostazioni corrispondenti nella procedura guidata di distribuzione (Email channel > Advanced parameters). Per ulteriori informazioni sulla procedura guidata di distribuzione, consultare questa sezione.

Condizioni per la messa in quarantena di un indirizzo

Adobe Campaign gestisce la quarantena in base al tipo di consegna non riuscita e al motivo assegnato durante la qualifica dei messaggi di errore (vedere Qualificazione della posta in sospeso) e Tipi e motivi di consegna non riuscita.

• Errore ignorato: gli errori ignorati non mettono un indirizzo in quarantena.
• Errore rigido: l’indirizzo e-mail corrispondente viene messo immediatamente in quarantena.
• Errore morbido: gli errori morbidi non mettono immediatamente un indirizzo in quarantena, ma incrementano un contatore di errori. Per ulteriori informazioni, vedere Gestione degli errori soft.

Se un utente qualifica un'e-mail come spam (Ciclo di feedback), il messaggio viene automaticamente reindirizzato verso una cassetta postale tecnica gestita da Adobe. L'indirizzo e-mail dell'utente viene quindi inviato automaticamente alla quarantena.

Nell'elenco degli indirizzi posti in quarantena, il campo Error reason indica perché l'indirizzo selezionato è stato messo in quarantena. In Adobe Campaign la quarantena distingue tra maiuscole e minuscole. Accertati di importare gli indirizzi e-mail in lettere minuscole, in modo che non vengano reindirizzate in un secondo momento.

Gestione degli errori soft

Invece di errori gravi, gli errori software non inviano immediatamente un indirizzo alla quarantena, ma incrementano un contatore di errori.

• Quando il contatore di errori raggiunge la soglia limite, l'indirizzo viene messo in quarantena.
• Nella configurazione predefinita, la soglia è impostata a cinque errori, dove due errori sono significativi se si verificano almeno a 24 ore di distanza. L’indirizzo viene messo in quarantena al quinto errore.
• È possibile modificare la soglia del contatore di errori. Per ulteriori informazioni, fare riferimento a Tentativi dopo un errore temporaneo di consegna.

Il contatore di errori viene reinizializzato se l'ultimo errore significativo si è verificato più di 10 giorni fa. Lo stato dell'indirizzo diventa quindi Valido e viene eliminato dall'elenco delle quarantena dal flusso di lavoro Pulizia del database.

quarantena delle notifiche push

Il meccanismo di quarantena per le notifiche push è globalmente uguale al processo generale. Vedere Informazioni sulle quarantena. Tuttavia, alcuni errori vengono gestiti in modo diverso per le notifiche push. Ad esempio, per alcuni errori software, non vengono eseguiti tentativi all'interno della stessa consegna. Le specifiche per la notifica push sono elencate di seguito. Il meccanismo dei tentativi (numero di tentativi, frequenza) è lo stesso utilizzato per le e-mail.

Gli elementi messi in quarantena sono token dispositivo.

quarantena iOS

Per iOS - connettore binario

Per ogni notifica, Adobe Campaign riceve gli errori sincroni e asincroni dal server APN. Per i seguenti errori sincroni, Adobe Campaign genera errori software:

• Problemi di lunghezza del payload: nessun tentativo, il motivo dell'errore è Unreachable.
• Problemi di scadenza del certificato: nessun tentativo, il motivo dell'errore è Unreachable.
• Connessione persa durante la consegna: il motivo dell'errore è Unreachable.
• Problema di configurazione del servizio (certificato non valido, password del certificato non valida, nessun certificato): nessun tentativo, il motivo dell'errore è Unreachable.

Il server APN avvisa in modo asincrono Adobe Campaign che un token dispositivo è stato deregistrato (quando l'applicazione mobile è stata disinstallata dall'utente). Il flusso di lavoro mobileAppOptOutMgt viene eseguito ogni 6 ore per contattare i servizi di feedback APN per aggiornare la tabella AppSubscriptionRcp. Per tutti i token disattivati, il campo Disabled è impostato su True e la sottoscrizione collegata a tale token dispositivo verrà automaticamente esclusa dalle consegne future.

Per iOS - Connettore HTTP/V2

Il protocollo HTTP/V2 consente un feedback diretto e uno stato per ogni invio push. Se si utilizza il connettore del protocollo HTTP/V2, il servizio di feedback non viene più chiamato dal flusso di lavoro mobileAppOptOutMgt. I token non registrati vengono gestiti in modo diverso tra il connettore binario iOS e il connettore iOS HTTP/V2. Un token viene considerato non registrato quando un’applicazione mobile viene disinstallata o reinstallata.

Sincrona, se le APN restituiscono uno stato "non registrato" per un messaggio, il token di destinazione verrà messo immediatamente in quarantena.

Scenario	Stato	Messaggio di errore	Tipo di errore	Motivo errore	Riprova
Dispositivo di destinazione attivato su	OK
Dispositivo di destinazione spento	OK
L'utente disabilita le notifiche per l'applicazione	OK
Fase di creazione/analisi dei messaggi: payload troppo grande	Errore	Payload troppo lungo	Soft	Rifiutato	No
Fase di creazione/analisi dei messaggi: problema di formato di contenuto imprevisto	Errore	Vari messaggi di errore in base all'errore	Soft	Undefined	No
Problema del certificato (password, danneggiamento, ecc.) e verifica la connessione a APNs issue	Errore	Vari messaggi di errore in base all'errore	Soft	Rifiutato	No
Connessione di rete persa durante l'invio	Errore	Errore di connessione	Undefined	Non raggiungibile	Yes
Rifiuto del messaggio APN: Annullamento della registrazione l'utente ha rimosso l'applicazione o il token è scaduto	Errore	Non registrato	Hard	Utente sconosciuto	No
Rifiuto del messaggio APN: tutti gli altri errori	Errore	La causa del rifiuto dell'errore sarà presente nel messaggio di errore	Soft	Rifiutato	No

quarantena Android

Per Android V1

Per ogni notifica, Adobe Campaign riceve gli errori sincroni direttamente dal server FCM. campagna di Adobe li gestisce al volo e genera errori rigidi o morbidi in base alla gravità dell'errore e i tentativi possono essere eseguiti:

• Lunghezza payload superata, problema di connessione, problema di disponibilità del servizio: tentativi eseguiti, errore software, motivo errore è Refused.
• Quota dispositivo superata: nessun tentativo, errore software, motivo errore è Refused.
• Token non valido o non registrato, errore imprevisto, problema dell'account del mittente: nessun tentativo, errore rigido, motivo errore è Refused.

Il flusso di lavoro mobileAppOptOutMgt viene eseguito ogni 6 ore per aggiornare la tabella AppSubscriptionRcp. Per i token dichiarati non registrati o non più validi, il campo Disabled è impostato su True e la sottoscrizione collegata a tale token dispositivo verrà automaticamente esclusa dalle consegne future.

Durante l'analisi della consegna, tutti i dispositivi esclusi dalla destinazione vengono automaticamente aggiunti alla tabella excludeLogAppSubRcp.

Adobe Campaign contatta il server di Baidu ogni 10 minuti per recuperare lo stato del messaggio inviato e aggiorna i registri di trasmissione. Se un messaggio viene dichiarato come inviato, lo stato del messaggio nei registri di trasmissione è impostato su Received. Se Baidu dichiara un errore, lo stato è impostato su Failed.

Per Android V2

Il meccanismo di quarantena Android V2 utilizza lo stesso processo di Android V1, lo stesso vale per l'aggiornamento delle sottoscrizioni e delle esclusioni. Per ulteriori informazioni, consultare la sezione Android V1.

Scenario	Stato	Messaggio di errore	Tipo di errore	Motivo errore	Riprova
Fase di creazione/analisi dei messaggi: parole chiave non consentite utilizzate nei campi personalizzati	Errore	Non è possibile utilizzare le seguenti parole chiave: {1}	Soft		No
Fase di creazione/analisi dei messaggi: payload troppo grande	Errore	La notifica è troppo pesante: {1} bit, mentre solo {2} sono autorizzati	Soft	Rifiutato	No
Connessione di rete persa durante l'invio	Errore	Nessuna risposta dal servizio Firebase Cloud Messaging all'indirizzo: {1}	Soft	Non raggiungibile	Yes
Rifiuto del messaggio FCM: Il server FCM non è temporaneamente disponibile (ad esempio con timeout).	Errore	Il servizio Firebase Cloud Messaging è temporaneamente non disponibile	Soft	Non raggiungibile	Yes
Rifiuto del messaggio FCM: Errore durante l'autenticazione dell'account del mittente	Errore	Impossibile identificare l'account sviluppatore. Controllare l'ID e la password	Soft	Rifiutato	No
Rifiuto del messaggio FCM: Quota dispositivo superata	Errore		Soft	Rifiutato	Yes
Rifiuto del messaggio FCM: Registrazione non valida / non registrata	Errore		Hard	Utente sconosciuto	No
Rifiuto del messaggio FCM: Tutti gli altri errori	Errore	Il server Firebase Cloud Messaging ha restituito un codice di errore imprevisto: {1}		Rifiutato	No
Rifiuto del messaggio FCM: Argomento non valido	Errore	INVALID_ARGUMENT	Ignorato	Undefined	No
Rifiuto del messaggio FCM: Errore di autenticazione di terze parti	Errore	THIRD_PARTY_AUTH_ERROR	Ignorato	Rifiutato	Yes
Rifiuto del messaggio FCM: ID mittente non corrispondente	Errore	SENDER_ID_MISMATCH	Morbido	Utente sconosciuto	No
Rifiuto del messaggio FCM: Non registrato	Errore	NON REGISTRATO	Rigido	Utente sconosciuto	No
Rifiuto del messaggio FCM: Internal	Errore	INTERNO	Ignorato	Rifiutato	Yes
Rifiuto del messaggio FCM: Non disponibile	Errore	NON DISPONIBILE	Ignorato	Rifiutato	Yes
Rifiuto del messaggio FCM: codice di errore imprevisto	Errore	codice di errore imprevisto	Ignorato	Rifiutato	No
Autenticazione: Problema di connessione	Errore	Impossibile connettersi al server di autenticazione	Ignorato	Rifiutato	Yes
Autenticazione: Client o ambito non autorizzati nella richiesta.	Errore	unauthorized_client	Ignorato	Rifiutato	No
Autenticazione: Il client non è autorizzato a recuperare i token di accesso utilizzando questo metodo, oppure il client non è autorizzato per alcuno degli ambiti richiesti.	Errore	unauthorized_client	Ignorato	Rifiutato	No
Autenticazione: Accesso negato	Errore	access_disabled	Ignorato	Rifiutato	No
Autenticazione: E-mail non valida	Errore	invalid_Grant	Ignorato	Rifiutato	No
Autenticazione: JWT non valido	Errore	invalid_Grant	Ignorato	Rifiutato	No
Autenticazione: Firma JWT non valida	Errore	invalid_Grant	Ignorato	Rifiutato	No
Autenticazione: Ambito OAuth o pubblico token ID non valido fornito	Errore	unauthorized_client	Ignorato	Rifiutato	No
Autenticazione: Client OAuth disabilitato	Errore	disabled_client	Ignorato	Rifiutato	No

quarantena SMS

Per connettori standard

Il meccanismo di quarantena per i messaggi SMS è globalmente lo stesso del processo generale. Vedere Informazioni sulle quarantena. Le specifiche per gli SMS sono elencate di seguito.

Scenario	Stato	Messaggio di errore	Tipo di errore	Motivo errore
Inviato al provider	Inviato
Ricevuto sul dispositivo mobile	Received
Errore restituito dal provider	Errore	Errore durante la ricezione dei dati (SR o MO)	Soft	Non raggiungibile
Conferma MT non valida	Errore	Errore '{1}' durante l'elaborazione del frame di riconoscimento per la query di invio	Soft	Non raggiungibile
Errore durante l'invio del MT	Errore	Errore durante l'invio dei messaggi	Soft	Non raggiungibile

Per il connettore SMPP generico esteso

Quando si utilizza il protocollo SMPP per inviare messaggi SMS, la gestione degli errori viene gestita in modo diverso. Per ulteriori informazioni sul connettore SMPP generico esteso, fare riferimento a questa pagina.

Il connettore SMPP recupera i dati dal messaggio SR (Status Report) restituito utilizzando espressioni regolari (regex) per filtrare il contenuto. Questi dati vengono quindi confrontati con le informazioni presenti nella tabella Delivery log qualification (disponibile dal menu Administration > Campaign Management > Non deliverables Management).

Prima che un nuovo tipo di errore sia qualificato, il motivo dell'errore è sempre impostato su Rifiutato per impostazione predefinita.

Esempio di messaggio generato:

SR Generic DELIVRD 000|#MESSAGE#

• Tutti i messaggi di errore iniziano con SR per distinguere i codici di errore SMS dai codici di errore e-mail.

• La seconda parte (Generic in questo esempio) del messaggio di errore fa riferimento al nome dell'implementazione SMSC, come definito nel campo SMSC implementation name dell'account esterno SMS. Consulta questa pagina.

  Poiché lo stesso codice di errore può avere un significato diverso per ciascun provider, questo campo consente di sapere quale provider ha generato il codice di errore. L'errore può essere trovato nella documentazione del fornitore pertinente.

• La terza parte (DELIVRD in questo esempio) del messaggio di errore corrisponde al codice di stato recuperato dalla SR utilizzando il regex di estrazione dello stato definito nell'account esterno di SMS.

  Questo regex è specificato nella scheda SMSC specificities dell'account esterno. Consulta questa pagina.

  

  Per impostazione predefinita, il regex estrae il campo stat: come definito nella sezione Appendice B della specifica SMPP 3.4.

• La quarta parte (000 in questo esempio) del messaggio di errore corrisponde al codice di errore estratto dalla SR utilizzando il regex di estrazione del codice di errore definito nell'account esterno di SMS.

  Questo regex è specificato nella scheda SMSC specificities dell'account esterno. Consulta questa pagina.

  Per impostazione predefinita, il regex estrae il campo err: come definito nella sezione Appendice B della specifica SMPP 3.4.

• Tutto ciò che viene dopo il simbolo di tubo (|) viene visualizzato solo nella colonna First text della tabella Delivery log qualification. Questo contenuto viene sempre sostituito da #MESSAGE# dopo la normalizzazione del messaggio. Questo processo evita di inserire più voci per errori simili ed è lo stesso delle e-mail. Per ulteriori informazioni, vedere Qualificazione della posta in sospeso.

Il connettore SMPP generico esteso applica un euristico per trovare valori predefiniti ragionevoli: se lo stato inizia con DELIV, viene considerato un successo perché corrisponde agli stati comuni DELIVRD o DELIVERED utilizzati dalla maggior parte dei fornitori. Qualsiasi altro stato porta a un duro fallimento.