dotdigital (पूर्व में Dotmailer): Purple AI यूज़र्स के लिए इंटीग्रेशन गाइड, सर्वोत्तम कार्यप्रणालियाँ और समस्या निवारण

This guide provides Purple AI users — particularly IT managers, network architects, and CTOs at hotels, retail chains, stadiums, and conference centres — with a definitive technical reference for deploying and optimising the dotdigital (formerly Dotmailer) connector. It covers the end-to-end integration architecture, step-by-step configuration, GDPR-compliant data handling, automation programme design, and a structured troubleshooting framework. Organisations that implement this integration correctly convert guest WiFi logins into a high-value, consent-gated marketing database that drives measurable revenue outcomes.

📖 11 min read📝 2,662 words🔧 2 examples4 questions📚 10 key terms

🎧 Listen to this Guide

View Transcript
Welcome to the Purple Intelligence Briefing. I'm your host, and today we're getting into the practical detail of one of the most commonly deployed connectors in the Purple ecosystem — dotdigital, formerly known as Dotmailer. If you're an IT manager, a network architect, or a CTO responsible for a hotel group, a retail estate, a stadium, or a conference centre, this episode is built for you. Over the next ten minutes, we're going to cover exactly what this integration does, how to set it up correctly, the best practices that separate a high-performing deployment from a mediocre one, and the troubleshooting scenarios that trip up even experienced teams. Let's get into it. [SECTION: CONTEXT AND WHY THIS MATTERS] First, let's establish what we're actually talking about. Purple is an enterprise guest WiFi intelligence platform. When a visitor connects to your WiFi — whether they're checking in at a hotel, browsing a retail floor, or arriving at a conference centre — Purple's captive portal captures their consent and profile data. That data is the raw material for everything that follows. dotdigital is a cross-channel marketing automation platform. It handles email, SMS, push notifications, WhatsApp, and more. It's used by retailers, hospitality brands, and enterprise organisations to run sophisticated, personalised marketing programmes at scale. The Purple-dotdigital connector bridges these two systems. The moment a guest authenticates on your WiFi and opts in to marketing communications, Purple pushes their profile data — name, email, mobile number, postcode, date of birth, gender — directly into a dotdigital address book. From there, dotdigital's automation engine takes over, triggering welcome journeys, re-engagement campaigns, loyalty programme invitations, and much more. The commercial case is compelling. Harrods, the luxury London retailer, built a database of 3.6 million contacts through this kind of WiFi-driven data capture. In a single twelve-month period, 581,000 unique individuals logged on to their in-store WiFi. Of those, 38 percent — over 220,000 people — opted in to marketing. The downstream revenue from that opted-in cohort represented a 54 times return on their Purple investment. That's not a theoretical projection. That's a documented outcome. [SECTION: TECHNICAL DEEP-DIVE] Now let's talk architecture. The integration is a server-to-server API connection. Purple acts as the data producer; dotdigital acts as the consumer. Authentication uses dotdigital's standard Basic Auth mechanism — an API user account with a dedicated email address and password, paired with a region-specific API endpoint. The endpoint matters. dotdigital operates across multiple regional data centres, and your API endpoint will be specific to your account's region. You retrieve this from Account Settings, then Access, within the dotdigital platform. Getting this wrong is the single most common cause of connector verification failures, so it's worth double-checking before you begin. Within Purple, the connector is configured under Management, then Connectors. You can deploy it at two levels: customer level, which applies the connector across your entire Purple account, or venue level, which allows you to route different venues to different dotdigital address books. For a hotel group with multiple properties, venue-level configuration is almost always the right choice — it gives you clean segmentation from the outset. The data payload that Purple sends to dotdigital on each new authenticated user includes eight fields: first name, last name, user ID, email address, mobile number, gender, postcode, and date of birth. Critically — and this is non-negotiable from a GDPR standpoint — data is only transmitted when the user has explicitly consented to receive marketing communications. Purple enforces this at the splash page level; no consent, no data push. On the dotdigital side, contacts land in the address book you specify during connector setup. From there, you can enrol them in automation programmes — what dotdigital calls Programs. A well-designed welcome programme might send an immediate confirmation email, follow up with a venue guide or offer 24 hours later, and then trigger a re-engagement campaign if the contact hasn't returned within 30 days. All of this is configurable within dotdigital's Program Builder without any additional development work. For organisations with more complex requirements, dotdigital's API supports custom data fields, contact scoring, event-based triggers, and webhook callbacks. If you're running a loyalty programme — as Harrods does — you can use the splash page's custom question feature to capture intent, then pass that signal through to dotdigital for segmentation. The contact's WiFi login data pre-populates your loyalty sign-up form, removing friction and significantly improving conversion rates. From a compliance standpoint, both platforms carry strong credentials. Purple is GDPR and CCPA compliant by design. dotdigital operates as a data processor under GDPR, with documented technical and organisational measures in place. The integration supports double opt-in workflows, consent tracking, and suppression list management — all of which are essential for organisations operating across UK and EU jurisdictions. [SECTION: IMPLEMENTATION RECOMMENDATIONS AND PITFALLS] Let me give you the practical recommendations that make the difference between a deployment that delivers return on investment and one that sits idle. First: plan your address book taxonomy before you connect anything. In dotdigital, address books are your primary segmentation layer. If you're operating multiple venues, create a dedicated address book per venue, or at minimum per venue category — hotels, restaurants, retail. Retrofitting this structure after thousands of contacts have been imported is painful and error-prone. Second: configure your splash page marketing consent checkbox carefully. The wording matters both for conversion rates and for legal compliance. Under UK GDPR and the Privacy and Electronic Communications Regulations, consent must be freely given, specific, informed, and unambiguous. A pre-ticked checkbox does not meet this standard. Purple's splash page builder gives you full control over this language — use it deliberately. Third: build your automation programmes before you go live with the connector. There's no value in collecting opted-in contacts if they sit in an address book with no programme attached. At minimum, deploy a three-step welcome journey: an immediate welcome email confirming their WiFi access, a follow-up with a relevant offer or content piece 48 hours later, and a re-engagement trigger at 30 days for contacts who haven't returned. Fourth: monitor your deliverability metrics from day one. dotdigital provides detailed reporting on open rates, click-through rates, bounces, and unsubscribes. A bounce rate above two percent or an unsubscribe rate above 0.5 percent on a welcome series is a signal that either your consent language is misleading or your email content isn't meeting expectations. Address this early — inbox providers use engagement signals to determine whether your domain ends up in the inbox or the spam folder. Fifth: implement the dotdigital unsubscribe webhook back to Purple. When a contact unsubscribes in dotdigital, that suppression should be reflected in Purple's records. Without this bidirectional sync, you risk re-adding a suppressed contact to dotdigital on their next WiFi login — a GDPR compliance risk and a fast route to deliverability problems. Now, the pitfalls. The most common issue we see is connector verification failures caused by incorrect API endpoint URLs. Always retrieve the endpoint directly from your dotdigital account — do not guess or copy from documentation examples. The second most common issue is contacts not appearing in dotdigital despite successful connector setup. In almost every case, this traces back to the marketing consent checkbox not being enabled on the splash page. Check this first. The third issue is duplicate contacts, which occurs when the same email address is submitted across multiple WiFi sessions. dotdigital handles this through its deduplication logic, but you need to ensure that your address book settings are configured to merge on email address rather than create new records. [SECTION: RAPID-FIRE Q&A] Let me run through some of the questions we hear most frequently. Can I connect multiple venues to different dotdigital address books? Yes. Configure the connector at venue level within Purple's Management section, and assign each venue to its own address book in dotdigital. Does the integration support SMS as well as email? The data payload includes mobile number, so yes — once the contact is in dotdigital, you can use their mobile number for SMS campaigns through dotdigital's SMS channel. Ensure you have the appropriate consent language on your splash page to cover SMS marketing. What happens if a guest connects but doesn't opt in to marketing? Purple captures the session data for analytics purposes, but does not push any personal data to dotdigital. The guest's visit contributes to your footfall and dwell time analytics within Purple, but they do not enter your marketing database. Is the integration real-time? Yes. The data push to dotdigital occurs at the point of WiFi authentication, not in batches. This means a welcome email can be triggered within minutes of a guest connecting — which is a significant advantage for time-sensitive offers. [SECTION: SUMMARY AND NEXT STEPS] Let me close with the key points to take away from this briefing. The Purple-dotdigital integration is a production-ready, consent-gated data pipeline that converts WiFi logins into addressable marketing contacts. The setup is straightforward — four configuration fields and a connector verification — but the value is determined entirely by what you build on top of it in dotdigital. The organisations that extract the most value are those that invest in address book taxonomy, automation programme design, and deliverability management before they go live. The Harrods example — 54 times return on investment from a WiFi-driven email programme — is achievable, but it requires deliberate programme design, not just a connected API. Your immediate next steps: audit your dotdigital account structure, define your address book taxonomy, draft your welcome automation programme, and review your splash page consent language. Then connect the integration, verify it, and go live. If you need to go deeper on any of these areas, the Purple support documentation covers the connector configuration in detail, and dotdigital's developer hub provides full API reference documentation for teams building custom integrations. Thank you for listening to the Purple Intelligence Briefing. We'll be back with more technical guidance for venue operators and IT teams shortly.

