PAR Punchh データリファレンス

このページで学べること

PAR Punchh から Klaviyo へどのようなデータが同期され、どこで閲覧できるかを学びます。これには、アカウントのアクティビティ、特典、チェックインに関するデータが含まれます。

まだの方は、この記事を読み進める前に、まず連携手順を段階的に説明した PAR Punchh のスタートガイドをお読みください。

データの表示方法

PAR Punchh のデータを表示する方法は以下のとおりです。

1. 左側のナビゲーションサイドバーにある [アナリティクス] ドロップダウンをクリックします。
2. [メトリック] を選択します。ここでは、アカウント内のすべてのメトリックを表示できます。
3. Par Punchh のメトリックだけを表示するには、検索バーの横にあるフィルターセレクターで [PAR Punchh] を選択してください。
   

同期されるメトリック

登録済み

このイベントは、顧客が PAR Punchh ロイヤルティプログラムに登録したときに発生します。以下の基準に基づいて、「登録済み」イベントをフィルタリングし、ターゲットを絞ることができます。

• メール確認 URL
  メール確認 URL
• マーケティングメールの購読
  エンドユーザーがマーケティングメールを購読しているかどうか
• マーケティングプッシュ購読
  エンドユーザーがマーケティングのプッシュ通知を購読しているかどうか
• SMS 購読
  エンドユーザーが SMS サービスを購読しているかどうか

引換えのメトリック

引換えを作成、引換えを更新

これらのイベントは、顧客が引換えを作成および更新したときに発生します。以下の条件に基づいて、引換えイベントをフィルタリングし、ターゲットを絞ることができます。

• バーコード
  注文に対して生成されたバーコード
• チャネル
  引換えチャネル　例：POS、オンライン注文など
• 有効期限
  引換えコードの有効期限のタイムスタンプ
• 場所 ID
  引換えが発生した場所の ID
• 場所名
  引き換えが発生した場所の名前
• 追加プロパティ
  設定済みの場合に入力される、引換えのメトリックキー
• 管理者 ID
  引換えコードを作成した管理者の ID
• 作成日時
  引換えコードの作成日時のタイムスタンプ
• 期限切れ日時
  引換えコードが期限切れとなった時点のタイムスタンプ
• 強制メッセージ
  強制引換えの場合のメッセージ
• 内部トラッキングコード
  オファーに対して生成された引換えトラッキングコード　例：特典、引換え可能特典、または自動付与特典
• 引換えコード
  引換えのためのコード
• 更新日時
  引換えコードの作成日時のタイムスタンプ
• リクエストされたポイント
  注文時に引換えをリクエストされたポイント
• 引換え可能特典 ID
  引換え可能特典の ID
• 引換え可能特典名
  引換え可能特典の名前
• 引換え可能特典のプロパティ
• 引換え済みポイント
  注文時に引換えられたポイント
• 引換えコード ID
  PAR Punchh がオファーに対して生成した引換えコード ID　例：特典、引換え可能特典、または自動付与特典
• 引換えコードパス
• 引換え ID
  PAR Punchh 内で引換えに対して生成された一意の引換え ID
• 引換えステータス
  引換えのステータス（例：redeemed、expired、redeemable、transferred、force_redeemed、canceled）
• 引換えタイプ
  引換えのタイプ　例：BankedRewardRedemption（自動付与特典の引換え）、RedeemableRedemption（引換え可能特典の引換え）、Redemption（引換え）、RewardRedemption（特典の引換え）
• 引換え ID
  特典の引換えの場合の特典 ID
• ストア番号
  引換えが発生した場所のストア番号
• 移行先 ID
  移行タイプの ID（社会貢献キャンペーンの場合はキャンペーン ID）
• 移行先タイプ
  移行のタイプ（社会貢献キャンペーン）
• ウェブ
  引換えが iFrame 経由かどうか

引換えを適用

このイベントは、引換えが適用された時に生成されます。以下の基準に基づいて、「引換えを適用」イベントをフィルタリングし、ターゲットを絞ることができます。

• 割引額
  引換えに関連付けられた割引額
