Amplitude 集成

需要开发者协助

您将需要开发团队的帮助来设置此集成。请与他们分享本指南。

Amplitude 是一个强大的产品分析平台，它使企业能够实时了解用户行为、跟踪产品内互动，并获得有关用户参与度、留存率和收入的宝贵见解。

将 Amplitude 与 Pushwoosh 集成，您可以使用 Amplitude 数据对 Pushwoosh 营销活动进行个性化设置，根据用户行为触发自动化营销活动，分析绩效以持续改进，并最终提高参与度、减少客户流失和增加收入。

集成概述

集成类型

目的地： 数据从 Amplitude 发送到 Pushwoosh。

先决条件

要设置从 Amplitude 到 Pushwoosh 的 Event Streaming 和 Cohort Sync 集成，请确保满足以下先决条件：

• 您需要一个有效的 Pushwoosh 帐户。
• 在 Pushwoosh 中生成一个 API 访问令牌 以发送数据。
• 在配置集成之前，找到您的 Pushwoosh 应用程序代码。
• 此集成仅适用于拥有付费计划的 Amplitude 客户。
• 您必须拥有付费的 Pushwoosh 计划才能使用此集成。

术语表（如果实体名称不同，则进行映射）

Amplitude 中的 Cohorts = Pushwoosh 中的 Segments

同步的实体

• Event
• Tag
• Segment

集成如何工作？

Amplitude 与 Pushwoosh 的集成通过在两个平台之间同步数据来增强用户参与度和细分。以下是其工作原理的详细分解：

数据传输

• Event：Amplitude 将事件数据发送到 Pushwoosh。每个事件包含一个用户 ID (external_id)、一个应用程序代码 (app_id)、事件名称 (event_name)、一个时间戳 (created_at) 和事件属性 (properties)。

  • Pushwoosh 从 properties.platform（iOS、Android 或 Web）获取平台。没有该字段的事件会被记录为 iOS 事件。
  • Pushwoosh 从 properties.device_id 获取设备 ID。没有该字段时，用户 ID 将用作设备 ID。
  • 任何类型的属性值都会被接受，并存储为 Event 属性。数字和布尔值按其文本形式保存，空值 (null) 会被跳过。
  • 首次接收某个事件时，Pushwoosh 会自动创建该 Event。其属性类型根据值推断：日期、整数、布尔值、价格或字符串。当现有 Event 收到新属性时，Pushwoosh 会自动将其添加为 Event 属性，每个 Event 最多 100 个属性。此类属性仅根据文本确定类型，即日期、版本或字符串，因此之后才添加的数值属性会成为字符串属性。

• Tag：Pushwoosh 接收用户属性，并将其保存为该用户的 Tag。每个请求包含一个用户 ID (external_id，必填)、一个应用程序代码 (app_id) 和用户属性 (properties)。

  • 缺失的 Tag 会被自动创建，其类型根据值推断，方式与 Event 属性相同。
  • 与 Pushwoosh 默认 Tag 同名的属性（例如 Language、Country 或 Timezone）会被忽略。

• Segment：对于每个同步的队列，Pushwoosh 会创建一个以该队列名称命名的 Segment。队列成员身份以用户的 CSV import 列表 Tag 的值来存储，用户按 User ID 进行匹配。随着 Amplitude 同步队列，用户会被添加到 Segment 或从中移除。

数据流

• Event 和 Tag：数据根据在 Amplitude 中跟踪的用户互动或属性从 Amplitude 发送到 Pushwoosh。Event 和 Tag 会根据在 Amplitude 中设置的配置和映射在 Pushwoosh 中创建或更新。

• Segment：当 Amplitude 发出请求时，Segment 会在 Pushwoosh 中创建。Pushwoosh 为每个 Segment 生成一个唯一标识符，Amplitude 使用该标识符通过添加或移除用户来操作 Segment。

请求

请求被发送到 Pushwoosh 中的特定端点，以处理 Event、用户属性和 Segment 更新。每个请求都需要身份验证，并具有特定的标头和有效负载格式。

用例

Event 跟踪

