Segment 集成
Segment 是一个客户数据平台，可简化用户数据收集并帮助您有效利用这些数据。如果您将客户数据存储在 Segment 中，只需几次点击即可设置与 Pushwoosh 的集成。
集成设置完成后，Segment 将向 Pushwoosh 发送以下数据：
- 用户属性：姓名、设备、偏好、位置、行为等。Pushwoosh 会将这些数据保存为每个用户的标签及其值。
- 事件：每个 Segment 事件都将传输到 Pushwoosh，并以相同的名称保存为 Pushwoosh 事件。Pushwoosh 还会获取每个用户触发了哪些事件的信息。
使用 Segment 数据，您可以在 Pushwoosh 中通过无缝沟通跟进您的受众。以下是利用这两个平台强大功能的两个示例：
1. 基于用户行为数据创建定向营销活动。 使用来自 Segment 的事件数据，在 Pushwoosh 中根据特定的用户行为构建精准的用户细分。
例如，Segment 向 Pushwoosh 发送有关 SubscribedToOffers 事件的数据。您可以在 Pushwoosh 中构建一个由已订阅特别优惠的用户组成的用户细分：
然后，您可以为订阅了您优惠的用户创建引人入胜的客户旅程，包含促销信息和折扣：
2. 基于来自 Segment 的用户属性个性化消息。 您可以利用从 Segment 获取的用户属性来修改推送通知、应用内消息和电子邮件的内容。这将使您能够建立相关且高转化率的沟通。
例如，Segment 向 Pushwoosh 发送 searched_product 属性值。您可以创建一个推送预设，为用户之前搜索过的产品类别提供折扣：
每个用户都将收到一条针对他们之前浏览过的确切产品类别的折扣推送。例如，搜索过运动鞋的用户将看到此消息：
集成概述
Anchor link to集成类型
Anchor link to- 目标 (Destination)：数据从 Segment 发送到 Pushwoosh。
- 来源 (Source)：数据从 Pushwoosh 发送到 Segment。
先决条件
Anchor link to在 Pushwoosh 和 Segment 中均拥有付费账户
同步实体
Anchor link to来源 (Source)
- 推送统计数据
目标 (Destination)
- 设备
- 标签
使用案例
Anchor link to跟踪通知
发送推送通知并跟踪其状态，包括是否成功发送和送达。
事件分析
分析用户触发的事件，例如推送通知或电子邮件送达，并确保这些事件在 Segment 中被准确记录。
用户管理
注册和管理用户信息，包括为用户添加相关属性标签或在需要时删除用户。
设置集成
Anchor link to配置目标 (Destination)
Anchor link to-
在 Segment 界面中，导航至 Connections → Destinations，然后点击 Add Destination。
-
搜索 Pushwoosh 并选择它。
-
选择您想要连接到该目标的来源 (Sources)。
-
进入目标设置：
- 输入 Pushwoosh API 密钥和应用程序代码。确保 Enable Destination 开关已打开。之后，点击 Save Changes。
我在哪里可以找到 API 密钥和应用程序代码？
您可以在 Settings → API Access 部分找到 API 密钥：
应用程序代码可以在 Pushwoosh 界面的左上角，项目名称正下方找到：
- 转到 Mappings 选项卡，并确保 Create or Update User Profile 和 Track Events 选项已启用：
验证从您的来源到 Pushwoosh 作为目标的事件字段映射非常重要，以确保您的事件得到正确处理。
如果事件不包含 device_platform 字段或该字段不正确，您的事件将被忽略。此外，如果事件既不包含 userId 也不包含 deviceId，它也将被忽略。
为确保您的映射配置正确，请转到 Pushwoosh as Destination > Settings。
然后，选择 Mapping 选项卡，并为 Track Events 方法点击 Edit Mapping。
接下来，确保您的事件到发送给 Pushwoosh 的事件的映射是正确的，并且 Device Platform 和 External User ID (或 Device ID) 字段已正确匹配。
您的事件可能与上面提供的示例不同。然而，关键是为发送到 Pushwoosh 的事件匹配平台和设备的数据传输。
如果集成配置正确，Pushwoosh 将开始从 Segment 接收事件和用户属性。基于这些数据，您可以创建高度定向的客户旅程并个性化您的推送通知、应用内消息和电子邮件。
配置来源 (Source)
Anchor link to- 在您的工作区的 Sources catalog 页面中，点击 Add Source。
- 在 Sources Catalog 中搜索“Pushwoosh”，选择 Pushwoosh，然后点击 Add Source。
- 在下一个屏幕上，为来源命名并配置任何其他设置。
- 点击 Add Source 保存您的设置。
- 从 Segment UI 复制 Write key。
- 登录您的 Pushwoosh 账户，并选择您想要连接的应用程序。
- 导航至 Settings > 3rd party integration > Segment，点击 Configure 按钮，然后输入您 Segment 工作区的 Write key。
- 在 Events 字段中，使用
,分隔符列出您想要导出的事件，或者如果您想导出所有事件，则留空，然后点击 Apply。
数据流 (Stream)
Anchor link toPushwoosh 使用 Segment 数据流来源组件来发送 Segment 事件数据。它使用服务器端 track 方法向 Segment 发送数据。这些事件随后在任何接受服务器端事件的目标中可用，并在您的数据仓库的模式中可用。
默认情况下，Pushwoosh 将 Pushwoosh User ID 作为 Segment userId 属性传递。如果没有关联的 User ID，Pushwoosh 将传递 HWID 作为 Segment anonymousId。
下表列出了 Pushwoosh 发送到 Segment 的事件。这些事件在您的仓库中显示为表格，在其他目标中显示为常规事件。
| 事件名称 | 描述 |
|---|---|
| Email Sent | 电子邮件已成功发送 |
| Push Sent | 推送通知已成功发送 |
| SMS Sent | 短信已发送给收件人 |
| Push Opened | 推送通知已被打开 |
| Email Opened | 电子邮件通知已被打开 |
| Email Delivered | 电子邮件已成功送达 |
| Push Delivered | 推送通知已成功送达 |
| SMS Delivered | 短信已成功送达 |
| SMS Not Delivered | 短信发送失败 |
| Email Bounced | 电子邮件因永久性错误被退回给发件人 |
| Email Unsubscribed | 电子邮件退订链接被点击 |
事件属性
Anchor link to下表列出了上述事件中包含的属性。
| 属性名称 | 描述 |
|---|---|
message_type | 包含消息类型（推送、电子邮件、应用内或短信） |
campaign_code | 消息活动的唯一标识符 |
device_type | 设备类型 |
添加目标 (Destinations)
Anchor link to现在您的来源已设置好，您可以将其与目标连接。
登录您的下游工具，检查您的事件是否按预期显示，以及它们是否包含您期望的所有属性。如果您的事件和属性没有出现，请检查事件交付 (Event Delivery)，并参考每个工具的目标文档进行故障排除。
如果事件到达 Segment 的方式有任何问题，请联系我们的支持团队。
集成如何工作
Anchor link to- 推送通知启动：客户端通过 Pushwoosh 界面启动推送通知流程。
- 事件生成：Pushwoosh 后端处理推送通知请求并生成一个事件。此事件随后被发送到由 Pushwoosh 管理的名为
channels-tracking-log的 Kafka 主题。 - 事件消费：Segment 集成服务持续监听
channels-tracking-logKafka 主题，并在事件到达时消费它们。 - 事件处理：消费的事件由 Segment 集成服务处理，该服务将其转换为 Segment Track Events。
- 事件传输：处理后的 Segment Track Events 随后被发送到 Segment 后端进行进一步处理和分析。
如何知道集成是否正常工作？
Anchor link to目标 (Destination)
Anchor link totrack-user
Anchor link to前往您的 Pushwoosh 账户 > 您连接的应用程序 > Audience > User Explorer。找到您的用户/设备并检查 Segment 发送的标签。
post-event
Anchor link to前往您的 Pushwoosh 账户 > 您连接的应用程序 > Audience > Events。选择事件，点击三点菜单，然后选择 Event Statistics。确保事件已被计数。
delete-user
Anchor link to前往您的 PW 账户 > 您连接的应用程序 > Audience > User Explorer。确保用户/设备不存在。
来源 (Source)
Anchor link to使用来源调试器来检测从 Pushwoosh 发送到 Segment 的事件。
故障排除
Anchor link to检查集成状态
Anchor link to要对 Pushwoosh 集成问题进行故障排除，请首先验证以下内容：
目标 (Destination)
- Track-User：在 Pushwoosh 的
Audience > User Explorer下验证用户/设备信息和标签。 - Post-Event：通过检查事件统计数据，确保事件在 Pushwoosh 中被计数。
- Delete-User：确认用户/设备在 Pushwoosh 中已不存在。
来源 (Source)
使用 Segment Debugger 的来源调试器检查来自 Pushwoosh 的事件是否正确发送到 Segment。
事件不匹配
Anchor link to如果事件在 Segment 中未正确显示，请确保 Pushwoosh 事件已按照提供的映射规则正确映射到 Segment Track Events。
身份验证问题
Anchor link to验证向 Pushwoosh 和 Segment 发出的请求中是否使用了正确的身份验证令牌或 API 密钥。
数据流问题
Anchor link to确认 Pushwoosh 和 Segment 之间的数据流未中断，并且 Kafka 主题正在被正确监控。
常见问题解答
Anchor link to从 Pushwoosh 发送到 Segment 的事件类型有哪些？
Anchor link to诸如 Push Sent、Email Sent、SMS Sent、Push Delivered、Email Delivered、SMS Delivered 和 Email Bounced 等保留事件会被发送到 Segment。
如何验证事件是否已正确发送到 Segment？
Anchor link to使用 Segment 来源调试器检查从 Pushwoosh 发送的事件，并查看您 Pushwoosh 账户中的事件统计数据，以确保它们被正确计数。
如果我遇到集成问题该怎么办？
Anchor link to通过在 Pushwoosh 中验证用户/设备信息、事件计数和用户删除情况来检查集成状态。此外，确保使用了正确的身份验证令牌并且数据流未中断。
在集成中如何处理用户和设备信息？
Anchor link to用户和设备信息，包括属性和标签，会根据来自 Segment 的请求在 Pushwoosh 中注册或更新。请注意，默认标签不会在 Pushwoosh 中自动创建。
我在哪里可以找到集成的详细文档？
Anchor link to详细文档可在 Segment 和 Pushwoosh 的集成手册以及它们各自的 API 文档中找到。