Punchh

Punchhは、ブランドが店内でもデジタルでもオムニチャネル 顧客 ロイヤルティプログラムを配信できる、業界をリードするロイヤルティとエンゲージメント プラットフォームです。

Braze と Punchh の統合により、2つのプラットフォーム間でギフティングやロイヤルティの目的でデータを同期できます。Braze で公開されたデータはセグメンテーションに使用でき、Braze Webhook を介してユーザーデータを再び Punchh に同期できます。

メリットは何でしょうか。

• Punchh から Braze にロイヤルティデータをリアルタイムで取り込む。
• Braze の強力なオーディエンス情報を利用してレイヤー化し、有意義でダイナミックなクロスチャネルエクスペリエンス (アプリ、モバイル、Web、メール、SMS) を提供する。
  • 顧客がメールを開封しましたか?顧客が店舗の周辺でアプリを開きましたか?
• Braze で送信されるトランザクションメールのルックアンドフィールを標準化する。
• その過程で AB テストと最適化を可能にするジャーニーを作成する。

前提条件

その他の留意点

統合前

• Braze 統合を使用する場合、Punchh と Braze それぞれに1つずつ、2つのキャンペーンが必要です。たとえば、オファーが添付されているキャンペーンを送信する場合、ギフティングキャンペーンは Punchh 内で設定され、通知は Braze から送信できます。
• ゲストは Punchh と Braze にすでに存在している必要があります。Punchh では、まだロイヤルティゲストではない顧客はすべて除外されます。

注意すべき重要事項

• Punchh では、Braze にデフォルトのユーザー属性を送信する動作を無効にできる機能が追加されています。これにより、顧客に対してデータポイントの超過料金が発生することがありません。これは、アダプターのセットアップ中に構成されます。
• キャンペーンが実行されるたびにID が変更されるため、定期的なキャンペーンでカスタムSegments を使用する場合は、キャンペーン ID の代わりにキャンペーンの名前を使用する必要があります。
• 各 Punchh ギフティングキャンペーンで使用できるコミュニケーションチャネルには、リッチメッセージ、プッシュ通信、SMS、メールがあります。
• Braze から Punchh カスタムセグメントに送信されたユーザーは、削除できません。既存のカスタムセグメントには新規ゲストのみを追加できます。既存のPunchhカスタムSegmentからゲストを削除する必要がある場合は、新しいPunchhカスタムSegmentにユーザーを送信するために、新しいWebhook キャンペーンをBrazeで作成する必要があります。

統合

Punchh は、Braze の顧客が利用できる複数のエンドポイントを提供します。これは、次の Punchh API エンドポイントを使用して Punchh プラットフォームに external ID を追加するのに役立ちます。外部ID を追加したら、Punchh でアダプターを作成し、Braze 認証情報を入力して、同期したい行動を選択します。次に、Punchh セグメントID を使用して、キャンバスジャーニーで顧客同期をトリガーする Punchh Webhook を作成できます。

Punchh user_id は、使用する統合のカスタム属性「punchh_user_id」として Braze ユーザープロファイルに追加する必要があることに注意してください。同様に、Braze で使用されているexternal_id は、Punchh ユーザープロファイルにexternal_source_id フィールドとして含める必要があります。

ステップ1:external ID 取り込みエンドポイントを設定する

Braze の external ID は、新規および既存の Punchh ユーザーの次のエンドポイントを使用して追加できます。

1. 新規 Punchh ユーザー
   external_source およびexternal_source_id フィールドs を使用して、Punchh サインアップエンドポイントでPunchh に新しいユーザーs を作成します。Punchh では、外部識別子をユーザープロファイルとともに次のいずれかの登録エンドポイントを介して送信できます。
   • Mobile Signup API
   • SSO Signup API
     
     
2. 既存の Punchh ユーザー
   既存の Punchh ユーザーのexternal_source_id を更新します。Punchh では、ユーザーAPI 更新エンドポイントを介して外部識別子をプロファイルに追加できます。
   • Mobile User Update
   • SSO User Update
   • Dashboard User Update
     
     

• ユーザー登録 api の例
• ユーザー更新 api の例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl --location --request POST 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Accept-Timezone: Etc/UTC' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-raw '{
    "client":"CLIENT",
    "user" : {
      "email": "[email protected]",
      "password": "PASSWORD",
      "first_name":"FIRST_NAME",
      "last_name":"LAST_NAME",
      "terms_and_conditions":"true",
      "anniversary":"2014-02-02",
      "zip_code":"94497",
      "birthday":"2004-02-02",
      "external_source":"customer_id",
      "external_source_id":"111111111111111111"
      }
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request PUT 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data-raw '{
    "client":"CLIENT",
    "user": {
        "external_source":"customer_id",
        "external_source_id":"111111111111111111"
    }
}'

ステップ2:Punchh で Braze アダプターを設定する

同期できるイベント