header_image.png

कार्यकारी सारांश (Executive Summary)

Purple AI प्लेटफ़ॉर्म होटल, रिटेल एस्टेट, स्टेडियम और सार्वजनिक क्षेत्र के स्थानों पर WiFi ऑथेंटिकेशन के समय फ़र्स्ट-पार्टी गेस्ट डेटा कैप्चर करता है। dotdigital कनेक्टर — जिसे पहले Dotmailer के नाम से जाना जाता था — उस रॉ डेटा कैप्चर को प्रोडक्शन-ग्रेड मार्केटिंग ऑटोमेशन पाइपलाइन में बदल देता है। जब कोई गेस्ट आपके WiFi से कनेक्ट होता है और मार्केटिंग संचार के लिए सहमति देता है, तो Purple उनके प्रोफ़ाइल को रीयल-टाइम में एक निर्दिष्ट dotdigital एड्रेस बुक में पुश कर देता है। उस क्षण से, dotdigital का ऑटोमेशन इंजन ईमेल, SMS और पुश के माध्यम से वेलकम जर्नी, लॉयल्टी प्रोग्राम आमंत्रण, री-एंगेजमेंट अभियान और ओमनीचैनल संचार को ट्रिगर कर सकता है。

इसका व्यावसायिक लाभ अच्छी तरह से प्रमाणित है। Harrods ने WiFi-संचालित डेटा कैप्चर के माध्यम से 3.6 मिलियन-संपर्कों का डेटाबेस बनाया और एक ही वर्ष के भीतर अपने Purple निवेश पर 54 गुना रिटर्न प्राप्त किया। AGS Airports ने 842% ROI प्रदान किया। Brussels South Charleroi Airport ने डाउनस्ट्रीम मार्केटिंग ऑटोमेशन के साथ Purple के MicroSurveys का उपयोग करके 10,630% ROI दर्ज किया। ये परिणाम असाधारण नहीं हैं — ये एक सुविचारित प्रोग्राम डिज़ाइन के साथ डिप्लॉय किए गए अच्छी तरह से कॉन्फ़िगर किए गए इंटीग्रेशन के अपेक्षित परिणाम हैं।

यह गाइड एंटरप्राइज़ स्तर पर Purple-dotdigital इंटीग्रेशन को डिप्लॉय, ऑप्टिमाइज़ और समस्या निवारण (troubleshoot) करने के लिए आवश्यक तकनीकी गहराई प्रदान करती है। इसे उन IT पेशेवरों के लिए तैयार किया गया है जिन्हें अगले साल मूल्यांकन करने के बजाय इसी तिमाही में समाधान लागू करने की आवश्यकता है।


integration_architecture.png

तकनीकी डीप-डाइव

इंटीग्रेशन आर्किटेक्चर

Purple-dotdigital कनेक्टर सर्वर-टू-सर्वर REST API इंटीग्रेशन के रूप में कार्य करता है। Purple डेटा प्रोड्यूसर के रूप में कार्य करता है, और dotdigital कंज़्यूमर के रूप में कार्य करता है। कनेक्शन को dotdigital के बेसिक ऑथेंटिकेशन (Basic Auth) तंत्र का उपयोग करके प्रमाणित किया जाता है: dotdigital प्लेटफ़ॉर्म के भीतर बनाया गया एक समर्पित API यूज़र अकाउंट (ईमेल पता और पासवर्ड), जिसे क्षेत्र-विशिष्ट API एंडपॉइंट URL के साथ जोड़ा जाता है।

आर्किटेक्चर डिफ़ॉल्ट रूप से यूनिडायरेक्शनल (एकतरफ़ा) है — Purple WiFi ऑथेंटिकेशन के समय संपर्क रिकॉर्ड को dotdigital में पुश करता है। जिन संगठनों को द्विदिशीय (bidirectional) सिंक्रोनाइज़ेशन की आवश्यकता होती है (उदाहरण के लिए, अनसब्सक्राइब या सप्रेशन लिस्ट अपडेट को वापस Purple में दर्शाने के लिए), उन्हें dotdigital के वेबहुक फ़्रेमवर्क के माध्यम से अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता होती है।

घटक (Component) भूमिका (Role) नोट्स (Notes)
Purple Captive Portal गेस्ट ऑथेंटिकेशन और सहमति कैप्चर WiFi लॉगिन पर प्रस्तुत स्प्लैश पेज
Purple Connector Engine डेटा ट्रांसफ़ॉर्मेशन और API डिस्पैच Management > Connectors के अंतर्गत कॉन्फ़िगर किया गया
dotdigital REST API संपर्क अंतर्ग्रहण (ingestion) और एड्रेस बुक प्रबंधन क्षेत्र-विशिष्ट एंडपॉइंट आवश्यक
dotdigital Address Book संपर्क स्टोरेज और सेगमेंटेशन लेयर प्रति वेन्यू/प्रॉपर्टी एक या अधिक बुक
dotdigital Program Builder ऑटोमेशन प्रोग्राम निष्पादन एड्रेस बुक में संपर्क जोड़े जाने पर ट्रिगर होता है

