中文
USD - $
联系支持 支持
KWIGA 帮助中心 服务、集成、API、设置 通用设置 项目中使用变量，可用变量列表

项目中使用变量，可用变量列表

文章:

13小时前 • 已更新

本文解释了如何在项目中使用变量 — 变量适用于哪些地方、可用的数据有哪些，以及如何将其用于自动化和个性化。包括适用于电子邮件、Webhooks、按钮、课程等元素的变量列表、描述和示例。

在这篇文章中:

变量的基本信息

变量是将个性化数据插入到项目不同元素中的便捷方式。它们可以用于以下地方：

1. 自动化中的Webhook

变量可以插入：

  • 在Webhook的URL中，例如：
    https://example.com/hook?user={user.email}
    在请求体参数或头部中

这可以自动将个性化数据传递给第三方服务。

2. CTA（号召性用语）

在按钮和链接中可以使用变量来：

  • 个性化按钮文本

  • 通过链接传递数据，例如用户ID或UTM标签

3. 在参数中

变量可以用于表单或其他元素的参数中：

  • 用户email

  • 订阅ID

  • 唯一代码和标签

  • 在上下文中可用的任何其他变量

4. 在重定向链接中（如果不用于支付跳转）

可以手动在重定向链接中添加变量：

https://my.site.com/thanks?email={user.email}&course={course.title}

5. 在课程信息块中

变量在信息块文本中有效。例如：

  • 按名字称呼：你好，{user.first_name}!

  • 显示课程名称、日期、状态等。

6. 在邮件中

在邮件中使用变量可以使沟通更加个性化和有效。通过使用变量，如{名字}、{日期}或{课程名称}，邮件看起来像是专门为客户定制的。这提高了信任度、参与度以及用户阅读邮件到最后或执行所需操作的可能性。此外，变量简化了大规模邮件发送的自动化，而不失个性化。

可用变量列表

在所有可以使用变量的地方可用的变量列表。

变量 值
contact.id 联系人ID
contact.user_id 用户ID
contact.first_name 联系人名字
contact.last_name 联系人姓氏
contact.name 联系人全名
contact.email 联系人Email
contact.phone 联系人电话
contact.country 联系人国家。例如：乌克兰
contact.timezone 联系人时区。例如：Europe/Kyiv
contact.currency 联系人货币。例如：USD
contact.city 联系人城市
contact.utm_source 联系人唯一utm_source列表（分隔符", ")
contact.utm_medium 联系人的唯一 utm_medium 列表（分隔符 ", ")
contact.utm_campaign 联系人的唯一 utm_campaign 列表（分隔符 ", ")
contact.utm_term 联系人的唯一 utm_term 列表（分隔符 ", ")
contact.utm_content 联系人的唯一 utm_content 列表（分隔符 ", ")
contact.field_<id> 自定义字段（描述如下）
datetime UTC 日期和时间格式 YYYY-MM-DD HH:mm:ss
contact.visit_source 访问来源

自定义字段

{contact.field_<id>}

示例 {contact.field_123}

<id> - 可以在联系人字段设置中获取的字段ID (示例 https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

可以在CTA中额外使用的变量

  • 在参数中

  • 在重定向链接中（如果不用于支付跳转）

变量 值
first_name 申请中的名字
last_name 申请中的姓氏
name 申请中的全名
email 申请中的 Email
phone 申请中的电话
utm_source utm_source - 提交申请时的具体访问
utm_medium utm_medium - 提交申请时的具体访问
utm_campaign utm_campaign - 提交申请时的具体访问
utm_term utm_term - 提交申请时的具体访问
utm_content utm_content - 提交申请时的具体访问
widget_landing 提交申请的着陆页 Url
widget_landign_referer 提交申请时着陆页的 Referer

在某些表单中，可能会提供以下描述的变量，这些变量在自动化Webhook中可用

按订单({order.*}) - 如果选择了产品访问表单选项（完全访问/按提议）

按产品({product.*}) - 如果选择了产品访问表单选项 + 完全访问

按提议({offer.*}) - 如果选择了产品访问表单选项 + 按提议

如果在放置CTA或Kwiga脚本以跟踪访问的页面上有带utm标签的访问，并且客户在着陆页上提交了没有utm标签的请求，则这些变量中将不存在它们。但它们将在上面描述的{contact.utm_...}变量中可用。

表单CTA变量

变量 值
cta.id 表单CTA ID
cta.uuid 表单CTA UUID
cta.title 表单CTA名称
cta_request.form_data 用户输入的数据列表（以换行符分隔）
列表可以扩展。

在以下事件触发时可用：

  • 留下了CTA申请

自动化Webhook中可用的变量（url，参数）

变量 值
referrer 联系人的首次已知访问的 Referrer（Kwiga / 带有 CTA 的着陆页）
initial_page 联系人的首次已知访问的 Url（Kwiga / 带有 CTA 的着陆页）
reg_from 注册页面的 Url（Kwiga / 带有 CTA 的着陆页）
tags 联系人的标签（分隔符 ", ")
description 触发自动化的事件描述。例如：已为联系人添加标签 test_tag

