PAR Punchh 数据参考

预计阅读 7 分钟 | 更新于 2026年5月19日 3:09 PM EST

你将会学到

了解哪些数据从 PAR Punchh 同步到 Klaviyo 以及在哪里查看这些数据。这包括与帐户活动、奖励和签到相关的数据。如果您还没有阅读我们的PAR Punchh 入门 指南，了解有关集成的分步说明，然后再继续阅读本文。

如何查看您的数据

要查看您的 PAR Punchh 数据：

  1. 单击左侧导航侧栏中的分析下拉列表。
  2. 选择指标。在这里，您可以查看帐户中的所有指标。
  3. 使用搜索栏旁边的过滤器选择器并选择 PAR Punchh 来过滤此视图以查看 PAR Punchh 指标。
Klaviyo help center screenshot
Klaviyo help center screenshot

同步指标

已注册

当客户注册您的 PAR Punchh 忠诚度计划时，就会发生此事件。您可以根据以下条件过滤和定位注册事件：

  • 电子邮件确认 URL

    • 电子邮件确认网址

  • 营销电子邮件订阅

    • 最终用户是否订阅了营销电子邮件

  • 营销推送订阅

    • 最终用户是否订阅了营销推送通知

  • 短信订阅

    • 最终用户是否订阅了短信服务

兑换指标

创建救赎，更新救赎

这些事件在客户创建和更新兑换时发生。您可以根据以下条件过滤和定位兑换事件：

  • 条形码

    • 为订单生成的条形码

  • 频道

    • 兑换渠道（即POS、网上订单）

  • 到期日期

    • 兑换代码在时间戳上到期

  • 位置 ID

    • 兑换发生地点的 ID

  • 地点名称

    • 兑换发生地点的名称

  • 附加属性

    • 在配置的情况下填充兑换满足密钥

  • 管理员 ID

    • 创建兑换码的管理员 ID

  • 创建于

    • 兑换代码在时间戳创建

  • 过期于

    • 兑换代码在时间戳处过期

  • 强制消息

    • 强制兑换时的消息

  • 内部跟踪代码

    • 为优惠生成的兑换跟踪代码（即奖励或可兑换或银行奖励）

  • 兑换代码

    • 兑换代码

  • 更新于

    • 兑换代码在时间戳创建

  • 请求积分

    • 订单上要求兑换的积分

  • 可兑换ID

    • 兑换ID

  • 可兑换名称

    • 可赎回的名称

  • 可赎回财产
  • 兑换积分

    • 订单上兑换的积分

  • 兑换代码 ID

    • PAR Punchh 为优惠生成的兑换代码 ID（即奖励或可兑换或银行奖励）

  • 兑换代码通行证
  • 兑换ID

    • 在 PAR Punchh 中生成用于兑换的唯一兑换 ID

  • 兑换状态

    • 兑换状态（即已兑换、已过期、可兑换、已转让、强制\_兑换、已取消）

  • 兑换类型

    • 兑换类型（即 BankedRewardRedemption、RedeemableRedemption、兑换、RewardRedemption）

  • 奖励ID

    • 兑换奖励时的奖励ID

  • 商店号码

    • 兑换发生地点的店铺编号

  • 转移到ID

    • 转移类型的 ID（即社会事业活动的活动 ID）

  • 转移到类型

    • 转移类型（即社会事业活动）

  • 网络

    • 是否通过 iFrame 兑换

应用赎回

应用兑换时会生成此事件。您可以根据以下条件过滤和定位已应用的兑换事件：

  • 折扣金额

    • 与兑换相关的折扣金额

  • 内部跟踪代码

    • 为优惠生成的兑换跟踪代码（即奖励或可兑换或银行奖励）

  • 地点名称

    • 报到地点名称

  • 处理于

    • 处理兑换时的时间戳

  • 奖励名称

    • 奖励名称

签到指标

签到是为了忠诚，签到是为了礼物

