Apache Unomi 2.x - Documentation

• 语言: 英语
• 格式: .pdf

摘要

文档详细介绍了Apache Unomi 2.0的新功能和改进，包括引入GraphQL API、支持JSON Schema、更新数据模型以支持扁平化属性、新增资料别名功能、强制要求作用域声明等。文档还提供了如何配置和使用这些新功能的指导，以及与旧版本的数据迁移方法。

AI总结

### Apache Unomi 2.x 文档总结

#### 1. 新功能介绍
- **JSON Schema 支持**：引入了 JSON Schema 验证，确保数据符合预期格式，增强数据一致性。
- **GraphQL API（Beta）**：新增 GraphQL API，提供灵活的数据查询能力，适用于复杂的数据需求。
- **用户资料别名**：允许用户资料使用多个 ID 引用，提升与外部系统的集成灵活性。
- **数据模型更新**：移除开放映射，引入受限事件对象属性，优化性能和可扩展性。
- **Web Tracker 重写**：基于内部实现，提升稳定性和性能，适用于生产环境。

#### 2. 实用指南
- **调试模式启用**：通过 SSH 控制台启用调试日志，便于开发和问题排查。
- **用户资料读取**：通过 REST API 请求获取用户资料数据，支持指定所需属性。
- **安全更新资料**：推荐使用公共互联网接口更新资料，避免直接访问敏感数据。

#### 3. 配置指南
- **默认位置设置**：调整默认跟踪位置，适用于测试或演示环境。
- **SSH 控制台访问**：修改默认端口，避免与其他 Karaf 产品冲突，提供安全访问方式。
- **Elasticsearch 安全配置**：配置用户认证和访问控制，确保数据安全。

#### 4. 高级主题
- **插件开发**：通过 Maven 项目创建插件，扩展 Unomi 功能，支持自定义定义和预定义分段。
- **数据迁移**：提供脚本工具，简化从 Unomi 1.x 到 2.x 的数据迁移过程。

#### 5. 核心概念
- **事件模型**：事件类型开放，支持自定义，包含用户行为数据。
- **用户资料**：构建用户画像，支持自定义属性和分段，实现跨应用跟踪。

#### 6. 快速入门
- **环境搭建**：使用 Docker 或 Maven 编译运行 Unomi，确保 Java 11+ 和 Elasticsearch 7.17.5 兼容。
- **Web 跟踪集成**：通过 JavaScript 引入跟踪器，实现网页行为数据采集和分析。

#### 7. 参考资料
- **REST API 文档**：提供详细的 API 接口说明，便于开发和集成。
- **系统 URLs**：列出常用诊断和管理 URL，帮助快速访问系统功能。

总结：Apache Unomi 2.0 通过增强数据验证、扩展 API 支持、优化数据模型和提升安全性，为用户提供了更强大、灵活和安全的数字化体验平台。文档内容全面，涵盖从基础使用到高级定制的各个方面，帮助用户快速上手并深入应用。