Datacloud Personalization App

🌩️ 数据云管理器

用于管理Salesforce Data Cloud的全面web应用程序。创建数据、建立关系、细分受众和生成个性化电子邮件活动——所有这些都可以通过一个美观、易于使用的界面完成。

✨ 特性

🔐 认证

• 使用用户名/密码安全登录Salesforce
• 可选安全令牌支持
• 会话管理

💾 数据管理

• CRUD操作：创建、读取、更新、删除记录
• 批量创建：一次生成多条记录
• 多对象支持：个人、联系人、帐户、活动、机会等
• 实时数据：与Salesforce API直接集成

🔗 建立关系高手

• 发现关系：自动检测父子关系
• 可视化连接：查看对象之间的关系
• 创建链接：跨不同对象连接记录
• 关系图：对象关系的视觉表示

🎯 细分引擎

• 创建分段：根据多个条件筛选记录
• 预览结果：保存前查看分段成员
• 同步到活动：自动创建Salesforce活动
• 已保存的片段：存储和重用分段配置

📧 电子邮件活动生成器

• 个性化模板：包含动态内容的VIP欢迎电子邮件
• 基于参与度：按参与程度定制（卓越、杰出、优秀）
• 独特的促销代码：生成个人折扣码
• 批量发送：一次发送到整个分段
• 预览电子邮件：发送前查看电子邮件的外观

📊 分析仪表板

• 实时统计：跟踪个人、联系人、活动、机会
• 细分分析：监控细分市场绩效
• 电子邮件指标：打开率、点击率、参与度
• 可视化报告：易于理解的图表和图形

🚀 入门指南

先决条件

• Python 3.8或更高版本
• Salesforce数据云组织访问
• Salesforce用户名和密码
• （可选）如果IP未列入白名单，则使用安全令牌

安装

1. 导航到应用程序目录：

cd /Users/bbanerjee/.cursor/DC\ MCP/datacloud_app

1. 安装依赖项：

pip3 install -r requirements.txt

1. 运行应用程序：

python3 app.py

1. 打开浏览器：

引导到 http://localhost:5000

📖 用户指南

第一步：登录

1. 打开 http://localhost:5000
2. 输入您的Salesforce凭据：

- 用户名: your.email@salesforce.com - 密码：您的Salesforce密码 - 安全令牌：如果您的IP被列入白名单，请留空

1. 点击“连接Salesforce”

步骤2：创建数据

1. 首选 数据管理 从侧边栏
2. 选择一个对象（个人、联系人等）
3. 点击“创建记录”
4. 输入要创建的记录数
5. 记录将自动生成测试数据

示例：创建100个人

• 对象：个人
• 计数：100
• 模板：自动生成（测试人员1、测试人员2等）

第三步：建立关系

1. 首选 建立关系高手
2. 选择要探索的对象
3. 查看父关系（查找）
4. 查看儿童关系
5. 在记录之间创建连接

共同关系:

• 个体→ 联系人（通过个人ID）
• 联系→ 活动（通过CampaignMember）
• 个体→ ContactPoint电子邮件（通过ParentId）

步骤4：创建分段

1. 首选 片段
2. 点击“创建分段”
3. 填写细分市场详细信息：

- 名字：“VIP-高度参与” - 描述：“前10%的活跃用户” - 基础对象：个人

1. 添加筛选器：

- 字段：参与度得分 - 操作员：大于 - 值：4

1. 点击“预览”查看结果
2. 点击“创建分段”保存

步骤5：生成个性化电子邮件

1. 首选 电子邮件活动
2. 选择一个分段
3. 选择电子邮件模板（VIP欢迎）
4. 点击“预览”查看示例电子邮件
5. 点击“生成电子邮件”以创建个性化电子邮件
6. 查看生成的电子邮件
7. 点击“发送”发送给所有分段成员

步骤6：监控分析

1. 首选 分析
2. 查看细分统计数据
3. 监控电子邮件性能
4. 跟踪参与度指标

🎨 电子邮件个性化

VIP欢迎电子邮件模板包括：

• 动态问候：基于收件人排名
• 参与程度:

- 🌟🌟🌟 卓越（得分7+） - 🌟🌟 优秀（5-6分） - 🌟 优秀（得分4）

• 个人状态：电子邮件打开、点击、评分、排名
• 独特的促销代码：VIP01欢迎、VIP02欢迎等。
• 定制优惠：VIP专享折扣，优先支持
• 漂亮的设计：紫色渐变头，金色VIP徽章

🔧 配置

修改电子邮件模板

在以下位置编辑模板： templates/email_templates/vip_welcome.json

{
  "id": "vip_welcome",
  "name": "VIP Welcome Email",
  "subject_template": "🌟 {greeting}, {first_name}!",
  "html_template": "",
  "variables": ["greeting", "first_name", "full_name", ...]
}