• 内部トラッキングコード
  オファーに対して生成された引換えトラッキングコード　例：特典、引換え可能特典、または自動付与特典
• ロケーション名
  チェックインが行われた場所の名前
• 処理日時
  引換えが処理された時点のタイムスタンプ
• 特典名
  特典の名前

チェックインのメトリック

ロイヤルティのためにチェックイン、ギフトのためにチェックイン

これらのイベントは、ユーザーがロイヤルティプログラムにチェックインしたときや、特定のギフトのためにチェックインしたときに発生します。以下の条件に基づいて、チェックインイベントをフィルタリングし、ターゲットを絞ることができます。

• 承認済み
  チェックイン承認済みステータス
• キャンペーン ID
  PAR Punchh で作成されたキャンペーン ID
• キャンペーン名
  キャンペーンの名前
• キャンペーンタイプ
  キャンペーンのタイプ
• チャネル
  チェックインが行われたチャネル　例：POS、オンライン注文、ウェブ、モバイル
• チェックイン ID
  PAR Punchh によって生成された一意のチェックイン ID
• チェックインタイプ
  OnlineCheckin（オンラインチェックイン）、PosCheckin（POS チェックイン）、ReceiptImageCheckin（領収書画像チェックイン）、BarcodeCheckin（バーコードチェックイン）、QrcodeCheckin（QR コードチェックイン）、POSConsoleCheckin（POS コンソールチェックイン）
• 獲得可能額
  注文の獲得条件に基づいた獲得可能な金額
• ビジネスへの初回チェックイン
  そのビジネス（またはブランド）に対する初回チェックインかどうか
• 場所への初回チェックイン
  その場所（店舗）に対する初回チェックインかどうか
• ギフトの理由
  ユーザーにポイントがギフトとして付与された理由
• ギフトの付与方法のタイプ
  ギフト提供のタイプ　例：admin（管理者が手動で）、check-in（チェックイン時に自動で）
• ギフトの付与目的のタイプ
  ギフト提供のタイプ　例：一斉提供、フィードバックへの返信、ゲーム
• 項目
  メニュー項目オブジェクト
• ロケーション ID
  PAR Punchh で生成された場所 ID
• ロケーション名
  チェックインが行われた場所の名前
• 手動
• ポイント獲得
  注文でポイントを獲得
• ポイント使用
  注文にポイントを利用
• PAR Punchh キー
  注文に対して生成された一意の PAR Punchh キー
• 領収金額
  注文の領収金額
• 引換え ID
  注文時に引換えが全額利用された場合に入力される引換え ID
• ストア番号
  場所のストア番号
• バーコード
  注文に対して生成されたバーコード
• 作成日時
  PAR Punchh でチェックインが作成された時点のタイムスタンプ
• 期限切れ日時
  チェックインの有効期限が切れた日付
• 有効期限
  チェックインの有効期限が切れる日付
• 外部 UID
  トランザクションに対して生成された外部 UID
• 紹介 ID
  紹介されたユーザーの最初のチェックインのチェックイン ID
• 紹介者のフルネーム
  紹介したユーザーの氏名
• 紹介ユーザー ID
  紹介したユーザーの ID
• ギフト付与管理者 ID
  ポイントを贈呈した管理者の ID
• ギフト付与目的 ID
  ギフト贈呈のタイプの ID
• QR デコード
  注文に対して生成された QR コードの値
• トランザクション番号
  注文のトランザクション番号
• 更新日時
  PAR Punchh でチェックインが更新された時点のタイムスタンプ
• 受領日
  注文の受領日時
• 保留ポイントの更新
  保留ポイントの設定に従って有効化
• 未確認の領収金額
  手動チェックイン（領収書画像の検証に基づく）の場合に入力される領収金額（Receipt_amount）
• 更新日時
  チェックインが更新された時点のタイムスタンプ
• 検証回数
  この回数は、チェックインを複数のレビュアーまたは管理者が承認した場合に増加します（領収書画像の検証に基づくチェックインに適用されます）。
