Amplitude 集成

需要开发者协助

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

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

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

集成概述

集成类型

目标： 数据从 Amplitude 发送到 Pushwoosh。

先决条件

要设置从 Amplitude 到 Pushwoosh 的事件流和同期群同步集成，请确保满足以下先决条件：

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

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

Amplitude 中的 Cohorts = Pushwoosh 中的 Segments

同步的实体

• 事件
• 标签
• 细分

集成如何工作？

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

数据传输

• 事件：Amplitude 将事件数据发送到 Pushwoosh。每个事件包含一个用户 ID (external_id)、一个应用代码 (app_id)、一个时间戳 (created_at) 和其他属性 (attributes)。

• 标签：Pushwoosh 接收与用户个人资料关联的标签。这些标签与用户 ID (external_id)、应用代码 (app_id) 和标签属性 (properties) 一起发送。

• 细分：细分的导入方式与 Pushwoosh 处理 CSV 导入的方式类似。用户通过请求被添加或从细分中移除。

数据流

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

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

请求

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

用例

事件跟踪

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

用户打标

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

细分管理

根据 Amplitude 中配置的数据和细分，在 Pushwoosh 中创建和管理用户细分。这有助于通过个性化消息定位特定用户群体。

自动化用户管理

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

设置集成

同期群同步

Pushwoosh 设置

1. 在 Pushwoosh 中，导航至 Settings > Integrations。
2. 点击 Add Integration，然后找到并添加 Amplitude。

3. 将 Pushwoosh API Key 和 App Code 复制到剪贴板。

Amplitude 设置

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

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

3. 点击 Add another destination。

4. 提供一个名称并粘贴您从 Pushwoosh 复制的 API 密钥。

5. 将 Amplitude User ID 字段映射到 Pushwoosh User ID 字段。
6. 完成后保存您的设置。

发送同期群

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

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

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

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

事件流

Pushwoosh 设置

1. 获取您的 Pushwoosh API 密钥

2. 在您的 Pushwoosh 帐户中找到应用代码。

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. 如果您想将事件流式传输到 Pushwoosh，请启用 Send Events（“事件被发送到 Pushwoosh”）。这将在事件被 Amplitude 接收时自动转发到 Pushwoosh。使用此集成，事件不会按计划或按需发送。

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

如何知道集成是否正常工作？

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

监控 Pushwoosh 控制面板

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

检查 API 响应

• 成功响应：确保您从 Pushwoosh API 端点收到 200 OK 响应。虽然可能不总是有响应体，但 200 OK 状态表示请求已成功接收。
• 错误响应：如果出现问题，请检查任何错误响应或除 200 OK 之外的状态码以寻找线索。常见错误可能包括 400 Bad Request、401 Unauthorized 或 500 Internal Server Error。

记录请求和响应

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

使用示例数据进行测试

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

使用监控工具

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

查阅集成文档

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

联系支持

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

故障排除

集成问题

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

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

细分问题

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

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

响应问题

• 无响应体：如果您收到 200 OK 响应但没有响应体，请验证请求格式是否正确以及数据是否已正确发送。

常见问题解答

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

检查请求有效负载是否存在格式错误或缺少字段。确保所有必填字段都已包含并正确格式化。

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

检查 Pushwoosh 控制面板中是否有传入的事件、标签和细分更新。您还可以监控 API 端点的日志或响应，以确认数据传输成功。

我可以自定义发送到 Pushwoosh 的事件或标签吗？

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

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

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

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

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