当用户签入忠诚度计划或领取特定礼物时，就会发生这些事件。 您可以根据以下条件过滤和定位签入事件：

  • 已批准

    • 值机批准状态

  • 活动 ID

    • 在 PAR Punchh 中创建的活动 ID

  • 活动名称

    • 活动名称

  • 活动类型

    • 活动类型

  • 频道

    • 办理登机手续的渠道（即 POS、OnlineOrder、Web、移动设备）

  • 登记入住 ID

    • PAR Punchh 生成的唯一签到 ID

  • 入住类型

    • OnlineCheckin、PosCheckin、ReceiptImageCheckin、BarcodeCheckin、QrcodeCheckin、POSConsoleCheckin

  • 可赚取金额

    • 可赚取金额基于订单的赚取资格

  • 首次在商务中心办理入住

    • 表示是否是该企业的首次入住

  • 首次入住地点

    • 表示是否是该位置的首次签到

  • 礼物原因

    • 向用户赠送积分的赠送理由

  • 按类型天赋

    • 礼物类型（即管理、签到等）

  • 天赋类型

    • 送礼类型（即群发送礼、反馈回复、游戏等）

  • 物品

    • 菜单项对象

  • 位置 ID

    • PAR Punchh 中生成的位置 ID

  • 地点名称

    • 报到地点名称

  • 手册
  • 获得积分

    • 订单赚取的积分

  • 花费积分

    • 订单上兑换的积分

  • PAR 打孔钥匙

    • 为订单生成的唯一 PAR Punchh 密钥

  • 收据金额

    • 订单收据金额

  • 兑换ID

    • 如果订单上的兑换已完全兑换，则会填充兑换 ID

  • 商店号码

    • 地点的店铺编号

  • 条形码

    • 为订单生成的条形码

  • 创建于

    • 在 PAR Punchh 中创建签到时的时间戳

  • 过期于

    • 入住截止日期

  • 到期日期

    • 入住截止日期

  • 外部 UID

    • 为交易生成的外部 UID

  • 参考 ID

    • 被推荐用户首次签到的签到ID

  • 参考全名

    • 推荐用户姓名

  • 参考用户 ID

    • 推荐用户ID

  • ID 赠予

    • 赠送积分的管理员ID

  • 有ID天赋

    • 礼物类型 ID

  • 二维码解码

    • 为订单生成的二维码值

  • 交易编号

    • 订单交易编号

  • 更新于

    • 签到时的时间戳在 PAR Punchh 中更新

  • 收货日期

    • 订单的接收日期/时间

  • 待刷新

    • 根据待处理点配置启用

  • 未经验证的收据金额

    • 手动签入时填充的收据\_金额（即基于收据图像验证）

  • 刷新于

    • 签到刷新时间戳

  • 验证计数

    • 如果多个审阅者或管理员批准了签到（适用于基于收据图像验证的签到），则此计数会增加。 – 验证于 签到批准时间戳（适用于基于收据图像验证的签到）

  • 审稿人 ID

    • 验证签到的审核者管理员ID（适用于基于收据图像验证的签到）

在 POS 扫描仪上签到

该事件在 POS 签到后生成。您可以根据积分过滤并定位此签到事件。 – 积分 办理登机手续赚取的积分

奖励指标

获得奖励

这包括在 PAR Punchh 中发生时触发的用户奖励赠送/发放事件。您可以根据以下条件过滤和定位已获奖励事件：

  • 折扣频道

    • 奖励使用渠道。 可能的值为：

  • “online\_only”用于在线订单
  • POS 的“仅离线\_”
  • 两者均为“全部”
  • 礼物原因

    • 向用户赠送奖励的赠送理由

  • 奖励图片网址

    • 描述奖励的图片的 URL

  • 到期于

    • 奖励到期的日期/时间（UTC）

  • 状态

    • 状态包括荣誉、未赎回、活着、灭亡、过期

  • 活动名称

    • 用于奖励的 Punchh 活动名称

  • 活动类型

    • 用于奖励的 Punchh 活动类型

  • 描述

    • 奖励说明

  • 折扣金额

    • 与奖励相关的折扣金额

  • 天赋类型

    • 送礼类型（批量送礼、反馈回复、游戏等）

  • 奖励名称

    • 奖励名称

  • 已兑换奖励积分

    • 兑换奖励积分数量

  • 奖励属性

    • Punchh 中配置的奖励的附加属性

  • 商店号码

    • 存储所有可以兑换奖励的地点的号码

将积分转换为奖励

当客户赚取的积分转化为奖励时，会触发此事件。您可以根据以下条件筛选兑换积分并将其定位为奖励活动：

  • 银行价值

    • 银行奖励的价值

  • 当前银行奖励

    • 银行奖励的当前价值

  • 奖励

其他指标

完成卡