डेटा पेलोड और फ़ील्ड मैपिंग

Purple प्रत्येक सहमति देने वाले गेस्ट के लिए dotdigital को आठ डेटा फ़ील्ड ट्रांसमिट करता है। ये फ़ील्ड सीधे dotdigital के मानक संपर्क डेटा मॉडल से मैप होते हैं और बुनियादी डिप्लॉयमेंट के लिए कस्टम फ़ील्ड कॉन्फ़िगरेशन की आवश्यकता नहीं होती है।

फ़ील्ड का नाम डेटा प्रकार विवरण
firstName String गेस्ट का पहला नाम
lastName String गेस्ट का उपनाम
userID Integer Purple का आंतरिक यूज़र आइडेंटिफ़ायर
email String प्राथमिक संपर्क पता; डिडुप्लीकेशन कुंजी के रूप में उपयोग किया जाता है
mobile String मोबाइल टेलीफ़ोन नंबर (E.164 फ़ॉर्मेट अनुशंसित)
gender String स्प्लैश पेज से स्व-घोषित लिंग
postcode String पोस्टल कोड; भौगोलिक सेगमेंटेशन सक्षम करता है
dateOfBirth String फ़ॉर्मेट: YYYY-MM-DD; आयु-वर्ग सेगमेंटेशन और जन्मदिन ट्रिगर सक्षम करता है

डेटा ट्रांसमिशन प्लेटफ़ॉर्म स्तर पर सहमति-गेटेड (consent-gated) है। Purple तब तक dotdigital को संपर्क रिकॉर्ड नहीं भेजेगा जब तक कि गेस्ट ने स्प्लैश पेज सहमति चेकबॉक्स के माध्यम से मार्केटिंग संचार के लिए स्पष्ट रूप से ऑप्ट-इन न किया हो। यह एक सख्त प्रवर्तन (hard enforcement) है — कोई कॉन्फ़िगर करने योग्य विकल्प नहीं — और यह वह प्राथमिक तंत्र है जिसके द्वारा इंटीग्रेशन UK GDPR, EU जनरल डेटा प्रोटेक्शन रेगुलेशन (GDPR) और CCPA के साथ अनुपालन बनाए रखता है।

ऑथेंटिकेशन और एंडपॉइंट कॉन्फ़िगरेशन

dotdigital अपने REST API के लिए HTTP बेसिक ऑथेंटिकेशन का उपयोग करता है। क्रेडेंशियल्स में एक API यूज़र ईमेल पता और पासवर्ड शामिल होता है, जिसे dotdigital अकाउंट के भीतर एक समर्पित यूज़र के रूप में बनाया जाना चाहिए — न कि प्राथमिक अकाउंट लॉगिन के रूप में। API एंडपॉइंट URL अकाउंट-विशिष्ट और क्षेत्र-निर्भर है। इसे dotdigital प्लेटफ़ॉर्म के भीतर Account Settings > Access से प्राप्त किया जाता है। एक सामान्य एंडपॉइंट क्षेत्र एक (region one) अकाउंट्स के लिए https://r1-api.dotdigital.com का रूप लेता है।

यह एंडपॉइंट विशिष्टता कनेक्टर सत्यापन विफलताओं का सबसे आम स्रोत है। जो टीमें जेनेरिक या दस्तावेज़ीकरण-उदाहरण URL का उपयोग करने का प्रयास करती हैं, उन्हें ऑथेंटिकेशन त्रुटियों का सामना करना पड़ेगा। हमेशा उपयोग में आने वाले dotdigital अकाउंट से सीधे एंडपॉइंट वैल्यू प्राप्त करें।

कनेक्टर डिप्लॉयमेंट स्तर

Purple dotdigital कनेक्टर के लिए दो डिप्लॉयमेंट स्तरों का समर्थन करता है:

ग्राहक स्तर (Customer level) पूरे Purple अकाउंट में कनेक्टर कॉन्फ़िगरेशन लागू करता है, जो सभी वेन्यू से सभी सहमति देने वाले गेस्ट्स को एक ही dotdigital एड्रेस बुक में रूट करता है। यह सिंगल-वेन्यू ऑपरेटरों या समरूप वेन्यू एस्टेट वाले संगठनों के लिए उपयुक्त है।

वेन्यू स्तर (Venue level) प्रत्येक व्यक्तिगत वेन्यू को एक अलग dotdigital एड्रेस बुक में मैप करने की अनुमति देता है। यह मल्टी-प्रॉपर्टी ऑपरेटरों — होटल समूहों, रिटेल चेन, स्टेडियम ऑपरेटरों — के लिए अनुशंसित कॉन्फ़िगरेशन है, जहाँ लक्षित मार्केटिंग, स्थानीयकृत ऑफ़र या अलग ब्रांड पहचान के लिए वेन्यू-स्तर के सेगमेंटेशन की आवश्यकता होती है।


कार्यान्वयन गाइड (Implementation Guide)

चरण 1: अपना dotdigital अकाउंट तैयार करें

Purple कनेक्टर को कॉन्फ़िगर करने से पहले, अपने dotdigital अकाउंट में निम्नलिखित कार्य पूरे करें। Account Settings पर जाएँ और एक समर्पित ईमेल पते और एक मज़बूत पासवर्ड के साथ एक नया API यूज़र बनाएँ। Access पेज के शीर्ष पर प्रदर्शित API एंडपॉइंट URL को रिकॉर्ड करें। वह एड्रेस बुक या बुक्स बनाएँ जो Purple संपर्क प्राप्त करेंगी — मल्टी-प्रॉपर्टी डिप्लॉयमेंट के लिए प्रति वेन्यू एक की अनुशंसा की जाती है। वैकल्पिक रूप से, यदि आप आठ मानक Purple फ़ील्ड्स के अलावा अतिरिक्त एट्रिब्यूट्स कैप्चर करने का इरादा रखते हैं, तो dotdigital में कस्टम डेटा फ़ील्ड बनाएँ।

चरण 2: Purple कनेक्टर कॉन्फ़िगर करें

Purple प्लेटफ़ॉर्म के भीतर, Management > Connectors पर जाएँ। dotdigital कनेक्टर ढूँढें और Add चुनें। चार आवश्यक फ़ील्ड पूरे करें: कनेक्टर का नाम (आपके संदर्भ के लिए एक वर्णनात्मक लेबल), dotdigital API ईमेल, dotdigital API पासवर्ड, और dotdigital API एंडपॉइंट URL। Verify चुनें। सफल सत्यापन पर, आपके dotdigital अकाउंट में उपलब्ध एड्रेस बुक्स को सूचीबद्ध करने वाला एक ड्रॉपडाउन दिखाई देगा। लक्ष्य एड्रेस बुक चुनें और कॉन्फ़िगरेशन सहेजें।

मल्टी-वेन्यू डिप्लॉयमेंट के लिए, प्रत्येक प्रॉपर्टी के लिए वेन्यू स्तर पर इस प्रक्रिया को दोहराएँ, और प्रत्येक को उसकी निर्दिष्ट एड्रेस बुक में असाइन करें।

चरण 3: स्प्लैश पेज सहमति तंत्र कॉन्फ़िगर करें

