dotdigital (in precedenza Dotmailer): guida all'integrazione, best practice e risoluzione dei problemi per gli utenti di Purple AI

Sintesi Esecutiva

La piattaforma Purple AI acquisisce dati di prima parte degli ospiti al momento dell'autenticazione WiFi in hotel, punti vendita retail, stadi e spazi pubblici. Il connettore dotdigital — precedentemente noto come Dotmailer — trasforma l'acquisizione di questi dati grezzi in una pipeline di marketing automation di livello enterprise. Quando un ospite si connette al tuo WiFi e fornisce il consenso alle comunicazioni di marketing, Purple invia il suo profilo a una rubrica dotdigital designata in tempo reale. Da quel momento, il motore di automazione di dotdigital può attivare percorsi di benvenuto, inviti a programmi fedeltà, campagne di re-engagement e comunicazioni omnicanale tramite email, SMS e notifiche push.

Il caso commerciale è ampiamente documentato. Harrods ha creato un database di 3,6 milioni di contatti attraverso l'acquisizione di dati guidata dal WiFi e ha ottenuto un ritorno di 54 volte sull'investimento in Purple in un solo anno. AGS Airports ha registrato un ROI dell'842%. L'aeroporto di Bruxelles-Sud Charleroi ha registrato un ROI del 10.630% utilizzando i MicroSurvey di Purple in combinazione con la marketing automation a valle. Questi risultati non sono eccezionali: sono il risultato atteso di un'integrazione ben configurata e implementata con una progettazione deliberata del programma.

Questa guida fornisce l'approfondimento tecnico necessario per implementare, ottimizzare e risolvere i problemi dell'integrazione tra Purple e dotdigital su scala aziendale. È strutturata per i professionisti IT che devono implementare una soluzione in questo trimestre, non valutarne una il prossimo anno.

Approfondimento Tecnico

Architettura dell'Integrazione

Il connettore Purple-dotdigital opera come un'integrazione REST API server-to-server. Purple funge da produttore di dati e dotdigital funge da consumatore. La connessione viene autenticata utilizzando il meccanismo Basic Auth di dotdigital: un account utente API dedicato (indirizzo email e password) creato all'interno della piattaforma dotdigital, combinato con un URL dell'endpoint API specifico per la regione.

L'architettura è unidirezionale per impostazione predefinita: Purple invia i record dei contatti a dotdigital al momento dell'autenticazione WiFi. Per le organizzazioni che richiedono una sincronizzazione bidirezionale (ad esempio, per riflettere le disiscrizioni o gli aggiornamenti delle liste di soppressione in Purple), è necessaria una configurazione aggiuntiva tramite il framework webhook di dotdigital.

Payload dei dati e mappatura dei campi

Purple trasmette otto campi dati a dotdigital per ogni ospite consenziente. Questi campi si mappano direttamente sul modello di dati dei contatti standard di dotdigital e non richiedono la configurazione di campi personalizzati per le distribuzioni di base.

La trasmissione dei dati è vincolata al consenso a livello di piattaforma. Purple non invierà un record di contatto a dotdigital a meno che l'ospite non abbia esplicitamente acconsentito alle comunicazioni di marketing tramite la casella di controllo del consenso della splash page. Si tratta di un'applicazione rigida — non di un'opzione configurabile — ed è il meccanismo principale con cui l'integrazione mantiene la conformità con il GDPR del Regno Unito, il Regolamento generale sulla protezione dei dati dell'UE e il CCPA.

Autenticazione e configurazione dell'endpoint

dotdigital utilizza l'autenticazione HTTP Basic per la sua API REST. Le credenziali consistono nell'indirizzo email e nella password di un utente API, che devono essere creati come utente dedicato all'interno dell'account dotdigital — non il login dell'account principale. L'URL dell'endpoint dell'API è specifico dell'account e dipende dalla regione. Viene recuperato da Impostazioni account > Accesso all'interno della piattaforma dotdigital. Un endpoint tipico assume la forma https://r1-api.dotdigital.com per gli account della regione uno.

Questa specificità dell'endpoint è la causa più comune di errori di verifica del connettore. I team che tentano di utilizzare un URL generico o di esempio della documentazione riscontreranno errori di autenticazione. Recuperare sempre il valore dell'endpoint direttamente dall'account dotdigital in uso.

Livelli di distribuzione del connettore

Purple supporta due livelli di distribuzione per il connettore dotdigital:

Il livello cliente applica la configurazione del connettore all'intero account Purple, indirizzando tutti gli ospiti consenzienti di tutte le sedi in un'unica rubrica dotdigital. Questo è appropriato per gli operatori di singole sedi o per le organizzazioni con un patrimonio di sedi omogeneo.

A livello di venue è possibile mappare ogni singola venue a una rubrica dotdigital distinta. Questa è la configurazione consigliata per gli operatori multi-proprietà — catene alberghiere, catene di vendita al dettaglio, operatori di stadi — in cui è richiesta la segmentazione a livello di venue per marketing mirato, offerte localizzate o identità di brand separate.

Guida all'implementazione

Passaggio 1: Prepara il tuo account dotdigital

Prima di configurare il connettore Purple, completa le seguenti operazioni nel tuo account dotdigital. Vai su Impostazioni account e crea un nuovo utente API con un indirizzo email dedicato e una password sicura. Registra l'URL dell'endpoint API visualizzato nella parte superiore della pagina di accesso. Crea la rubrica o le rubriche che riceveranno i contatti Purple — si consiglia una per venue per le distribuzioni multi-proprietà. Facoltativamente, crea campi dati personalizzati in dotdigital se desideri acquisire attributi aggiuntivi oltre agli otto campi standard di Purple.

Passaggio 2: Configura il connettore Purple

All'interno della piattaforma Purple, vai su Gestione > Connettori. Individua il connettore dotdigital e seleziona Aggiungi. Completa i quattro campi richiesti: il nome del connettore (un'etichetta descrittiva di riferimento), l'email dell'API dotdigital, la password dell'API dotdigital e l'URL dell'endpoint dell'API dotdigital. Seleziona Verifica. Una volta completata la verifica con successo, apparirà un menu a discesa con l'elenco delle rubriche disponibili nel tuo account dotdigital. Seleziona la rubrica di destinazione e salva la configurazione.

Per le distribuzioni multi-venue, ripeti questo processo a livello di venue per ciascuna proprietà, assegnando ognuna alla rubrica designata.

Passaggio 3: Configura il meccanismo di consenso della Splash Page

La casella di controllo del consenso al marketing sulla tua splash page Purple è la porta d'accesso all'intera integrazione. Vai alla configurazione della tua splash page e assicurati che la casella di controllo per l'opt-in del marketing sia abilitata e chiaramente etichettata. Il linguaggio del consenso deve essere esplicito, specifico e inequivocabile ai sensi dell'Articolo 7 del GDPR del Regno Unito. Un esempio conforme: "Acconsento a ricevere comunicazioni di marketing da parte di [Nome dell'organizzazione] relative a offerte, eventi e novità. È possibile annullare l'iscrizione in qualsiasi momento." Non selezionare preventivamente questa casella di controllo.

Se il tuo programma di marketing include gli SMS, assicurati che la formula di consenso copra esplicitamente le comunicazioni via SMS. È consentita un'unica casella di controllo che copra sia l'email che gli SMS, purché il linguaggio sia chiaro.

Passaggio 4: Crea i tuoi programmi di automazione dotdigital

Distribuisci i programmi di automazione in dotdigital prima che il connettore diventi attivo. Come minimo, configura un programma di benvenuto attivato dall'aggiunta del contatto alla rubrica. Un percorso di benvenuto consigliato in tre fasi:

• Immediato (0 minuti): Email di benvenuto che conferma l'accesso al WiFi, con una presentazione con il brand della tua venue o dei tuoi servizi.
• Giorno 2 (48 ore): Email di follow-up con un'offerta pertinente, una guida alla venue o un contenuto personalizzato in base al contesto dell'ospite.
• Giorno 30 (re-engagement): Email di re-engagement automatizzata per i contatti che non sono tornati, con un incentivo a effettuare una nuova visita.

Per l'integrazione del programma fedeltà, utilizza il Program Builder di dotdigital per iscrivere i contatti che soddisfano criteri specifici, ad esempio i contatti che hanno risposto affermativamente a una domanda personalizzata della Captive Portal sull'interesse per il programma fedeltà.

Passaggio 5: Configura la sincronizzazione bidirezionale della soppressione

Configura un webhook di dotdigital per notificare Purple quando un contatto si disiscrive. Questo assicura che un contatto soppresso non venga aggiunto nuovamente a dotdigital al suo prossimo accesso al WiFi. Senza questo passaggio, l'integrazione è tecnicamente incompleta dal punto di vista della conformità al GDPR.

Passaggio 6: Convalida e vai live