当客人的会员卡完成时会生成此事件。您可以根据以下条件过滤和定位已完成的卡片事件：

  • 卡片完成

    • 是否需要进行单卡完成所需的访问

  • 首张卡提醒

    • 完成第一张卡片后是否发送提醒

  • 第二张卡提醒

    • 完成第二张卡后是否发送提醒

  • 姓名

    • 奖励名称

  • 描述

    • 应用程序中显示的可兑换商品的描述

  • 折扣金额

    • 与可兑换相关的折扣金额

  • 折扣频道

    • 奖励使用渠道。可能的值为：

  • “online\_only”用于在线订单
  • POS 的“仅离线\_”
  • 两者均为“全部”
  • 到期日期

    • 可赎回的到期日

  • 兑换所需积分

    • 兑换特定可兑换商品所需的积分价值

  • 可兑换ID

    • 用于识别系统中可兑换的唯一 ID

  • 兑换到期

    • 可赎回的到期日

  • 状态

    • 可兑换状态包括：已激活、已停用、草稿、已过期

  • 适用于忠诚度兑换

    • 是否允许兑换忠诚度奖励

  • 创建于

    • 为系统中的最终用户创建可兑换的日期和时间

  • 使兑换代码失效并指定奖励结束日期

    • 兑换代码是否与奖励结束日期一起过期

  • 元数据

    • 可以添加到可兑换的元数据。这可用于对移动应用程序进行编程，使其在从服务器接收到特定数据时具有某些行为，或者可以根据业务需要使用。这可以从 PAR Punchh 仪表板进行配置，最大长度为 255 个字符。 – 更新于 为系统中的最终用户更新可兑换内容的日期和时间。 – 可兑换图像 URL：应用程序中显示的用于描述可兑换的图像的 URL

  • 可赎回财产

    • 添加到特定可兑换商品的属性，例如“商品”、“食品”等

同步对象

奖励

当在 Klaviyo 中创建的 Punchh 活动通过 Punchh 忠诚度计划向客户发放奖励时，将同步此对象。只要 Punchh 中的奖励更新，该对象就会更新。有关如何在 Klaviyo 中使用对象的更多信息，请浏览这些文章。您可以根据以下条件过滤和定位奖励对象：

  • 奖励ID

    • 奖励的唯一ID。 – 描述 奖励说明

  • 礼物原因

    • 向用户赠送奖励的赠送理由

  • 奖励名称

    • 奖励名称

  • 到期时间

    • 奖励到期的日期/时间

  • 状态

    • 状态包括：荣誉、未赎回、灭亡、过期

  • 活动名称

    • Punchh 活动的名称

  • 活动类型

    • 告知最终用户获得奖励的活动类型。目前，唯一可能的价值是“忠诚”。 – 奖励图片URL 描述奖励的图片的 URL

  • 折扣频道

    • 奖励使用渠道。可能的值为：“online\_only”、“offline\_only”、“all”。 – 折扣金额 与奖励相关的折扣金额

  • 类型天赋

    • 送礼类型

  • 兑换奖励积分

    • 通过此奖励兑换的奖励积分

  • 奖励属性

    • 可以在 Punchh 平台中配置的奖励的其他属性（例如“商品”、“提前订购”、“促销”等）

同步访客数据

除了 Klaviyo 从 PAR Punchh 同步的指标之外，Klaviyo 还将为我们同步的每个客户创建一个独特的配置文件。当我们同步联系信息时，还会将某些自定义属性添加到每个 Klaviyo 个人资料中。您可以在段和流中使用这些属性。以下是从 PAR Punchh 自动同步的属性：

  • 电子邮件
  • 电话号码
  • 名字
  • 姓氏
  • 潘奇周年纪念日
  • 生日
  • 性别
  • 打孔客人类型
  • Punchh 加入于
  • 打卡上次活动时间
  • 打卡最喜欢的地点
  • Punchh 最喜欢的商店号码
  • 首选语言
  • Punchh 推荐码
  • Punchh 注册频道
  • Punchh 退订原因
  • Punchh 取消订阅状态
  • 打孔 ID
  • Punchh用户状态
  • Punchh会员级别
  • 打孔上次访问
  • Punchh 忠诚度积分
  • 打孔总学分
  • Punchh 终生总积分
  • Punchh 总积分
  • Punchh 总访问量
  • Punchh 无银行账户积分

电子邮件同意从 Punchh 同步到 Klaviyo。请注意，我们不会同步 Punchh 的短信同意。