आपके Purple स्प्लैश पेज पर मार्केटिंग सहमति चेकबॉक्स संपूर्ण इंटीग्रेशन का प्रवेश द्वार है। अपने स्प्लैश पेज कॉन्फ़िगरेशन पर जाएँ और सुनिश्चित करें कि मार्केटिंग ऑप्ट-इन चेकबॉक्स सक्षम है और स्पष्ट रूप से लेबल किया गया है। UK GDPR अनुच्छेद 7 के तहत सहमति की भाषा स्पष्ट, विशिष्ट और असंदिग्ध होनी चाहिए। एक अनुपालन उदाहरण: "मैं ऑफ़र, ईवेंट और समाचारों के बारे में [संगठन का नाम] से मार्केटिंग संचार प्राप्त करने के लिए सहमत हूँ। आप किसी भी समय अनसब्सक्राइब कर सकते हैं।" इस चेकबॉक्स को पहले से टिक (pre-tick) न करें।

यदि आपके मार्केटिंग प्रोग्राम में SMS शामिल है, तो सुनिश्चित करें कि सहमति की भाषा स्पष्ट रूप से SMS संचार को कवर करती है। ईमेल और SMS दोनों को कवर करने वाला एक एकल चेकबॉक्स स्वीकार्य है बशर्ते भाषा स्पष्ट हो।

चरण 4: अपने dotdigital ऑटोमेशन प्रोग्राम बनाएँ

कनेक्टर के लाइव होने से पहले dotdigital में ऑटोमेशन प्रोग्राम डिप्लॉय करें। कम से कम, एड्रेस बुक में संपर्क जोड़े जाने पर ट्रिगर होने वाला एक वेलकम प्रोग्राम कॉन्फ़िगर करें। एक अनुशंसित तीन-चरणीय वेलकम जर्नी:

  • तत्काल (0 मिनट): WiFi एक्सेस की पुष्टि करने वाला वेलकम ईमेल, जिसमें आपके वेन्यू या सेवाओं का ब्रांडेड परिचय हो।
  • दिन 2 (48 घंटे): गेस्ट के संदर्भ के अनुरूप प्रासंगिक ऑफ़र, वेन्यू गाइड या कंटेंट पीस के साथ फ़ॉलो-अप ईमेल।
  • दिन 30 (री-एंगेजमेंट): जो संपर्क वापस नहीं आए हैं, उनके लिए फिर से आने के प्रोत्साहन के साथ स्वचालित री-एंगेजमेंट ईमेल।

लॉयल्टी प्रोग्राम इंटीग्रेशन के लिए, विशिष्ट मानदंडों को पूरा करने वाले संपर्कों को नामांकित करने के लिए dotdigital के Program Builder का उपयोग करें — उदाहरण के लिए, वे संपर्क जिन्होंने लॉयल्टी प्रोग्राम में रुचि के बारे में कस्टम स्प्लैश पेज प्रश्न का सकारात्मक उत्तर दिया।

चरण 5: द्विदिशीय (Bidirectional) सप्रेशन सिंक कॉन्फ़िगर करें

जब कोई संपर्क अनसब्सक्राइब करता है तो Purple को सूचित करने के लिए एक dotdigital वेबहुक कॉन्फ़िगर करें। यह सुनिश्चित करता है कि एक सप्रेस्ड संपर्क उनके अगले WiFi लॉगिन पर dotdigital में फिर से न जोड़ा जाए। इस चरण के बिना, GDPR अनुपालन के दृष्टिकोण से इंटीग्रेशन तकनीकी रूप से अधूरा है।

चरण 6: मान्य करें और लाइव करें

WiFi पर एक परीक्षण डिवाइस को प्रमाणित करके, परीक्षण ईमेल पते और मार्केटिंग सहमति के साथ स्प्लैश पेज को पूरा करके, और यह सत्यापित करके कि संपर्क दो से तीन मिनट के भीतर सही dotdigital एड्रेस बुक में दिखाई देता है, एक एंड-टू-एंड परीक्षण आयोजित करें। पुष्टि करें कि वेलकम ऑटोमेशन प्रोग्राम सही ढंग से ट्रिगर होता है। परीक्षण परिणामों का दस्तावेज़ीकरण करें और प्रोडक्शन डिप्लॉयमेंट के लिए आगे बढ़ें।


best_practices_infographic.png

सर्वोत्तम कार्यप्रणालियाँ (Best Practices)

सहमति आर्किटेक्चर

आपके ऑप्ट-इन डेटाबेस की गुणवत्ता सीधे आपके सहमति आर्किटेक्चर पर निर्भर करती है। जो संगठन स्पष्ट, ईमानदार सहमति भाषा में निवेश करते हैं — भले ही यह ऑप्ट-इन दरों को मामूली रूप से कम कर दे — वे अधिक एंगेज्ड, उच्च-मूल्य वाली संपर्क सूचियाँ बनाते हैं। पारदर्शी सहमति तंत्र से 30% ऑप्ट-इन दर लगातार अस्पष्ट या भ्रामक तंत्र से 60% ऑप्ट-इन दर से बेहतर प्रदर्शन करेगी, क्योंकि पहला समूह वास्तव में आपसे सुनना चाहता है। Harrods ने 581,000 WiFi यूज़र्स से 38% ऑप्ट-इन दर हासिल की — जो पारदर्शी, मूल्य-विनिमय सहमति भाषा के अनुरूप दर है。

एड्रेस बुक टैक्सोनॉमी

Purple को कनेक्ट करने से पहले अपने dotdigital एड्रेस बुक स्ट्रक्चर को डिज़ाइन करें। 20 संपत्तियों का संचालन करने वाले होटल समूह के लिए, इसका मतलब 20 वेन्यू-विशिष्ट एड्रेस बुक्स, साथ ही क्रॉस-प्रॉपर्टी अभियानों के लिए एक मास्टर समेकित बुक हो सकता है। एक रिटेल चेन के लिए, इसका मतलब क्षेत्र या स्टोर फ़ॉर्मेट द्वारा सेगमेंट की गई बुक्स हो सकता है। मुख्य सिद्धांत यह है कि एड्रेस बुक स्ट्रक्चर आपकी डाउनस्ट्रीम सेगमेंटेशन क्षमता को निर्धारित करता है — डेटा एकत्र होने के बाद इसे रेट्रोफ़िट करना महँगा और विघटनकारी होता है।

ऑटोमेशन प्रोग्राम की गहराई

सबसे प्रभावी Purple-dotdigital डिप्लॉयमेंट dotdigital की पूर्ण प्रोग्राम क्षमता का उपयोग करते हैं: वेलकम जर्नी, dateOfBirth फ़ील्ड द्वारा ट्रिगर किए गए जन्मदिन अभियान, निष्क्रिय संपर्कों के लिए री-एंगेजमेंट अनुक्रम, और पोस्ट-विज़िट सर्वेक्षण। postcode फ़ील्ड स्थानीयकृत ऑफ़र के लिए भौगोलिक लक्ष्यीकरण को सक्षम बनाता है। gender फ़ील्ड जनसांख्यिकीय वैयक्तिकरण को सक्षम बनाता है। dateOfBirth फ़ील्ड आयु-वर्ग सेगमेंटेशन और जन्मदिन ट्रिगर को सक्षम बनाता है। सभी आठ फ़ील्ड्स का उपयोग करें — वे एक समृद्ध सेगमेंटेशन आधार का प्रतिनिधित्व करते हैं जिसका अधिकांश संगठन कम उपयोग करते हैं।