• 検証日時
  チェックインが承認された時点のタイムスタンプ（領収書画像の検証に基づくチェックインに適用されます）
• レビュアー ID
  チェックインを検証しているレビュアーの管理者 ID（領収書画像の検証に基づくチェックインに適用されます）

POS スキャナーでチェックイン

このイベントは POS チェックイン後に生成されます。このチェックインイベントは、ポイントに基づいてフィルタリングし、ターゲットを絞ることができます。

• ポイント
  チェックインで獲得したポイント

特典のメトリック

特典獲得

これには、PAR Punchh で発生した際にトリガーされる、ユーザー特典の付与/発行イベントが含まれます。以下の基準に基づいて、「特典獲得」イベントをフィルタリングし、ターゲットを絞ることができます。

• 割引チャネル
  特典を利用可能なチャネル。値は以下のいずれかです。
  • online_only （オンラインのみ：オンライン注文の場合）
  • offline_only（オフラインのみ：POS の場合）
  • all（すべて：オンラインと POS の両方）
• ギフトの理由
  ユーザーに特典がギフトとして付与された理由
• 特典画像 URL
  特典を表す画像の URL
• 有効期限
  特典の有効期限が切れる日時（UTC）
• ステータス
  ステータスには、honored（受け取り済み）、unredeemed（未引換え）、live（ライブ）、perished（消滅）、expired（失効）が含まれます
• キャンペーン名
  特典に使用されている Punchh キャンペーン名
• キャンペーンタイプ
  特典に使用されている Punchh キャンペーンのタイプ
• 説明
  特典の説明
• 割引額
  特典に関連付けられた割引額
• ギフトの付与目的のタイプ
  ギフト提供のタイプ　例：一斉提供、フィードバックへの返信、ゲーム
• 特典名
  特典の名前
• 特典ポイント引換え済み
  引換え済みの特典ポイントの数
• 特典のプロパティ
  Punchh で設定されている特典の追加プロパティ
• ストア番号
  特典を引換え可能なすべての場所のストア番号

ポイントを特典に変換

このイベントは、顧客の獲得したポイントが特典に変換されたときにトリガーされます。以下の条件に基づいて、「ポイントを特典に変換」イベントをフィルタリングし、ターゲットを絞ることができます。

• 保有特典の価値
  自動付与されている特典の価値
• 現在の自動付与特典
  自動付与特典の現在の価値
• 特典

その他のメトリック

完了済みカード

このイベントは、ゲストのロイヤルティカードが完了したときに生成されます。以下の基準に基づいて、「完了済みカード」イベントをフィルタリングし、ターゲットを絞ることができます。

• カード完了
  1 枚のカードを完了するのに必要な訪問が行われたかどうか
• 最初のカードのリマインダー
  最初のカードの完了時にリマインダーを送信するかどうか
• 2 枚目のカードのリマインダー
  2 枚目のカードの完了時にリマインダーを送信するかどうか
• 名前
  特典の名前
• 説明
  アプリに表示される引換え可能特典の説明
• 割引額
  引換え可能特典に関連付けられた割引額
• 割引チャネル
  特典を利用可能なチャネル。値は以下のいずれかです。
  • online_only （オンラインのみ：オンライン注文の場合）
  • offline_only（オフラインのみ：POS の場合）
  • all（すべて：オンラインと POS の両方）
• 有効期限
  引換え可能特典の有効期限
• 引換えに必要なポイント
  特定の引換え可能特典を入手するのに必要なポイント数
• 引換え可能特典 ID
  システム内で引換え可能特典を識別するための一意の ID
• 引換え期限
  引換え可能特典の有効期限
• ステータス
  引換え可能特典のステータス：activated（有効化済み）、deactivated（無効化済み）、draft（下書き）、expired（期限切れ）
• ロイヤルティの引換えとして適用可能
  引換え可能特典がロイヤルティ特典の引換えとして利用可能かどうか
• 作成日時
  システム内のエンドユーザーに対して引換え可能特典が作成された日時
• 特典終了日に引換えコードも期限切れ
  引換えコードが特典終了日とともに期限切れになるかどうか