1. Guest:登録、ゲストプロファイルの更新、非アクティブ化、または削除時にトリガーされます。
2. Loyalty Check-in:ロイヤルティトランザクションまたはレシートのバーコードスキャンによる獲得に対してトリガーされます。
3. Gift Check-in:キャンペーンで与えられたポイントに対してトリガーされます。
4. Redemption:パンチクーポンを除く報酬償還の場合にトリガーされます。これは、発行と償還を含むクーポンイベントとして別々に送信されるためです
5. Rewards:キャンペーン、アクティビティ、ポイントからリワードへの変換、または管理ギフティングで与えられたリワードからトリガーされます。
6. Transaction Notifications:Punchh システム内でのユーザーのトランザクションアクティビティに対してトリガーされます (ポイントの有効期限など)。
7. マーケティング通知:関連付けられているユーザーセグメントの Punchh での各種キャンペーン設定に基づいてトリガーされます。

Punchh 実装マネージャーと協力して、このアダプターを設定します。

Braze と Punchh の統合を設定するには、次の手順を実行します。

1. パンチダッシュボードで、コックピット> ダッシュボード> 主な機能> Webフック管理を有効にし、Webフック管理を有効にします。
   
   
2. 次に、[Settings] > [Webhooks Manager] > [Configurations] > [Show Adapters Tab] に移動してアダプターを有効にし、[Show Adapters Tab] をオンに切り替えます。
   
   
3. Webフックマネージャの設定タブに移動し、アダプタタブを選択し、アダプタの作成をクリックします。
   
   
   
   
4. アダプターの名前、説明、および管理メールを入力します。アダプターとして Braze を選択し、Braze REST API エンドポイントとBraze API キーを入力します。
   
   
5. 次に、有効にするイベントを選択します。これらのイベントのリストは「同期できるイベント 」にあります。
   
   
   
   
6. Submitを押してWebhookを有効にします。

Braze で Punchh Webhook を作成する

Braze は、Punchh カスタムセグメントを使用してWebhook 経由でユーザーを Punchh セグメントに追加できます。

1. Punchh でカスタムセグメントを作成し、以下に示す Punchh セグメントダッシュボード URL に含まれているcustom_segment_id をメモします。従来のセグメントビルダーまたはベータセグメントビルダーの両方を使用できます。ただし、classic は最終的に非推奨になるため、ベータは推奨されています。
   
   Punchh プラットフォームで [Guest] > [Segment] > [Custom List] > [New Custom List] に移動します。
   
   
   
   

2. Braze でWebhook キャンペーンを作成するには、Punchh エンドポイントを使用して、ユーザーをカスタムSegmentにWebhook URL として追加します。ここでは、URL からプルされたcustom_segment_id とuser_id をキーと値のペアとして指定できます。
   
   
   
   

3. このWebhookは、単数キャンペーンとして、またはキャンバス内のステップとして設定できます。または、この特殊なパンチSegmentにユーザーs を追加するWebhookが複数のキャンペーンs またはキャンバスで使用される場合は、テンプレート として設定できます。
   
   Webhook 内の user_id キーは、Punchh ユーザー ID にマッピングされます。ユーザーを Punchh カスタムセグメントに追加するには、Braze で作成されたすべての Webhook にこの ID を追加するする必要があります。punch_user_id カスタム属性は、Liquid を使用して、user_id キーの値としてダイナミックな入力できます。punchh_user_id カスタム属性変数を挿入するには、任意のテンプレートテキストフィールドの右上にある青色の「プラス」アイコンを使用します。
   
   
   
   
   
   

4. Webhook が保存されたら、以下に示すように、ユーザーの同期にこの Webhook を使用できます。たとえば、このBraze Webhook キャンペーンを起動すると、136 人のゲストが「パンチ」カスタムSegmentに追加されます。
   
   

Brazeでのwebhookの使用方法の詳細については、Webhookの作成を参照してください。

ユースケースキャンペーン

キャンペーンとキャンバスの設定

トリガー

Braze に送信される Punchh イベント (リワードイベントやゲストイベントなど) によりトリガーされる Braze メッセージングのユースケースは、アクションベースのキャンペーン、または該当する Punchh イベントによってトリガーされるキャンバスとして作成できます。

トリガーを追加すると、Braze で作成されたイベントのリストが取得されます。キャンペーンまたはキャンバスをトリガーし、イベントを記録したユーザーに送信するイベントを選択します。

トリガーイベントをさらに絞り込むには、プロパティフィルターを追加できます。たとえば、承認済みイベントプロパティが true である「checkins_gift」イベントを顧客がトリガーした場合にのみ、メッセージをトリガーします。これはオプションの機能であり、すべてのユースケースに適用できるわけではありません。

セグメンテーション

多くの場合、Punchh イベントによってトリガーされる Braze キャンペーンとキャンバスには、「すべてのユーザー」オーディエンスを設定できます。これは、これらのイベントをトリガーするユーザーのセグメンテーションがが Punchh 内で決定するためです。ただし、イベントによってトリガーされる Braze メッセージを受信するユーザーからなるオーディエンスをさらに絞り込む場合は、キャンペーン作成画面の [ターゲットオーディエンス] セクションまたはキャンバス作成画面の [エントリオーディエンス] で、フィルターとセグメントを追加します。

ユースケース

• サインアップ
• マスオファー
• 定期的なマスオファー
• 通知を使用するチェックイン後オファー
• 通知を使用しないチェックイン後オファー
• 記念日
• 呼び戻し