跳到内容

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
  1. 从 Integrations 部分拖动 Amplitude:设置用户属性 到画布上。
  2. 双击该节点并输入 步骤名称 (Step Name)。
  3. 在 API 密钥 (API key) 中,输入来自 Amplitude 的项目 API 密钥:Settings > Projects > your project > General。它会像 webhook 密钥标头一样被屏蔽存储。Pushwoosh 在保存后绝不会显示或返回它,它也绝不会出现在节点的已存储请求或 调用日志 中。
Amplitude 设置用户属性抽屉,其中步骤名称已填写,API 密钥被屏蔽
  1. 在 Amplitude 端点 (Amplitude endpoint) 中,选择创建 Amplitude 项目时所在的区域:美国项目为 api2.amplitude.com,欧盟项目为 api.eu.amplitude.com。一个区域的密钥会被另一个区域拒绝。
Amplitude 端点字段设置为 api2.amplitude.com
  1. 在 用户属性 (User properties) 中,为要在 Amplitude 个人资料上设置的每个属性添加一行。输入属性名称和值。名称必须非空且唯一。如果值是单个旅程参与者宏,它在 Amplitude 中会保持其自身类型({{tag:Age}} 会以数字形式到达,{{tag:Trial Ends}} 会以日期形式到达)。任何其他文本都将作为字符串发送。宏的语法与 Webhook 主体相同。或者,点击 插入动态值 (Insert Dynamic Value) 来选择此 Journey 中先前步骤产生的属性,例如 LLM 响应或映射的 Webhook 值。
用户属性表,其中 user_id 和 plan 映射到设备和标签宏
  1. 点击 保存 (Save)。

旅程参与者会继续前往您在画布上连接的下一个步骤。

步骤运行后的属性

Anchor link to
属性包含内容
amplitude_events_ingestedAmplitude 摄取的事件数量

如何在后续步骤中使用

Anchor link to

无论此属性如何,旅程参与者都已继续到下一个步骤。如果您需要确认更新已被摄取或使用 条件分支 对其进行分支,请使用 更新用户个人资料 将其保存到标签中。

失败和意外响应

Anchor link to

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

示例场景:保持订阅者的 Amplitude 个人资料同步

Anchor link to

一个团队希望旅程参与者的套餐等级在 Pushwoosh 中发生变化后,能立即在其 Amplitude 个人资料上更新。

  1. 在套餐等级发生变化的步骤之后,立即添加 Amplitude:设置用户属性。在 用户属性 (User properties) 中,将 plan 设置为 {{tag:Plan}}。
  2. 点击 保存 (Save)。

此操作运行后,Amplitude 个人资料将反映套餐变化,无需单独的同步作业。