डिलीवरेबिलिटी प्रबंधन

डिप्लॉयमेंट के पहले 90 दिनों के दौरान साप्ताहिक रूप से dotdigital के डिलीवरेबिलिटी डैशबोर्ड की निगरानी करें। प्रमुख बेंचमार्क: ओपन रेट 20% से ऊपर, क्लिक-थ्रू रेट 2% से ऊपर, बाउंस रेट 2% से नीचे, अनसब्सक्राइब रेट 0.5% से नीचे। यदि बाउंस रेट अधिक हैं, तो ईमेल पतों को आपके सक्रिय डेटाबेस में प्रवेश करने से पहले सत्यापित करने के लिए dotdigital के डबल ऑप्ट-इन वर्कफ़्लो को लागू करें। यह विशेष रूप से उच्च अस्थायी फ़ुटफ़ॉल वाले स्थानों — हवाई अड्डों, रेलवे स्टेशनों, सम्मेलन केंद्रों — के लिए प्रासंगिक है, जहाँ गेस्ट अस्थायी या गलत ईमेल पते दर्ज कर सकते हैं।

GDPR और PECR अनुपालन

इंटीग्रेशन को डिफ़ॉल्ट रूप से अनुपालन करने के लिए डिज़ाइन किया गया है, लेकिन अनुपालन एक साझा ज़िम्मेदारी है। Purple डेटा कैप्चर लेयर पर सहमति लागू करता है; dotdigital इसे संचार लेयर पर लागू करता है। आपका संगठन स्प्लैश पेज पर सहमति भाषा, मार्केटिंग संचार की सामग्री और सप्रेशन सूचियों के रखरखाव के लिए ज़िम्मेदार है। UK GDPR या EU GDPR द्वारा कवर किए गए अधिकार क्षेत्रों में इंटीग्रेशन को डिप्लॉय करने से पहले डेटा प्रोटेक्शन इम्पैक्ट असेसमेंट (DPIA) आयोजित करें, विशेष रूप से डेटा प्रोटेक्शन एक्ट 2018 के तहत अतिरिक्त दायित्वों के अधीन सार्वजनिक क्षेत्र के संगठनों के लिए।


troubleshooting_guide.png

समस्या निवारण (Troubleshooting) और जोखिम न्यूनीकरण

कनेक्टर सत्यापन विफलताएँ

सबसे लगातार डिप्लॉयमेंट समस्या। अधिकांश मामलों में गलत API एंडपॉइंट URL के कारण होता है। समाधान: dotdigital में लॉग इन करें, Account Settings > Access पर जाएँ, और एंडपॉइंट URL को ठीक वैसे ही कॉपी करें जैसे वह प्रदर्शित होता है। सुनिश्चित करें कि कोई ट्रेलिंग स्लैश या व्हाइटस्पेस शामिल नहीं है। सत्यापित करें कि API यूज़र क्रेडेंशियल्स एक समर्पित API यूज़र अकाउंट के लिए हैं, न कि प्राथमिक अकाउंट लॉगिन के लिए। यदि सत्यापन अभी भी विफल रहता है, तो पुष्टि करें कि dotdigital अकाउंट में API एक्सेस सक्षम है — यह एक ऐसी सुविधा है जिसे कुछ अकाउंट टियर्स के लिए dotdigital सपोर्ट द्वारा सक्रिय करने की आवश्यकता हो सकती है।

dotdigital में संपर्क दिखाई नहीं दे रहे हैं

यदि कनेक्टर सफलतापूर्वक सत्यापित हो जाता है लेकिन संपर्क लक्ष्य एड्रेस बुक में दिखाई नहीं दे रहे हैं, तो प्राथमिक कारण स्प्लैश पेज पर मार्केटिंग सहमति चेकबॉक्स का सक्षम न होना है। Purple स्पष्ट सहमति के बिना डेटा ट्रांसमिट नहीं करेगा। द्वितीयक कारणों में कनेक्टर का गलत स्तर (ग्राहक बनाम वेन्यू) पर कॉन्फ़िगर होना, या कनेक्टर सहेजे जाने के बाद से एड्रेस बुक ID का बदल जाना शामिल है। समाधान: स्प्लैश पेज सहमति कॉन्फ़िगरेशन सत्यापित करें, कनेक्टर स्तर की पुष्टि करें, और एड्रेस बुक चयन को रीफ़्रेश करने के लिए कनेक्टर को फिर से सत्यापित करें।

डुप्लिकेट संपर्क रिकॉर्ड

तब होता है जब एक ही ईमेल पता कई WiFi सत्रों में सबमिट किया जाता है, आमतौर पर उच्च-फ़ुटफ़ॉल वाले स्थानों में। समाधान: सुनिश्चित करें कि dotdigital की एड्रेस बुक नए रिकॉर्ड बनाने के बजाय ईमेल पते के मिलान पर मौजूदा संपर्कों को अपडेट करने के लिए कॉन्फ़िगर की गई है। इसे dotdigital की संपर्क आयात सेटिंग्स के भीतर नियंत्रित किया जाता है। इसके अतिरिक्त, समीक्षा करें कि क्या Purple कनेक्टर एक ही वेन्यू के लिए ग्राहक और वेन्यू दोनों स्तरों पर कॉन्फ़िगर किया गया है — दोहरे कॉन्फ़िगरेशन के परिणामस्वरूप डुप्लिकेट पुश होंगे।

गुम डेटा फ़ील्ड्स

यदि संपर्क dotdigital में दिखाई देते हैं लेकिन कुछ फ़ील्ड खाली हैं, तो सबसे संभावित कारण यह है कि गेस्ट्स ने स्प्लैश पेज पर उन फ़ील्ड्स को पूरा नहीं किया। Purple केवल वे फ़ील्ड ट्रांसमिट करता है जो ऑथेंटिकेशन के दौरान प्रदान किए गए थे। मोबाइल नंबर या जन्म तिथि जैसे वैकल्पिक फ़ील्ड्स के लिए, कुछ गेस्ट उन्हें प्रदान करने से मना कर देंगे। यदि विशिष्ट फ़ील्ड्स की पूर्णता आपकी सेगमेंटेशन रणनीति के लिए महत्वपूर्ण है, तो उन फ़ील्ड्स को स्प्लैश पेज पर अनिवार्य बनाने पर विचार करें — लेकिन ध्यान दें कि प्रत्येक अतिरिक्त अनिवार्य फ़ील्ड आपकी समग्र ऑप्ट-इन रूपांतरण दर को कम कर देगा।

GDPR सप्रेशन का सम्मान नहीं किया गया

