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.
Questa sezione si applica ai canali online: email, SMS, notifica push.
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 .
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).
Quando un utente risponde a un messaggio SMS con una parola chiave come "STOP" al fine di rifiutare le consegne degli SMS, il suo profilo non viene aggiunto al elenco Bloccati come nel processo di rifiuto dell'e-mail. Il numero di telefono del profilo viene inviato in quarantena, in modo che l'utente continui a ricevere i messaggi e-mail.
È possibile elencare gli indirizzi messi in quarantena per una consegna specifica o per l’intera piattaforma.
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).
Gli amministratori possono elencare gli indirizzi in quarantena per l'intera piattaforma dal nodo Administration > Campaign Management > Non deliverables Management > Non deliverables and addresses.
Questo menu elenca gli elementi messi in quarantena per i canali e-mail, SMS e di notifiche push.
Per ogni indirizzo sono disponibili le seguenti informazioni:
L'aumento delle quarantena è un effetto normale, legato all'usura del database. Ad esempio, se la durata di un indirizzo e-mail è considerata di tre anni e la tabella dei destinatari aumenta del 50% ogni anno, l’aumento delle quarantena può essere calcolato come segue:
Fine anno 1: (10.33)/(1+0.5)=22%.
Fine anno 2: ((1.220.33)+0.33)/(1.5+0.75)=32,5%.
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.
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.
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:
Il relativo stato viene quindi modificato in Valid.
I destinatari con un indirizzo nello stato Quarantine o On denylist non verranno mai rimossi, anche se ricevono un'e-mail.
È 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.
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.
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.
Invece di errori gravi, gli errori software non inviano immediatamente un indirizzo alla quarantena, ma incrementano un contatore di errori.
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.
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.
Per iOS - connettore binario
A partire dalla release Campaign 20.3, il connettore legacy binario per iOS è diventato obsoleto. Se utilizzi questo connettore, devi adattare di conseguenza l’implementazione. Ulteriori informazioni
Per ogni notifica, Adobe Campaign riceve gli errori sincroni e asincroni dal server APN. Per i seguenti errori sincroni, Adobe Campaign genera errori software:
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 |
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:
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.
Per i clienti che utilizzano il connettore Baidu, ecco i diversi tipi di errori:
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 |
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.
La tabella Delivery log qualification non si applica al connettore SMPP generico esteso.
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.
I tipi di errore e i motivi dell'errore sono gli stessi utilizzati per le e-mail. Vedere Tipi e motivi di mancata consegna.
Chiedete al vostro fornitore un elenco di stati e codici di errore al fine di impostare i tipi di errore e i motivi corretti per l'errore nella tabella delle qualifiche del registro di consegna.
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.