产品变量

变量 值
product.id 产品 ID
product.title 产品名称
product.productable_type 产品类型。可能的选项有：course, webinar, closed_group, custom_product
product.productable_id 课程/网络研讨会/封闭群组/自定义产品的 ID

在以下事件触发时可用：

  • 产品访问已开放
  • 产品访问已关闭
  • 注册了网络研讨会
  • 课程已完成
  • 测验进行中
  • 取消之前的测验结果
  • 测验状态变更
  • 订阅访问开始
  • 订阅访问结束
  • 开始观看课程
  • 观看了课程
  • 课程访问已开放
  • 课程实践已完成

订单变量

变量 值
order.id 订单 ID
order.price 最终价格。示例 10.99
order.currency_code 订单货币的代码格式。示例：USD
order.currency_symbol 订单货币的符号格式。示例：$
order.currency_short_title 订单货币的缩写名称。示例：usd
order.order_stage_id 漏斗状态 ID
order.order_stage_title 漏斗状态名称
order.funnel_id 漏斗 ID
order.funnel_title 漏斗名称
order.paid_status 订单支付状态 not_paid / partial_paid / paid
order.paid_status_title 英文支付状态
列表可以扩展。

在以下事件触发时可用：

  • 订阅已开始
  • 订阅已续订
  • 订单支付成功
  • 新订单
  • 报价支付成功
  • 报价退款
  • 产品访问已开放
  • 订阅访问开始
  • 订阅访问结束

支付变量

变量 值
payment.id 支付 ID
payment.price 支付金额
payment.currency_code 支付货币的代码格式。示例：USD
payment.currency_symbol 支付货币的符号格式。示例：$
payment.currency_short_title 支付货币的缩写名称。示例：usd
payment.created_at 支付创建日期。格式 YYYY-MM-DD HH:mm:ss
payment.paid_at 支付日期。格式 YYYY-MM-DD HH:mm:ss
payment.schedule_payment_at 计划支付日期。格式 YYYY-MM-DD HH:mm:ss
платіж.номер 订单中的支付序号
列表可以扩展。

在以下事件触发时可用：

  • 报价支付成功
  • 报价退款

优惠变量

变量 值
offer.id 提案 ID
offer.title 提案名称
列表可以扩展。

在以下事件触发时可用：

  • 报价支付成功
  • 报价退款
  • 接受免费报价
  • 订阅已开始
  • 订阅已续订
  • 订单支付成功
  • 新订单
  • 产品访问已开放
  • 订阅访问开始
  • 订阅访问结束

产品订阅变量

变量 值
subscription.id 产品订阅ID
subscription.start_at 订阅开始日期。YYYY-MM-DD HH:mm:ss
subscription.end_at 订阅最终结束日期。YYYY-MM-DD HH:mm:ss
subscription.order_end_at 仅考虑已支付款项的订阅结束日期。YYYY-MM-DD HH:mm:ss
subscription.paid_at 订阅首次付款日期。YYYY-MM-DD HH:mm:ss
列表可以扩展。

在以下事件触发时可用：

  • 产品访问已开放
  • 订阅访问开始
  • 订阅访问结束

测验尝试变量

变量 值
quiz_attempt.id 尝试ID
quiz_attempt.number_version 版本号
quiz_attempt.quiz_id 测验ID
quiz_attempt.course_id 课程ID
quiz_attempt.course_lesson_id 课程ID
quiz_attempt.status_id 状态ID
quiz_attempt.status 文本状态
quiz_attempt.scores 得分
quiz_attempt.created_at 尝试开始。格式 YYYY-MM-DD HH:mm:ss
quiz_attempt.finished_at 尝试结束。格式 YYYY-MM-DD HH:mm:ss
quiz_attempt.count_questions 测验中的问题数量
quiz_attempt.count_questions_incorrect 回答错误的问题数量
quiz_attempt.count_questions_correct 正确回答的问题数量
quiz.title 测验名称
列表可以扩展。

在以下事件触发时可用：

  • 测验进行中
  • 取消之前的测验结果
  • 测验状态变更

课程变量

变量 值
lesson.id 课程ID
lesson.title 课程名称
列表可以扩展。

在以下事件触发时可用：

  • 测验进行中
  • 取消之前的测验结果
  • 测验状态变更
  • 开始观看课程
  • 观看了课程
  • 课程访问已开放
  • 课程实践已完成