Amplitude:设置用户属性
使用 Amplitude:设置用户属性,通过 HTTP API V2 的 $identify 操作,从 Journey 步骤中更新旅程参与者的 Amplitude 用户个人资料,以便 Amplitude 端的细分和同期群能看到与 Pushwoosh 相同的数据。
Pushwoosh 会根据旅程参与者和此步骤为您设置 Amplitude 的 insert_id。这意味着,同一个旅程参与者两次通过此确切节点(例如,在循环 Journey 的第二圈),会更新同一个 Amplitude 个人资料,而不是写入一个重复的 identify 事件。
典型用途:
- 将标签同步到 Amplitude 细分中: 将套餐等级、试用状态或其他标签推送到 Amplitude 个人资料上,使 Amplitude 同期群与 Pushwoosh 受众匹配。
- 无需单独的同步作业即可保持个人资料为最新: 在标签发生变化的 Journey 步骤中,立即更新个人资料。
- 避免在循环中重复调用 identify: 内置的去重功能意味着重复通过此节点会更新同一个个人资料,而不是写入两次。
配置节点
Anchor link to- 从 Integrations 部分拖动 Amplitude:设置用户属性 到画布上。
- 双击该节点并输入 步骤名称 (Step Name)。
- 在 API 密钥 (API key) 中,输入来自 Amplitude 的项目 API 密钥:Settings > Projects > your project > General。它会像 webhook 密钥标头一样被屏蔽存储。Pushwoosh 在保存后绝不会显示或返回它,它也绝不会出现在节点的已存储请求或 调用日志 中。

- 在 Amplitude 端点 (Amplitude endpoint) 中,选择创建 Amplitude 项目时所在的区域:美国项目为
api2.amplitude.com,欧盟项目为api.eu.amplitude.com。一个区域的密钥会被另一个区域拒绝。

- 在 用户属性 (User properties) 中,为要在 Amplitude 个人资料上设置的每个属性添加一行。输入属性名称和值。名称必须非空且唯一。如果值是单个旅程参与者宏,它在 Amplitude 中会保持其自身类型(
{{tag:Age}}会以数字形式到达,{{tag:Trial Ends}}会以日期形式到达)。任何其他文本都将作为字符串发送。宏的语法与 Webhook 主体相同。或者,点击 插入动态值 (Insert Dynamic Value) 来选择此 Journey 中先前步骤产生的属性,例如 LLM 响应或映射的 Webhook 值。

- 点击 保存 (Save)。
旅程参与者会继续前往您在画布上连接的下一个步骤。
步骤运行后的属性
Anchor link to| 属性 | 包含内容 |
|---|---|
amplitude_events_ingested | Amplitude 摄取的事件数量 |
如何在后续步骤中使用
Anchor link to无论此属性如何,旅程参与者都已继续到下一个步骤。如果您需要确认更新已被摄取或使用 条件分支 对其进行分支,请使用 更新用户个人资料 将其保存到标签中。
失败和意外响应
Anchor link to失败的请求会将旅程参与者从 Journey 中移除。请参阅 错误和失败的请求。
示例场景:保持订阅者的 Amplitude 个人资料同步
Anchor link to一个团队希望旅程参与者的套餐等级在 Pushwoosh 中发生变化后,能立即在其 Amplitude 个人资料上更新。
- 在套餐等级发生变化的步骤之后,立即添加 Amplitude:设置用户属性。在 用户属性 (User properties) 中,将
plan设置为{{tag:Plan}}。 - 点击 保存 (Save)。
此操作运行后,Amplitude 个人资料将反映套餐变化,无需单独的同步作业。