添加自定义对象

对象会自动从Salesforce组织加载。要对某些对象进行优先级排序，请编辑 modules/data_manager.py:

common_objects = [
    'Individual', 'Contact', 'Account', 
    'YourCustomObject__c'  # Add your custom object
]

📁 项目结构

datacloud_app/
├── app.py                      # Main Flask application
├── requirements.txt            # Python dependencies
├── modules/
│   ├── salesforce_connector.py # Salesforce authentication
│   ├── data_manager.py         # Data CRUD operations
│   ├── relationship_builder.py # Relationship discovery
│   ├── segmentation_engine.py  # Segment creation/management
│   └── email_generator.py      # Email generation/sending
├── templates/
│   ├── login.html             # Login page
│   ├── dashboard.html         # Main dashboard
│   ├── data_management.html   # Data CRUD interface
│   ├── relationships.html     # Relationship builder
│   ├── segments.html          # Segmentation interface
│   ├── emails.html            # Email campaign interface
│   ├── analytics.html         # Analytics dashboard
│   └── sidebar.html           # Navigation sidebar
├── static/
│   ├── css/
│   │   └── style.css          # Application styles
│   └── js/
│       └── data_management.js # Data management JS
└── data/
    └── segments.json          # Saved segments (auto-generated)

🎯 常见用例

用例1:VIP电子邮件活动

目标：向前11位活跃用户发送个性化欢迎电子邮件

1. 创建100个人（数据管理）
2. 为每个（关系）创建ContactPoint电子邮件
3. 模拟参与度数据（或使用真实数据）
4. 创建细分市场：“参与度得分>4”（细分市场）
5. 生成VIP电子邮件（电子邮件活动）
6. 预览并发送

结果：11封带有独特促销代码和参与统计数据的个性化电子邮件

用例2：领导力培养活动

目标：跟进高价值线索

1. 年收入>10万美元的查询线索
2. 创建细分市场：“高价值潜在客户”
3. 生成后续电子邮件
4. 跟踪打开和点击（分析）

用例3：活动邀请

目标：邀请参与的客户参加网络研讨会

1. 创建细分：“上个月打开了3+封电子邮件”
2. 活动链接：“Q1网络研讨会”
3. 生成活动邀请电子邮件
4. 跟踪RSVP

🔐 安全说明

• 从不提交凭据 到版本控制
• 将环境变量用于生产
• 在Salesforce上启用双因素身份验证
• 将您的IP列入白名单，以便于访问
• 定期轮换安全令牌

🐛 故障排除

登录时“连接失败”

解决方案:

1. 检查用户名和密码
2. 如果IP未列入白名单，则添加安全令牌
3. 验证Salesforce组织是否可访问
4. 检查网络连接

“未找到记录”

解决方案:

1. 使用数据管理创建记录
2. 检查对象权限
3. 验证SOQL查询语法
4. 检查现场级安全性

“电子邮件发送失败”

解决方案:

1. 验证电子邮件地址是否有效
2. 检查Salesforce电子邮件发送限制
3. 确保提供emailSimple API
4. 查看Salesforce电子邮件送达设置

📚 API 文档

认证

发布 /login

{
  "username": "user@example.com",
  "password": "password",
  "security_token": "optional"
}

数据操作

获取 /api/data/objects -列出可用对象

获取 /api/data/{object}/records -获取记录

发布 /api/data/{object}/create -创建记录

发布 /api/data/{object}/bulk-create -批量创建记录

放 /api/data/{object}/{id} -更新记录

删除 /api/data/{object}/{id} -删除记录

片段

获取 /api/segments/list -列出所有分段

发布 /api/segments/create -创建细分市场

获取 /api/segments/{id}/members -获取分段成员

发布 /api/segments/{id}/sync -同步到Salesforce活动

电子邮件

发布 /api/emails/generate -生成个性化电子邮件

发布 /api/emails/send -发送电子邮件

发布 /api/emails/preview -预览电子邮件

🚀 后续步骤

1. 扩展电子邮件模板：为不同的用例创建模板
2. 添加更多筛选器：使用高级标准加强细分
3. 电子邮件A/B测试：测试不同的主题行和内容
4. 计划发送：安排电子邮件的最佳时间
5. 高级分析：添加转化跟踪和ROI指标
6. 移动应用：构建iOS/Android配套应用程序
7. 整合：连接营销云、Slack等。

📞 支持

如有疑问或问题：

• 电子邮件：bbanerjee@salesforce.com
• Salesforce组织：https://sftutor.lightning.force.com

📄 许可证

此应用程序供Salesforce Data Cloud环境内部使用。

______________________________________________________________________

内置于❤️ Salesforce数据云

版本: 1.0.0\ 最后更新：2025年10月30日