dotdigital（前身为Dotmailer）：Purple AI用户的集成指南、最佳实践与故障排除

执行摘要

Purple AI平台在酒店、零售地产、体育场馆和公共部门场所的WiFi认证点捕获第一方客客数据。dotdigital连接器（前身为Dotmailer）将这种原始数据捕获转化为生产级的营销自动化管道。当客人连接到您的WiFi并同意接收营销通讯时，Purple会实时将其个人资料推送到指定的dotdigital地址簿中。从那一刻起，dotdigital的自动化引擎可以触发欢迎旅程、忠诚度计划邀请、再营销活动和跨电子邮件、短信和推送的全渠道通信。

商业案例有据可查。哈罗德百货通过WiFi驱动的数据捕获构建了一个包含360万联系人的数据库，并在一年内实现了其Purple投资的54倍回报。AGS机场实现了842%的投资回报率。布鲁塞尔南沙勒罗瓦机场使用Purple的MicroSurveys与下游营销自动化相结合，实现了10,630%的投资回报率。这些成果并非例外——它们是经过深思熟虑的程序设计部署的配置良好的集成预期结果。

本指南提供了在企业级部署、优化和排除Purple-dotdigital集成故障所需的技术深度。它是为需要在本季度内实施解决方案的IT专业人员编写的，而不是为明年评估解决方案的人编写的。

技术深度解析

集成架构

Purple-dotdigital连接器作为服务器到服务器的REST API集成运作。Purple充当数据生产者，dotdigital充当消费者。连接使用dotdigital的Basic Auth机制进行身份验证：一个在dotdigital平台内创建的专用API用户账户（电子邮件地址和密码），结合一个区域特定的API端点URL。

该架构默认是单向的——Purple在WiFi认证点将联系人记录推送到dotdigital。对于需要双向同步的组织（例如，将取消订阅或抑制列表更新反映回Purple），这需要通过dotdigital的webhook框架进行额外配置。

数据有效载荷和字段映射

Purple为每位同意的客人向dotdigital传输八个数据字段。这些字段直接映射到dotdigital的标准联系人数据模型，在基本部署中无需自定义字段配置。

数据传输在平台级别由同意控制。Purple不会将联系人记录发送到dotdigital，除非客人已通过启动页面同意复选框明确选择接收营销通信。这是一个硬性强制措施——而不是可配置选项——并且是集成维持符合英国GDPR、欧盟通用数据保护条例和CCPA的主要机制。

身份验证和端点配置

dotdigital的REST API使用HTTP基本身份验证。凭据包括一个API用户电子邮件地址和密码，该用户必须在dotdigital账户中创建为专用用户——而不是主账户登录。API端点URL是账户特定的且取决于区域。它从dotdigital平台内的账户设置 > 访问中检索。对于区域一账户，典型端点格式为https://r1-api.dotdigital.com。

此端点特异性是连接器验证失败的最常见原因。尝试使用通用或文档示例URL的团队将遇到身份验证错误。始终直接从正在使用的dotdigital账户中检索端点值。

连接器部署级别

Purple为dotdigital连接器支持两个部署级别：

客户级别将连接器配置应用于整个Purple账户，将所有场馆的所有同意客人路由到一个dotdigital地址簿中。这适用于单一场馆运营商或具有同质场馆资产的机构。

场馆级别允许每个单独的场馆映射到不同的dotdigital地址簿。这推荐用于多物业运营商——酒店集团、零售连锁、体育场馆运营商——其中需要场馆级细分以实现定向营销、本地化优惠或独立的品牌标识。

实施指南

步骤 1：准备您的 dotdigital 账户

在配置Purple连接器之前，请在您的dotdigital账户中完成以下操作。导航到账户设置，创建一个新的API用户，使用专用电子邮件地址和强密码。记录在访问页面顶部显示的API端点URL。创建将接收Purple联系人的地址簿——对于多物业部署，建议每个场馆一个。可选地，如果您打算捕获超出八个标准Purple字段之外的额外属性，可以在dotdigital中创建自定义数据字段。

步骤 2：配置 Purple 连接器

在Purple平台内，导航到管理 > 连接器。找到dotdigital连接器并选择添加。填写四个必填字段：连接器名称（供您参考的描述性标签）、dotdigital API电子邮件、dotdigital API密码和dotdigital API端点URL。选择验证。验证成功后，将出现一个下拉列表，列出您dotdigital账户中可用的地址簿。选择目标地址簿并保存配置。

对于多场馆部署，请在场馆级别为每个物业重复此过程，将每个物业分配给其指定的地址簿。

步骤 3：配置启动页面同意机制

Purple启动页面上的营销同意复选框是整个集成的网关。导航到您的启动页面配置，确保营销选择加入复选框已启用且标签清晰。根据UK GDPR第7条，同意语言必须明确、具体且不含糊。合规示例：“我同意接收来自[组织名称]的关于优惠、活动和新闻的营销通信。您可以随时取消订阅。” 请勿预勾选此复选框。

如果您的营销计划包括短信，请确保同意语言明确涵盖短信通信。只要语言清晰，单个复选框同时涵盖电子邮件和短信是允许的。

步骤 4：构建您的 dotdigital 自动化程序

在连接器上线之前，在dotdigital中部署自动化程序。至少配置一个由联系人添加到地址簿触发的欢迎程序。一个推荐的三阶段欢迎旅程：