从 Amplitude 跟踪用户操作和互动，并将这些 Event 发送到 Pushwoosh 以触发通知或更新。

用户标记

根据用户在 Amplitude 中的行为或属性为用户分配 Tag。这些 Tag 可在 Pushwoosh 中用于定向消息传递或细分。

Segment 管理

根据在 Amplitude 中配置的数据和 Segment，在 Pushwoosh 中创建和管理用户 Segment。这有助于向特定用户群体发送个性化消息。

自动化用户管理

根据用户在 Amplitude 中的操作或属性，自动将用户添加或从 Segment 中移除，确保 Pushwoosh 中的细分保持最新。

设置集成

队列同步

Pushwoosh 设置

1. 在 Pushwoosh 中，于 Settings > API Access 创建或复制一个 API 访问令牌。
2. 复制您要将队列同步到的应用的应用程序代码。

Amplitude 设置

要配置 Amplitude 以进行集成，请按照以下步骤操作：

1. 在您的 Amplitude Data 中，转到 Catalog 并选择 Destinations。
2. 在 Cohort 部分下，找到并点击 Pushwoosh。

3. 点击 Add another destination。

4. 提供一个名称并粘贴您从 Pushwoosh 复制的 API 访问令牌。

5. 将 Amplitude User ID 字段映射到 Pushwoosh User ID 字段。Pushwoosh 按 User ID 匹配队列成员，因此您选择的 Amplitude 字段必须包含与您的应用在 Pushwoosh 中设置为 User ID 的值相同的值。Amplitude 的设置页面说明该字段必须包含电子邮件地址。如果您的应用将其他值设置为 Pushwoosh User ID，队列成员将无法匹配。在这种情况下，请在 Pushwoosh SDK 中将用户的电子邮件设置为 User ID，或联系 Pushwoosh 支持团队。
6. 完成后保存您的设置。

发送队列

要同步您的第一个队列，请完成以下步骤：

1. 在 Amplitude 中，打开您希望同步的队列，然后点击 Sync。

2. 选择 Pushwoosh 并选择您要同步的帐户。然后，点击 Next。

3. 决定同步频率并保存您的配置。

Event 流

Pushwoosh 设置

1. 在 Settings > API Access 中创建或复制一个 API 访问令牌。

2. 复制您应用的应用程序代码。

Amplitude 设置

1. 在 Amplitude 中，转到 Data Destinations 并找到 Pushwoosh - Event Stream。

2. 输入一个同步名称，然后点击 Create Sync。

3. 将状态从 Disabled 更改为 Enabled，并粘贴您的 Pushwoosh API 访问令牌和应用程序代码。

4. 从左侧下拉菜单中，选择与您的 Pushwoosh UserID 对应的 Amplitude 用户属性。
5. （可选）如果您希望在 Amplitude 创建或更新用户属性时实时发送用户及其属性，请启用 Create & Update users 切换开关。

6. 如果您想将 Event 流式传输到 Pushwoosh，请启用 Send Events（“Events are sent to Pushwoosh”）。这将在 Amplitude 中摄取 Event 时自动将其转发到 Pushwoosh。使用此集成时，Event 不会按计划或按需发送。

8. 然后，在 Select and Filter Events 部分中选择您要发送的 Event。只选择您在 Pushwoosh 中需要的 Event；不支持转换后的 Event。
9. 完成后，启用该目的地并点击 Save。

如何判断集成是否正常工作？

要验证 Amplitude 和 Pushwoosh 集成是否正常运行，您可以使用以下方法：

监控 Pushwoosh 控制面板

• Event 和 Tag：检查 Pushwoosh 控制面板，看从 Amplitude 发送的 Event 和 Tag 是否按预期显示。查找与您的 Event 和 Tag 相关的最近活动或更新。
• Segment：验证 Segment 是否根据来自 Amplitude 的数据被创建、更新或修改。确保用户数量和 Segment 成员资格反映了预期的变化。

检查 API 响应