यदि अनसब्सक्राइब किए गए संपर्कों को बाद के WiFi लॉगिन पर dotdigital में फिर से जोड़ा जा रहा है, तो द्विदिशीय सप्रेशन वेबहुक कॉन्फ़िगर नहीं किया गया है। यह एक अनुपालन जोखिम है। समाधान: एक dotdigital वेबहुक कॉन्फ़िगर करें जो अनसब्सक्राइब ईवेंट पर फ़ायर होता है और Purple में संबंधित संपर्क रिकॉर्ड को अपडेट करता है। वेबहुक कॉन्फ़िगरेशन मार्गदर्शन के लिए dotdigital डेवलपर दस्तावेज़ देखें।

जोखिम न्यूनीकरण फ़्रेमवर्क

जोखिम (Risk) संभावना (Likelihood) प्रभाव (Impact) न्यूनीकरण (Mitigation)
गलत API एंडपॉइंट उच्च मध्यम सीधे dotdigital अकाउंट से एंडपॉइंट प्राप्त करें
सहमति चेकबॉक्स अक्षम मध्यम उच्च प्री-लॉन्च चेकलिस्ट में शामिल करें; वास्तविक डिवाइस के साथ परीक्षण करें
डुप्लिकेट संपर्क मध्यम निम्न dotdigital में ईमेल-आधारित डिडुप्लीकेशन कॉन्फ़िगर करें
सप्रेशन सिंक नहीं हुआ निम्न उच्च गो-लाइव से पहले अनसब्सक्राइब वेबहुक लागू करें
डेटा फ़ील्ड पूर्णता उच्च निम्न सेगमेंटेशन आवश्यकताओं के आधार पर फ़ील्ड आवश्यकताएँ सेट करें
API क्रेडेंशियल एक्सपोज़र निम्न उच्च समर्पित API यूज़र का उपयोग करें; क्रेडेंशियल्स को त्रैमासिक रूप से रोटेट करें

ROI और व्यावसायिक प्रभाव

सफलता मापना

Purple-dotdigital इंटीग्रेशन दो अलग-अलग आयामों में मूल्य प्रदान करता है: डेटाबेस वृद्धि और राजस्व एट्रिब्यूशन। डेटाबेस वृद्धि को प्रति माह जोड़े गए नए ऑप्ट-इन संपर्कों की संख्या, कुल WiFi ऑथेंटिकेशन के प्रतिशत के रूप में ऑप्ट-इन दर, और संपर्क डेटा पूर्णता की दर (सभी आठ फ़ील्ड्स भरे हुए संपर्कों का प्रतिशत) द्वारा मापा जाता है। राजस्व एट्रिब्यूशन को खरीदारी, लॉयल्टी प्रोग्राम साइन-अप, या अन्य रूपांतरण ईवेंट्स को ट्रैक करके मापा जाता है जिन्हें उन संपर्कों से जोड़ा जा सकता है जिन्होंने WiFi लॉगिन के माध्यम से डेटाबेस में प्रवेश किया था।

dotdigital का रिपोर्टिंग सुइट अभियान-स्तर के एनालिटिक्स — ओपन रेट्स, क्लिक-थ्रू रेट्स, रूपांतरण दरें — प्रदान करता है जिनका उपयोग प्रत्येक ऑटोमेशन प्रोग्राम के राजस्व योगदान की गणना करने के लिए किया जा सकता है। Purple का एनालिटिक्स डैशबोर्ड प्रति अधिग्रहित संपर्क लागत की गणना करने के लिए आवश्यक फ़ुटफ़ॉल और ऑथेंटिकेशन डेटा प्रदान करता है।

बेंचमार्क और अपेक्षित परिणाम

Purple एस्टेट में प्रलेखित डिप्लॉयमेंट के आधार पर:

वेन्यू का प्रकार विशिष्ट ऑप्ट-इन दर अपेक्षित ROI टाइमलाइन प्रमुख राजस्व चालक
लक्ज़री रिटेल 35–45% 6–12 महीने लॉयल्टी प्रोग्राम रूपांतरण
होटल (मिड-मार्केट) 25–35% 12–18 महीने डायरेक्ट बुकिंग री-एंगेजमेंट
हवाई अड्डा / परिवहन हब 15–25% 18–24 महीने रिटेल और F&B अपसेल
स्टेडियम / ईवेंट्स वेन्यू 20–30% 12–18 महीने मर्चेंडाइज़ और टिकट अपसेल
सम्मेलन केंद्र 30–40% 6–12 महीने ईवेंट री-बुकिंग और स्पॉन्सरशिप

लागत-लाभ विचार

राजस्व क्षमता के सापेक्ष Purple के भीतर dotdigital कनेक्टर की सीमांत लागत कम है। प्राथमिक निवेश प्रोग्राम डिज़ाइन और कंटेंट निर्माण में है — ऑटोमेशन जर्नी, ईमेल टेम्प्लेट और सेगमेंटेशन लॉजिक जो यह निर्धारित करते हैं कि संपर्क डेटाबेस को कितनी प्रभावी ढंग से मुद्रीकृत किया जाता है। जो संगठन इंटीग्रेशन को 'सेट-एंड-फ़ॉरगेट' डेटा पाइप के रूप में मानते हैं, उन्हें मामूली रिटर्न दिखाई देगा। जो लोग निरंतर प्रोग्राम ऑप्टिमाइज़ेशन में निवेश करते हैं — विषय पंक्तियों का A/B परीक्षण, सेगमेंटेशन को परिष्कृत करना, ऑटोमेशन की गहराई बढ़ाना — उन्हें ऊपर प्रलेखित Harrods और AGS Airports बेंचमार्क के अनुरूप रिटर्न दिखाई देगा।

एक व्यावहारिक सामान्य नियम: WiFi के माध्यम से प्राप्त प्रत्येक 10,000 ऑप्ट-इन संपर्कों के लिए, एक अच्छी तरह से कॉन्फ़िगर किए गए dotdigital प्रोग्राम को डिप्लॉयमेंट के 90 दिनों के भीतर मापने योग्य वृद्धिशील राजस्व उत्पन्न करना चाहिए, यह मानते हुए कि वेलकम सीरीज़ पर न्यूनतम ओपन रेट 20% और क्लिक-थ्रू रेट 2% है।

Key Terms & Definitions

Captive Portal

A web page presented to a guest before they are granted access to a WiFi network. Purple's captive portal — also called a splash page — is the interface through which guests authenticate, provide profile data, and give marketing consent. It is the entry point for all data flowing into the dotdigital integration.

IT teams encounter this during network configuration and splash page design. The captive portal's consent checkbox is the legal and technical gateway to the entire marketing automation pipeline.

Address Book (dotdigital)

A named list of contacts within dotdigital, analogous to a mailing list or CRM segment. Address books are the primary organisational unit in dotdigital and serve as the target destination for Purple's data push. Automation programmes are triggered by contact addition to a specific address book.

The address book taxonomy — how many books, how named, at what level — is the most consequential architectural decision in a multi-venue deployment. It determines segmentation capability for all downstream marketing activity.

Automation Programme (dotdigital)

A configured sequence of automated actions in dotdigital, triggered by a defined event such as a contact being added to an address book. Programmes can include email sends, SMS messages, wait periods, conditional branches, and contact scoring updates. They are the mechanism through which Purple's data capture is converted into marketing communications.