• メタデータ
  引換え可能特典に追加可能なメタデータ。このメタデータは、モバイルアプリがサーバーから特定のデータを受信した際に所定の動作をさせるようプログラムするために使用したり、ビジネスのニーズに合わせて使用したりできます。これは PAR Punchh ダッシュボードから設定可能で、最大 255 文字です。
• 更新日時
  システム内のエンドユーザーに対して引換え可能特典が更新された日時。
• 引換え可能特典の画像 URL：アプリに表示される、引換え可能特典を表す画像の URL
• 引換え可能特典のプロパティ
  特定の引換え可能特典に追加されるプロパティ　例：Merchandise（商品）、Food Item（食品）などのプロパティ

同期されるオブジェクト

特典

このオブジェクトは、Klaviyo 内で作成した Punchh キャンペーンで、Punchh ロイヤルティプログラムを通じて顧客に特典が発行された際に同期されます。このオブジェクトは、Punchh で特典が更新されるたびに更新されます。Klaviyo でのオブジェクトの使用方法について詳細は、こちらの記事をご覧ください。

以下の基準に基づいて、「特典」オブジェクトをフィルタリングし、ターゲットを絞ることができます。

• 特典 ID
  特典の一意の ID。
• 説明
  特典の説明
• ギフトの理由
  ユーザーに特典がギフトとして付与された理由
• 特典名
  特典の名前
• 有効期限
  特典の有効期限が切れる日時
• ステータス
  ステータスには、honored（受け取り済み）、unredeemed（未引換え）、perished（消滅）、expired（失効）が含まれます
• キャンペーン名
  Punchh キャンペーンの名前
• キャンペーンタイプ
  エンドユーザーが特典を獲得したキャンペーンのタイプを示します。現在設定可能な値は loyalty（ロイヤルティ）のみです。
• 特典画像 URL
  特典を表す画像の URL
• 割引チャネル
  特典を利用可能なチャネル。値は online_only（オンラインのみ）、offline_only（オフラインのみ）、all（すべて）のいずれかです。
• 割引額
  特典に関連付けられた割引額
• ギフト贈呈理由のタイプ
  ギフト贈呈のタイプ
• 特典ポイント引換え済み
  この特典を通じて引換えられた特典ポイント
• 特典のプロパティ
  Punchh プラットフォームで設定可能な特典の追加プロパティ　例：merchandise（商品）、order ahead（事前注文）、promo（プロモーション）
  

同期されるゲストデータ

Klaviyo では、PAR Punchh から同期するメトリックに加えて、同期する各顧客ごとに一意のプロファイルの作成も行います。コンタクト先情報を同期する際、各 Klaviyo プロファイルに特定のカスタムプロパティが追加される場合もあります。これらのプロパティは、セグメント内およびフロー内で使用できます。PAR Punchh から自動的に同期されるプロパティは以下のとおりです。

• メール
• 電話番号
• 名
• 姓
• Punchh 記念日
• 誕生日
• 性別
• Punchh ゲストのタイプ
• Punchh 登録日時
• Punchh 最終アクティビティ日時
• Punchh お気に入りの場所
• Punchh お気に入りのストア番号
• 希望する言語
• Punchh 紹介コード
• Punchh 登録チャネル
• Punchh 購読解除理由
• Punchh 購読解除ステータス
• Punchh ID
• Punchh ユーザーステータス
• Punchh メンバーシップレベル
• Punchh 最終訪問
• Punchh ロイヤルティポイント
• Punchh クレジット合計
• Punchh 生涯獲得ポイント合計
• Punchh ポイントクレジット合計
• Punchh 総訪問数
• Punchh 未変換ポイント（Unbanked Points）

同意

メールおよびSMSの同意はPunchhからKlaviyoに同期されます。SMS同意は、Punchhに存在し、Klaviyo SMSリストでSMS同意を確認済みのプロファイルについて、KlaviyoからPunchhにも同期されます。

PunchhからSMSの同意の同期を設定する方法について詳しくは、PAR PunchhからSMSの同意を同期する手順をご覧ください。