• 立即（0分钟）： 欢迎邮件，确认WiFi访问，并附上您的场馆或服务的品牌介绍。
• 第2天（48小时）： 跟进邮件，包含相关优惠、场馆指南或根据客人上下文定制的内容片段。
• 第30天（再营销）： 针对未再访问的联系人的自动再营销邮件，附带再次光临的激励措施。

对于忠诚度计划集成，使用dotdigital的Program Builder来招募满足特定条件的联系人——例如，对有关忠诚度计划兴趣的自定义启动页面问题回答肯定的联系人。

步骤 5：配置双向抑制同步

配置一个dotdigital webhook，在联系人取消订阅时通知Purple。这可以确保被抑制的联系人在下次WiFi登录时不会被重新添加到dotdigital。如果没有此步骤，从GDPR合规角度来看，集成在技术上是不完整的。

步骤 6：验证并上线

通过使用测试设备在WiFi上认证，使用测试电子邮件地址和营销同意完成启动页面，并验证联系人是否在2至3分钟内出现在正确的dotdigital地址簿中，进行端到端测试。确认欢迎自动化程序正确触发。记录测试结果并继续生产部署。

最佳实践

同意架构

您的选择加入数据库的质量直接取决于您的同意架构。投资于清晰、诚实的同意语言的组织——即使这会略微降低选择加入率——会构建更活跃、更高价值的联系人列表。来自透明同意机制的30%选择加入率将始终优于来自模糊或误导机制的60%选择加入率，因为前一组人真正想听到您的消息。哈罗德从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管辖的管辖区部署集成之前进行数据保护影响评估，特别是对于根据《2018年数据保护法》承担额外义务的公共部门组织。

故障排除与风险缓解

连接器验证失败

最常见的部署问题。在大多数情况下是由不正确的API端点URL引起的。解决方法：登录dotdigital，导航到账户设置 > 访问，并完全按照显示复制端点URL。确保不包含末尾斜杠或空格。验证API用户凭据是针对专用API用户账户，而不是主账户登录。如果验证仍然失败，请确认dotdigital账户已启用API访问——对于某些账户级别，这可能需要dotdigital支持团队激活。

联系人未出现在dotdigital中

如果连接器验证成功但联系人未出现在目标地址簿中，主要原因是启动页面未启用营销同意复选框。没有明确同意，Purple不会传输数据。次要原因包括连接器配置在错误的级别（客户 vs 场馆），或者自连接器保存以来地址簿ID已更改。解决方法：验证启动页面同意配置，确认连接器级别，并重新验证连接器以刷新地址簿选择。

重复联系人记录

当同一电子邮件地址在多个WiFi会话中提交时发生，通常发生在客流量大的场所。解决方法：确保dotdigital的地址簿配置为在电子邮件地址匹配时更新现有联系人，而不是创建新记录。这在dotdigital的联系人导入设置中控制。此外，检查Purple连接器是否在同一场馆同时配置了客户级别和场馆级别——双重配置将导致重复推送。

缺少数据字段

如果联系人出现在dotdigital中但某些字段为空，最可能的原因是客人在启动页面上未填写这些字段。Purple仅传输身份验证期间提供的数据字段。对于可选字段，如手机号码或出生日期，一些客人会拒绝提供。如果特定字段的完整性对您的细分策略至关重要，请考虑在启动页面将这些字段设为必填——但请注意，每个额外的必填字段都会降低您的整体选择加入转化率。

GDPR抑制未遵守

如果已取消订阅的联系人在随后的WiFi登录中被重新添加到dotdigital，则尚未配置双向抑制webhook。这是一个合规风险。解决方法：配置一个dotdigital webhook，在取消订阅事件时触发，并更新Purple中相应的联系人记录。请查阅dotdigital开发者文档以获取webhook配置指导。

风险缓解框架

ROI和业务影响

衡量成功

Purple-dotdigital集成在两个不同的维度上提供价值：数据库增长和收入归因。数据库增长通过每月新增的选择加入联系人数量、选择加入率占WiFi认证总数的百分比以及联系人数据完整性率（所有八个字段都有值的联系人百分比）来衡量。收入归因通过跟踪购买、忠诚度计划注册或其他转化事件来衡量，这些事件可以链接到通过WiFi登录进入数据库的联系人。

dotdigital的报告套件提供活动级分析——打开率、点击率、转化率——可用于计算每个自动化程序的收入贡献。Purple的分析仪表板提供计算每个获取联系人成本所需的客流和认证数据。

基准和预期结果

基于Purple资产中记录的部署：

成本效益考虑

相对于收入潜力，Purple中dotdigital连接器的边际成本较低。主要投资在于程序设计和内容创建——自动化旅程、电子邮件模板和细分逻辑，这些决定了联系人数据库的有效变现程度。将集成视为设置后即忘记的数据管道的组织将看到适度的回报。那些投资于持续程序优化——A/B测试主题行、细化细分、扩展自动化深度——的组织将看到与上述哈罗德和AGSAirports基准一致的回报。

一个实用的经验法则：每通过WiFi获取10,000个选择加入联系人，一个配置良好的dotdigital程序应在部署后90天内产生可衡量的增量收入，假设欢迎系列的打开率最低为20%，点击率为2%。