IT teams are responsible for ensuring the connector triggers programme enrolment correctly. Marketing teams design the programme content. The 'Include contacts added via API' setting is a common configuration oversight that prevents programme triggering.

API Endpoint (dotdigital)

The base URL for dotdigital's REST API, specific to the regional data centre assigned to each account. It takes the form `https://r{n}-api.dotdigital.com` where `{n}` is the region number. It is retrieved from Account Settings > Access within the dotdigital platform.

This is the single most common source of connector verification failures. It must be retrieved directly from the dotdigital account — it cannot be guessed or copied from generic documentation.

Consent-Gated Data Push

A data transmission mechanism that only activates when explicit user consent has been recorded. In the Purple-dotdigital integration, Purple will only push a contact record to dotdigital if the guest has ticked the marketing consent checkbox on the splash page. This is a platform-level enforcement, not a configurable option.

This mechanism is the primary GDPR compliance control in the integration. It ensures that only genuinely opted-in contacts enter the marketing database, protecting the organisation from regulatory risk and protecting deliverability from low-engagement contacts.

Double Opt-In

A two-stage consent verification process in which a contact, after initially opting in, receives a confirmation email and must click a link to verify their email address and confirm their subscription. dotdigital supports double opt-in natively. It converts contacts from 'Pending' to 'Subscribed' status and provides an additional layer of consent documentation.

Recommended for venues with high transient footfall — airports, conference centres, train stations — where guests may enter incorrect or temporary email addresses. Double opt-in reduces bounce rates and improves deliverability, at the cost of a lower initial conversion rate.

Suppression List

A list of email addresses or contacts that must not receive marketing communications, typically because they have unsubscribed, complained, or been identified as invalid. dotdigital maintains suppression lists automatically. The Purple-dotdigital integration requires a webhook to sync suppressions back to Purple, preventing re-addition of suppressed contacts on subsequent WiFi logins.

Failure to implement bidirectional suppression sync is a GDPR compliance risk and a deliverability risk. It is a mandatory configuration step in any production deployment.

Venue-Level Connector

A Purple connector configuration scoped to a single venue, as opposed to a customer-level configuration that applies across the entire Purple account. Venue-level connectors allow different venues to be routed to different dotdigital address books, enabling venue-specific segmentation and personalisation.

Essential for multi-property operators. Hotel groups, retail chains, and stadium operators should always use venue-level configuration to maintain clean data segmentation across their estate.

First-Party Data

Data collected directly from individuals by the organisation that will use it for marketing, with the individual's knowledge and consent. WiFi login data captured through Purple's captive portal is first-party data. It is distinct from third-party data (purchased lists) and second-party data (data shared by partners). First-party data is the most valuable and most compliant form of marketing data in the post-cookie, post-GDPR landscape.

The strategic value of the Purple-dotdigital integration is that it generates high-quality first-party data at scale, from physical venue visits. This data is not available through any digital marketing channel and represents a genuine competitive advantage for venue operators.

PECR (Privacy and Electronic Communications Regulations)

UK regulations that govern direct marketing by electronic means, including email and SMS. PECR requires prior consent for marketing emails to individuals (as opposed to businesses). It works in conjunction with UK GDPR to define the legal basis for marketing communications triggered by the Purple-dotdigital integration.

IT and marketing teams must ensure that the splash page consent language covers all channels used for marketing — email, SMS, and push — and that the consent is specific to each channel where required.

Case Studies

A 450-room city-centre hotel group with 12 properties across the UK wants to use Purple's dotdigital connector to build a direct booking re-engagement programme. Each property has its own Purple venue configuration. The marketing team wants to send property-specific offers to guests who have stayed at a particular hotel, while also being able to run group-wide campaigns. How should the integration be architected?

The correct architecture uses venue-level connector configuration in Purple, with each of the 12 properties mapped to a dedicated dotdigital address book. This gives the marketing team clean, venue-specific contact lists for property-level targeting. In parallel, a dotdigital segment is created that aggregates contacts across all 12 address books — this segment is used for group-wide campaigns without duplicating contact records.

Step 1: In dotdigital, create 12 address books named by property (e.g., 'Purple - Manchester City Centre', 'Purple - Edinburgh Royal Mile'). Create a master segment using the 'Contact is in any of these address books' condition covering all 12 books.

Step 2: In Purple, navigate to each venue's settings under Management > Venues. For each venue, add a dotdigital connector at venue level, using the same API credentials but selecting the property-specific address book.

Step 3: Build a welcome automation programme in dotdigital triggered by contact addition to any of the 12 address books. Use dynamic content blocks in the email template to personalise the message based on the address book (property) the contact was added to — for example, featuring the specific hotel's amenities and a direct booking link.

Step 4: Build a re-engagement programme that fires 30 days after the last WiFi login, with a property-specific offer. Use dotdigital's contact scoring to identify high-value guests (multiple visits, high data completeness) for premium re-engagement campaigns.

Step 5: For group-wide campaigns — seasonal promotions, loyalty programme launches — use the master segment to reach the full opted-in database without duplicating sends to contacts who appear in multiple property address books.

Implementation Notes: This architecture correctly separates venue-level segmentation from group-level reach. The key decision point is using venue-level connector configuration rather than customer-level, which would route all 12 properties into a single address book and lose venue attribution. The master segment approach avoids the operational complexity of managing 12 separate campaign sends for group-wide communications. The dynamic content approach in the welcome email is a best practice that significantly improves engagement rates — guests respond to communications that reference their specific experience, not generic brand messaging. The re-engagement trigger at 30 days is based on documented industry benchmarks for hotel guest return frequency in city-centre properties.

A national retail chain with 85 stores has deployed Purple WiFi across its estate. After six months, the marketing team reports that contacts are appearing in dotdigital but the welcome automation programme is not triggering for approximately 15% of new contacts. The IT team has confirmed the connector is verified and contacts are being added to the correct address book. What is the most likely cause and how should it be resolved?

The most likely cause is a race condition between contact creation and programme enrolment in dotdigital, combined with contacts being added via the API rather than through dotdigital's native import. When contacts are added to an address book via the API — as Purple does — dotdigital's programme trigger logic may not fire if the programme is configured to trigger on 'contact added to address book via import' rather than 'contact added via API'.

Resolution Step 1: In dotdigital's Program Builder, open the welcome programme and inspect the enrolment trigger. Verify that the trigger condition is set to 'Contact added to address book' and that the 'Include contacts added via API' option is enabled. This option is not enabled by default in all dotdigital account configurations.

Resolution Step 2: If the trigger condition is correct, check whether the affected contacts have an opt-in status of 'Unknown' rather than 'Subscribed' in dotdigital. Contacts with 'Unknown' status may be excluded from programme enrolment depending on programme settings. Resolution: configure the programme to include contacts with 'Unknown' opt-in status, or implement dotdigital's double opt-in workflow to convert contacts to 'Subscribed' status on confirmation.

Resolution Step 3: Review the programme's enrolment frequency setting. If set to 'Enrol once only', contacts who have previously been enrolled — for example, from a prior WiFi session at a different store — will not be re-enrolled. For a retail chain where guests may visit multiple stores, consider whether re-enrolment on each new store visit is appropriate, and configure accordingly.