• 成功响应：确保您从 Pushwoosh API 端点收到 200 OK 响应。虽然可能不总是有响应体，但 200 OK 状态表示请求已成功接收。
• 错误响应：如果出现问题，请检查除 200 OK 之外的状态码以寻找线索：
  • 400 Bad Request：请求正文不是有效的 JSON，或缺少用户 ID。
  • 401 Unauthorized：API 令牌或应用程序代码缺失、无效，或令牌属于其他帐户。
  • 503 Service Unavailable：Pushwoosh 暂时无法处理该事件。可以重试该请求。
  • 其他 5xx 代码：在检查 API 令牌、保存 Tag、创建 Segment 或更新队列成员身份时发生内部错误。请稍后重试该请求。
• 因内容原因被 Pushwoosh 拒绝的事件也会收到 200 OK 且不会被处理，因此仅凭 200 OK 无法确认事件已被记录。

记录请求和响应

• 请求日志：维护从 Amplitude 发出的请求和从 Pushwoosh 收到的响应的日志。检查这些日志以确保请求格式正确且响应符合预期。
• 错误日志记录：实施错误日志记录以捕获数据传输或集成过程中的任何问题。

使用示例数据进行测试

• 发送测试 Event/Tag：从 Amplitude 创建并发送测试 Event 和 Tag 到 Pushwoosh。验证这些测试条目是否在 Pushwoosh 中正确显示并触发预期的行为。
• 模拟用户操作：在 Amplitude 中执行应在 Pushwoosh 中触发特定 Event 或更新的操作。检查这些操作是否导致 Pushwoosh 中发生预期的变化。

使用监控工具

• 集成监控：利用可以跟踪集成健康状况和性能的监控工具或服务。这些工具可以实时提醒您问题或故障。
• 分析和报告：使用 Amplitude 和 Pushwoosh 中的分析功能来审查数据流和集成性能。

查阅集成文档

• 配置审查：仔细检查 Amplitude 和 Pushwoosh 中的集成配置，确保所有设置和映射都正确应用。
• 文档更新：随时了解可能影响功能的集成文档中的任何更改或更新。

联系支持

如果您遇到持续的问题或不一致之处，请联系 Amplitude 或 Pushwoosh 的支持团队寻求帮助。向他们提供集成设置的详细信息和任何错误日志，以便更快地解决问题。

故障排除

集成问题

• Event 未在 Pushwoosh 中显示：确保 Event 已正确映射，并验证 Pushwoosh 应用程序代码和 API 令牌是否配置正确。

• Tag 未同步：确认 Tag 格式正确，并且请求中包含了所有必要的身份验证详细信息。

Segment 问题

• Segment 未创建：检查创建 Segment 的请求格式是否正确，以及 Pushwoosh API 令牌是否有效。

• 用户未添加/移除：验证用户 ID 是否正确指定，以及 Segment ID 是否有效。确保请求负载格式正确。

响应问题

• 无响应体：200 OK 响应没有响应体。它并不能确认事件已被记录，因为因内容原因被拒绝的事件也会收到 200 OK（请参阅检查 API 响应）。请按照监控 Pushwoosh 控制面板中的说明，在 Pushwoosh 中检查该事件。

常见问题解答

如果收到 400 Bad Request 错误，我该怎么办？

当请求正文不是有效的 JSON 或缺少用户 ID (external_id) 时，Pushwoosh 会返回 400。请检查 Amplitude 中的用户 ID 映射是否指向每个用户都已填写的属性。

如何验证集成是否正常工作？

检查 Pushwoosh 控制面板中是否有传入的 Event、Tag 和 Segment 更新。您还可以监控来自 API 端点的日志或响应，以确认数据传输成功。

我可以自定义发送到 Pushwoosh 的 Event 或 Tag 吗？

是的，您可以在 Amplitude 配置中自定义 Event 和 Tag。请确保数据符合预期的 Pushwoosh 格式。

Amplitude 和 Pushwoosh 之间的数据同步频率是多久？

数据会根据从 Amplitude 发出的请求进行实时或近实时同步。请确保您的配置支持所需的更新频率。

在哪里可以找到有关此集成的更多信息或支持？

请参阅 Amplitude 和 Pushwoosh 的官方文档。如需进一步帮助，请联系各自的支持团队。