跳到内容

连接内容

连接内容是 Liquid 模板中的一项功能,允许您直接在电子邮件或推送通知消息中动态检索和使用来自外部源(如 Web 服务)的数据。此功能通过从指定 URL 获取 JSON 数据并将其保存到可在内容中使用的变量中,从而实现实时个性化。

主要用例

Anchor link to
  • 产品推荐:显示为每个用户量身定制的个性化产品列表。

  • 促销代码:插入由后端服务生成的唯一促销代码。

先决条件

Anchor link to
  • 要使用连接内容,您必须拥有自己的后端服务,该服务根据 User ID、HWID 或自定义标签生成并提供所需的数据(例如,促销代码、产品推荐)。然后,Pushwoosh 在发送消息之前获取此数据。

分步实施指南

Anchor link to

步骤 1. 设置后端服务

Anchor link to

后端服务应:

  • 接受包含用户特定参数(例如,userId)的请求。连接内容支持 UserID、HWID 或您在项目中设置的任何自定义标签。
  • 返回包含所需数据的 JSON 响应。然后,此内容可以动态插入到消息中。

步骤 2. 在 Pushwoosh 中创建带有连接内容的预设

Anchor link to
  1. 在 推送 或 电子邮件内容编辑器 中,将连接内容语法插入到消息字段中。

示例

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

语法分解

connected_content从指定的后端 URL 获取 JSON 数据。
http://your-backend-url.com以 JSON 格式返回所需数据的后端端点。
userId={{ ${userid} }}一个动态查询参数,用于将用户 ID 传递给后端。在 connected_content 内,请将变量包裹在 ${} 中。在消息文本中,请写 {{userid}},不带 ${}。
:save result将获取的 JSON 响应存储在 result 变量中,以供在 Liquid 模板中使用。

插入连接内容语法

身份验证(可选)

如果您的后端服务需要身份验证,您可以在连接内容请求中包含 API 密钥或令牌,以确保安全访问。

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

您还可以使用可选的 :headers 参数(一个包含标头名称和值的 JSON 对象)将身份验证(或任何其他)数据作为 HTTP 标头发送。

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :headers {"Authorization": "Bearer YOUR_TOKEN", "X-Api-Key": "YOUR_API_KEY"} :save result %}
:headers {...}随请求发送的 HTTP 标头的 JSON 对象,例如 Authorization: Bearer <token>。

在连接内容中使用标签

要包含标签值,请以相同的 {{ ${tag_name} }} 形式将其作为查询参数添加到 URL 中。如果在 connected_content 标签内写成 {{ tag_name }},发送的值将为空。

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&lang={{ ${Language} }} :save result %}
  1. 接下来,添加包含检索到的数据的消息文本,如下所示:
嘿,{{userid}},获取您的个人促销代码 - {{result.code}}

添加带有检索到的数据的消息文本

  1. 在最终确定消息内容并配置预设设置后,保存它以便在营销活动中重复使用。

步骤 3. 使用配置的预设发送消息

Anchor link to

使用 一次性推送 或 电子邮件表单 或 customer journey 发送带有此预设的消息。