Amplitude：跟踪事件

使用 Amplitude：跟踪事件 通过 HTTP API V2 从旅程步骤向 Amplitude 项目发送一个事件，并附带您列出的属性。

Pushwoosh 会根据旅行者和此步骤为您设置 Amplitude 的 insert_id。这意味着同一个旅行者两次通过这个确切的点（例如，在循环旅程的第二圈），在 Amplitude 中会记录为一个去重后的事件，而不是两个。

典型用途：

• 记录旅程里程碑： 当旅行者到达某个步骤时发送一个事件，这样它就会与您的产品事件一起显示在 Amplitude 漏斗中。
• 填充跨渠道漏斗： 将推送、电子邮件或短信里程碑与应用内事件一起记录，以便在 Amplitude 中获得统一的漏斗视图。
• 安全地跟踪循环旅程： 内置的去重功能意味着循环回到此步骤的旅行者仍然只会被记录为一个事件，而不是多个。

配置点

1. 从 集成 部分将 Amplitude：跟踪事件 拖到画布上。
2. 双击该点并输入 步骤名称。
3. 在 API 密钥 中，输入来自 Amplitude 的项目 API 密钥：设置 > 项目 > 您的项目 > 常规。它会像 webhook 密钥头一样被屏蔽存储。Pushwoosh 保存后绝不会显示或返回它，并且它也绝不会出现在该点的存储请求或 调用日志 中。

4. 在 Amplitude 端点 中，选择创建 Amplitude 项目时所在的区域：美国项目选择 api2.amplitude.com，欧盟项目选择 api.eu.amplitude.com。一个区域的密钥会被另一个区域拒绝。

5. 在 事件名称 中，输入事件在 Amplitude 中应显示的名称，例如 journey_welcome_push_sent。它接受与 事件属性 相同的宏。

6. 在 事件属性 中，为要随事件发送的每个属性添加一行。输入属性名称和值。名称必须非空且唯一。如果值是单个旅行者宏，它在 Amplitude 中会保留其自身类型（{{tag:Age}} 作为数字到达，{{tag:Trial Ends}} 作为日期到达）。任何其他文本都作为字符串发送。宏使用与 Webhook 主体相同的语法。或者单击 插入动态值 来选择此旅程中先前步骤产生的属性，例如 LLM 响应或映射的 Webhook 值。

示例

将 事件属性 设置为 plan，值为旅行者的套餐等级 ({{tag:Plan}})，会将该属性随事件发送到 Amplitude。

7. 点击 保存。

响应

旅行者会继续前进到您在画布上连接的下一个步骤。

步骤运行后的属性

属性	其包含的内容
amplitude_events_ingested	Amplitude 接收的事件数量

如何在后续步骤中使用它

无论此属性如何，旅行者都已继续到下一步。如果您需要确认事件已被接收或使用 条件拆分 对其进行分支，请使用 更新用户资料 将其保存到标签中。

失败和意外响应

失败的请求会将旅行者从旅程中移除。请参阅 错误和失败的请求。

示例场景：将旅程发送记录到 Amplitude 漏斗中

一个团队希望欢迎推送的发送能与他们的其他产品事件一起显示在同一个 Amplitude 漏斗中。

1. 在旅程中事件应触发的点添加 Amplitude：跟踪事件。将 事件名称 设置为 journey_welcome_push_sent。
2. 点击 保存。

一旦运行，该发送事件就会与其余产品事件一起显示在 Amplitude 中，这样漏斗就能反映出全貌，而不是因为旅程步骤未报告而出现空白。