跳转到主要内容

概览

OneSignal + Google Sheets 集成可以自动将自定义事件从您的 Google Sheets 同步到 OneSignal。这允许您基于存储在电子表格中的用户行为数据触发自动化 Journeys 和个性化消息推送活动,非常适合协作管理事件数据的团队。

要求

  • 访问自定义事件(目前处于测试阶段)
  • 升级账户计划(免费应用不可用)。

谷歌表格

  • 能够访问包含事件数据的工作表的 Google 账户
  • 具有适当列结构用于事件数据的 事件电子表格
  • OneSignal 访问数据所需的 工作表共享权限
  • 事件跟踪工作表中的 一致数据格式

设置

1

准备您的事件数据工作表

使用事件数据所需的列来结构您的 Google Sheet:必需列:
  • event_nameevent_type:事件名称(字符串)
  • user_idemail:用户标识符(字符串)
  • timestampcreated_at:事件时间戳(日期/日期时间)
  • properties:事件属性作为 JSON 或单独的列(可选)
示例工作表结构:
| event_name | user_id | timestamp           | product_id | amount |
|------------|---------|---------------------|------------|--------|
| purchase   | user123 | 2024-01-15 10:30:00 | prod_abc   | 29.99  |
| signup     | user456 | 2024-01-15 11:45:00 |            |        |
2

配置工作表权限

与 OneSignal 的服务账户共享您的 Google Sheet:
  1. 打开您的 Google Sheet
  2. 点击右上角的 共享 按钮
  3. 添加 OneSignal 的服务账户电子邮件(在设置过程中提供)
  4. 将权限设置为 查看者(只读访问)
  5. 点击 发送 来授予访问权限
OneSignal 将在集成设置过程中提供特定的服务账户电子邮件。
3

在 OneSignal 中添加集成

在 OneSignal 中,前往 数据 > 集成,然后点击 添加集成选择 Google Sheets 并提供:
  • 工作表 URL:您的 Google Sheet 的完整 URL
  • 工作表名称:包含事件数据的特定选项卡/工作表名称
  • 标题行:包含列标题的行号(通常为 1)
  • 数据范围:包含您的事件数据的单元格范围(例如,A2:F1000
4

配置列映射

将您的 Google Sheets 列映射到 OneSignal 事件字段:
  • 事件名称列:选择包含事件名称的列
  • 用户 ID 列:选择包含用户标识符的列
  • 时间戳列:选择包含事件时间戳的列
  • 属性列:选择要作为事件属性包含的附加列
您可以将多列映射为事件属性。OneSignal 会将它们组合成一个单一的事件载荷。
5

设置同步计划

配置 OneSignal 检查新事件数据的频率:
  • 同步频率:从 15 分钟、每小时或每天中选择
  • 增量同步:启用以仅同步上次更新后的新行
  • 时间戳筛选器:仅同步特定时间范围内的事件
Google Sheets 具有 API 速率限制。对于大型数据集的工作表,更频繁的同步可能会被限速。
6

测试连接

点击 测试连接 来验证 OneSignal 可以访问您的 Google Sheet 并正确读取事件数据。

事件数据映射

将您的 映射到 OneSignal 的自定义事件格式:
OneSignal 字段描述必需
nameevent_name事件标识符
external_iduser_id用户标识符
timestampevent_timestamp事件发生时间
propertiesevent_data

高级配置

增量同步设置

配置增量同步以仅处理新事件:
  1. 时间戳列:确保您的工作表具有一致的时间戳列
  2. 排序顺序:按时间戳排序事件(最新的在最后)
  3. 仅附加:将新事件添加到工作表底部
  4. 避免编辑:同步后不要修改历史事件行

数据验证

在您的 Google Sheet 中实施数据验证:
数据 > 数据验证
- 事件名称:从范围列表(预定义的事件类型)
- 用户 ID:自定义公式来检查格式
- 时间戳:日期/时间格式验证
- 金额:数字属性的数字验证

协作工作流

团队协作的最佳实践:
  • 命名范围:为事件数据部分使用命名范围
  • 受保护的范围:保护标题行免受意外更改
  • 注释:添加注释来解释事件定义
  • 版本历史:使用 Google Sheets 的版本历史来跟踪更改
  • 访问控制:限制数据录入团队成员的编辑访问权限

性能优化

针对大型数据集进行优化:
  • 工作表限制:为获得最佳性能,将单个工作表保持在10,000行以下
  • 多个工作表:为不同的事件类型使用单独的工作表
  • 数据存档:每月将旧数据存档到单独的工作表
  • 公式:尽量减少事件数据范围中的复杂公式
Google Sheets 在总共低于 50,000 个单元格时性能最佳。对于大量事件跟踪,请考虑使用数据库源。

常见问题

OneSignal 多久从 Google Sheets 同步一次事件?

OneSignal 可以频繁地每 15 分钟同步一次,但我们建议大多数使用情况采用每小时或每天同步,以遵守 Google 的 API 限制。

多个团队成员可以向同一工作表添加事件吗?

是的,Google Sheets 支持实时协作。但是,确保团队成员了解所需的数据格式和列结构。

如果有人编辑历史事件数据会发生什么?

OneSignal 基于时间戳和行位置进行同步。编辑历史数据可能会导致重复事件或数据不一致。我们建议采用仅追加的工作流。
I