Esegui un test end-to-end autenticando un dispositivo di test sul WiFi, completando la Captive Portal con un indirizzo email di test e il consenso al marketing, e verificando che il contatto appaia nella rubrica dotdigital corretta entro due o tre minuti. Conferma che il programma di automazione di benvenuto si attivi correttamente. Documenta i risultati del test e procedi con la distribuzione in produzione.

Best Practice

Architettura del consenso

La qualità del tuo database di contatti che hanno espresso il consenso è direttamente proporzionale all'architettura del consenso stessa. Le organizzazioni che investono in formule di consenso chiare e oneste — anche se ciò riduce marginalmente i tassi di opt-in — creano liste di contatti più attive e di maggior valore. Un tasso di opt-in del 30% derivante da un meccanismo di consenso trasparente supererà costantemente un tasso di opt-in del 60% derivante da uno ambiguo o fuorviante, perché il primo gruppo desidera realmente ricevere tue comunicazioni. Harrods ha ottenuto un tasso di opt-in del 38% da 581.000 utenti WiFi — un tasso coerente con un linguaggio di consenso trasparente basato sullo scambio di valore.

Tassonomia della rubrica

Progetta la struttura della tua rubrica dotdigital prima di connettere Purple. Per un gruppo alberghiero che gestisce 20 strutture, ciò potrebbe significare 20 rubriche specifiche per ciascuna sede, oltre a una rubrica principale consolidata per le campagne trasversali alle varie strutture. Per una catena di negozi, potrebbe significare rubriche segmentate per regione o formato di negozio. Il principio chiave è che la struttura della rubrica determina la tua capacità di segmentazione a valle — modificarla dopo che i dati sono stati raccolti è costoso e problematico.

Profondità del programma di automazione

Le implementazioni Purple-dotdigital più efficaci sfruttano l'intera gamma di programmi di dotdigital: percorsi di benvenuto, campagne di compleanno attivate dal campo dateOfBirth, sequenze di re-engagement per i contatti inattivi e sondaggi post-visita. Il campo postcode consente il targeting geografico per offerte localizzate. Il campo gender abilita la personalizzazione demografica. Il campo dateOfBirth consente la segmentazione per fasce d'età e l'attivazione dei trigger di compleanno. Utilizza tutti gli otto campi: rappresentano una ricca base di segmentazione che la maggior parte delle organizzazioni sottoutilizza.

Gestione della Deliverability

Monitora la dashboard di deliverability di dotdigital settimanalmente durante i primi 90 giorni dall'implementazione. Benchmark chiave: tasso di apertura superiore al 20%, tasso di clic superiore al 2%, frequenza di rimbalzo inferiore al 2%, tasso di disiscrizione inferiore allo 0,5%. Se le frequenze di rimbalzo sono elevate, implementa il workflow di double opt-in di dotdigital per verificare gli indirizzi email prima che entrino nel tuo database attivo. Questo è particolarmente rilevante per le location con un elevato traffico di passaggio, come aeroporti, stazioni ferroviarie e centri congressi, dove gli ospiti potrebbero inserire indirizzi email temporanei o errati.

Conformità GDPR e PECR

L'integrazione è progettata per essere conforme per impostazione predefinita, ma la conformità è una responsabilità condivisa. Purple impone il consenso a livello di acquisizione dei dati; dotdigital lo impone a livello di comunicazione. La tua organizzazione è responsabile del testo di consenso sulla splash page, del contenuto delle comunicazioni di marketing e del mantenimento delle liste di soppressione. Conduci una valutazione d'impatto sulla protezione dei dati (DPIA) prima di implementare l'integrazione nelle giurisdizioni coperte dal GDPR del Regno Unito o dal GDPR dell'UE, in particolare per le organizzazioni del settore pubblico soggette a obblighi aggiuntivi ai sensi del Data Protection Act 2018.

Risoluzione dei Problemi e Mitigazione dei Rischi

Errori di Verifica del Connettore

Il problema di implementazione più frequente. Nella maggior parte dei casi è causato da un URL dell'endpoint API errato. Risoluzione: accedi a dotdigital, vai su Impostazioni Account > Accesso e copia l'URL dell'endpoint esattamente come mostrato. Assicurati che non siano inclusi spazi vuoti o barre finali. Verifica che le credenziali dell'utente API si riferiscano a un account utente API dedicato e non all'accesso dell'account principale. Se la verifica non va a buon fine, conferma che l'account dotdigital abbia l'accesso API abilitato: questa è una funzionalità che potrebbe dover essere attivata dal supporto dotdigital per alcuni livelli di account.

Contatti che non Appaiono in dotdigital