Resolution Step 4: Check for programme enrolment limits. Some dotdigital account configurations impose a maximum daily enrolment rate. If the retail chain's WiFi generates a high volume of new contacts on peak trading days, this limit may be causing the 15% gap.

Implementation Notes: This scenario illustrates a common class of integration issue that is not immediately visible from the connector configuration — it requires understanding of how dotdigital's programme trigger logic interacts with API-sourced contacts. The 'Include contacts added via API' setting is a frequent oversight in initial deployments. The opt-in status issue is equally common in multi-venue retail deployments where guests may have previously interacted with the brand through a different channel. The enrolment frequency question is a genuine architectural decision — for a retail chain, re-enrolment on each store visit may be appropriate to deliver store-specific content, but requires careful programme design to avoid over-communication.

Scenario Analysis

Q1. A conference centre operator runs a single Purple account covering three venues: a main auditorium, a breakout suite, and an exhibition hall. They want to use dotdigital to send post-event follow-up emails to attendees, with content specific to which space they visited. Their current connector is configured at customer level, routing all three venues into a single dotdigital address book. What change should they make, and what are the implications?

💡 Hint:Consider how venue-level configuration changes the address book structure, and what additional steps are required in dotdigital to support venue-specific content.

Show Recommended Approach

The operator should reconfigure the connector at venue level, creating three separate dotdigital address books — one per venue. This allows dotdigital to identify which venue a contact was added from, enabling venue-specific content in automation programmes. The implications are: (1) existing contacts in the single customer-level address book will need to be migrated or re-segmented; (2) three separate automation programmes will need to be created or a single programme with dynamic content blocks will need to be configured; (3) for group-wide communications, a dotdigital segment aggregating all three address books should be created. The migration of existing contacts is the most operationally complex step — it requires identifying which venue each existing contact was associated with, which may require cross-referencing Purple's analytics data with the dotdigital contact records.

Q2. A hotel group's IT team has deployed the Purple-dotdigital connector across 8 properties. Three months after go-live, the marketing team reports that the welcome email open rate is 12% — significantly below the 25% benchmark for hospitality welcome emails. Bounce rates are at 4.2%. What are the most likely causes and what remediation steps should the IT team recommend?

💡 Hint:A 4.2% bounce rate is a strong signal about data quality at the point of collection. Consider what happens to email deliverability when bounce rates are elevated, and how the consent mechanism may be contributing.

Show Recommended Approach

The 4.2% bounce rate is the primary issue and is almost certainly causing the low open rate. When bounce rates exceed 2%, inbox providers begin to treat the sending domain as a source of low-quality email, reducing inbox placement rates across the entire database — including valid, engaged contacts. The root cause of the high bounce rate is likely guests entering incorrect or temporary email addresses at the splash page, which is common in transient hospitality environments. Remediation: implement dotdigital's double opt-in workflow to verify email addresses before they enter the active database. This will reduce the volume of new contacts but will significantly improve data quality. Additionally, review whether the splash page requires email address confirmation (entering the address twice) — this simple UX change reduces typo-based bounces. For the open rate, review the welcome email send timing — if the email is sent hours after check-in rather than within minutes of WiFi connection, the contextual relevance is reduced. Also review the subject line and sender name for relevance and trust signals.

Q3. A large retail chain's data protection officer has raised a concern that the Purple-dotdigital integration may be re-adding previously unsubscribed contacts to the marketing database when they visit a store and connect to WiFi. The IT team needs to confirm whether this is happening and, if so, implement a fix. What steps should they take?

💡 Hint:This is a GDPR compliance issue, not just a technical one. Consider the data flow in both directions and what configuration is required to prevent re-addition of suppressed contacts.

Show Recommended Approach

This is a genuine GDPR risk. The scenario occurs when: (1) a contact unsubscribes from dotdigital marketing; (2) the unsubscribe is not synced back to Purple; (3) the contact subsequently visits a store and connects to WiFi; (4) Purple, unaware of the suppression, pushes the contact record to dotdigital again; (5) dotdigital re-adds the contact to the address book. To confirm whether this is happening, cross-reference dotdigital's suppression list with recent address book additions — any email address appearing in both lists indicates the problem is occurring. The fix requires two steps: (1) configure a dotdigital webhook that fires on unsubscribe events and updates the corresponding contact record in Purple to mark them as suppressed; (2) implement a pre-push check in the connector configuration to verify that the contact's email address is not on the dotdigital suppression list before transmitting. The DPO should also be advised that a Data Protection Impact Assessment should be conducted if one has not already been completed for this integration, given the cross-system personal data processing involved.

Q4. A stadium operator wants to use the Purple-dotdigital integration to send personalised post-match emails to fans who connected to the stadium WiFi during an event. They want to include the match result, a link to match highlights, and a personalised merchandise offer based on the fan's team affiliation. The current integration only captures the eight standard Purple data fields. What additional configuration is required to support this use case?

💡 Hint:Consider how event-specific data (match date, teams, result) can be associated with contacts in dotdigital, and how team affiliation can be captured at the splash page level.

Show Recommended Approach

This use case requires two enhancements beyond the standard integration. First, team affiliation must be captured at the splash page level using Purple's custom question feature on the splash page. A dropdown or radio button question — 'Which team are you supporting today?' — captures the affiliation at authentication time. This data can be passed to dotdigital as a custom contact data field, which must be created in dotdigital's account settings before the connector is configured. Second, event-specific data (match date, opponent, result) needs to be associated with the contact's session. This can be achieved by creating a separate dotdigital address book for each event, named with the match details, and configuring the Purple connector to route that event's WiFi logins to the event-specific address book. The post-match automation programme is then triggered by addition to that address book, with the match details embedded in the email template. For the merchandise offer, dotdigital's dynamic content feature can serve different product recommendations based on the team affiliation custom data field. This is a more complex deployment that benefits from Purple's Professional Services team involvement during the initial configuration.

Key Takeaways

  • The Purple-dotdigital connector is a real-time, consent-gated API integration that pushes eight guest profile fields to dotdigital at the point of WiFi authentication — but only when the guest has explicitly opted in to marketing communications.
  • Connector configuration requires four inputs: a connector name, a dotdigital API user email, the corresponding password, and the account-specific API endpoint URL retrieved from dotdigital's Account Settings > Access page. Incorrect endpoint URL is the leading cause of verification failures.
  • Deploy the connector at venue level for multi-property organisations to maintain clean address book segmentation per property; use customer level only for single-venue operators.
  • Build and test dotdigital automation programmes before activating the connector — the welcome email sent within minutes of WiFi login is the highest-engagement communication in the guest lifecycle and should not be missed.
  • Implement the dotdigital unsubscribe webhook to sync suppressions back to Purple; without this, the integration is non-compliant with UK GDPR and PECR and will generate deliverability problems over time.
  • Documented ROI benchmarks from the Purple estate include 54x return at Harrods, 842% at AGS Airports, and 10,630% at Brussels South Charleroi Airport — outcomes driven by deliberate programme design, not just a connected API.
  • Monitor deliverability metrics weekly during the first 90 days: target open rate above 20%, bounce rate below 2%, unsubscribe rate below 0.5%. Elevated bounce rates are the primary signal of data quality issues at the consent capture layer.