Se il connettore viene verificato correttamente ma i contatti non appaiono nella rubrica di destinazione, la causa principale è la mancata abilitazione della casella di controllo del consenso marketing sulla splash page. Purple non trasmetterà i dati senza un consenso esplicito. Le cause secondarie includono la configurazione del connettore al livello errato (cliente rispetto a location) o la modifica dell'ID della rubrica dopo il salvataggio del connettore. Risoluzione: verificare la configurazione del consenso sulla splash page, confermare il livello del connettore e verificare nuovamente il connettore per aggiornare la selezione della rubrica.

Record di Contatto Duplicati

Si verifica quando lo stesso indirizzo email viene inviato in più sessioni WiFi, in genere in location ad alta affluenza. Risoluzione: assicurarsi che la rubrica di dotdigital sia configurata per aggiornare i contatti esistenti in caso di corrispondenza dell'indirizzo email, anziché creare nuovi record. Questa opzione è gestita all'interno delle impostazioni di importazione dei contatti di dotdigital. Inoltre, verificare se il connettore Purple è configurato sia a livello di cliente che di location per la stessa location: una doppia configurazione comporterà invii duplicati.

Campi Dati Mancanti

Se i contatti appaiono in dotdigital ma alcuni campi sono vuoti, la causa più probabile è che gli ospiti non abbiano compilato tali campi sulla splash page. Purple trasmette solo i campi forniti durante l'autenticazione. Per i campi facoltativi come il numero di cellulare o la data di nascita, alcuni ospiti decideranno di non fornirli. Se la completezza di campi specifici è fondamentale per la vostra strategia di segmentazione, valutate l'opportunità di rendere obbligatori tali campi sulla splash page, tenendo presente però che ogni campo obbligatorio aggiuntivo ridurrà il tasso di conversione complessivo delle iscrizioni.

Mancato Rispetto della Soppressione GDPR

Se i contatti disiscritti vengono aggiunti nuovamente a dotdigital ai successivi accessi WiFi, significa che il webhook di soppressione bidirezionale non è stato configurato. Questo rappresenta un rischio di conformità. Risoluzione: configurare un webhook di dotdigital che si attivi in caso di eventi di disiscrizione e aggiorni il record del contatto corrispondente in Purple. Consultare la documentazione per sviluppatori di dotdigital per indicazioni sulla configurazione del webhook.

Framework di Mitigazione dei Rischi

ROI e Impatto Aziendale

Misurare il Successo

L'integrazione Purple-dotdigital offre valore su due dimensioni distinte: la crescita del database e l'attribuzione dei ricavi. La crescita del database si misura in base al numero di nuovi contatti opt-in aggiunti al mese, al tasso di opt-in come percentuale delle autenticazioni WiFi totali e al tasso di completezza dei dati di contatto (percentuale di contatti con tutti gli otto campi compilati). L'attribuzione dei ricavi si misura tracciando gli acquisti, le iscrizioni ai programmi fedeltà o altri eventi di conversione che possono essere collegati ai contatti entrati nel database tramite l'accesso WiFi.

La suite di reportistica di dotdigital fornisce analisi a livello di campagna — tassi di apertura, tassi di clic, tassi di conversione — utilizzabili per calcolare il contributo ai ricavi di ciascun programma di automazione. La dashboard analitica di Purple fornisce i dati sulle presenze fisiche e sull'autenticazione necessari per calcolare il costo per contatto acquisito.

Benchmark e Risultati Previsti

In base alle implementazioni documentate all'interno dell'ecosistema Purple:

Considerazioni sui Costi-Benefici

Il costo marginale del connettore dotdigital all'interno di Purple è basso rispetto al potenziale di ricavo. L'investimento principale risiede nella progettazione del programma e nella creazione dei contenuti — i percorsi di automazione, i template email e le logiche di segmentazione che determinano l'efficacia con cui il database dei contatti viene monetizzato. Le organizzazioni che considerano l'integrazione come un semplice flusso di dati da impostare e dimenticare otterranno ritorni modesti. Quelle che investono nell'ottimizzazione continua del programma — effettuando A/B test sulle righe dell'oggetto, perfezionando la segmentazione, estendendo la profondità dell'automazione — vedranno ritorni in linea con i benchmark di Harrods e AGS Airports documentati sopra.

Una regola pratica: per ogni 10.000 contatti opt-in acquisiti tramite WiFi, un programma dotdigital ben configurato dovrebbe generare ricavi incrementali misurabili entro 90 giorni dall'implementazione, ipotizzando un tasso di apertura minimo del 20% e un tasso di clic del 2% sulla serie di benvenuto.