Punchh

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が変更されるため、キャンペーンIDの代わりにキャンペーン名を使用する必要があります。
• 各Punchhギフティングキャンペーンで使用できるコミュニケーションチャネルには、リッチメッセージ、プッシュ通知、SMS、メールがあります。
• BrazeからPunchhカスタムセグメントに送信されたユーザーは、削除できません。既存のカスタムセグメントには新規ゲストのみを追加できます。既存のPunchhカスタムセグメントからゲストを削除する必要がある場合は、新しいPunchhカスタムセグメントにユーザーを送信するために、新しいWebhookキャンペーンをBrazeで作成する必要があります。

統合

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

統合で同期が正しく行われるようにするには、Punchh user_idとBraze external_idがどちらのプラットフォームでも利用可能でなければなりません。

• PunchhからBrazeに送信されるイベントには、識別子としてBraze external_idが含まれます。Punchhがexternal_source_idを使用するように設定されている場合、その値がBraze external_idとして設定されます。そうでない場合、統合はデフォルトでPunchh user_idをBraze external_idとして設定します。
• BrazeからPunchhへwebhookを送信するには、BrazeユーザープロファイルでPunchh user_idが利用できなければなりません。Punchh user_idがBraze external_idとして使用されない場合は、カスタム属性「punchh_user_id」として設定する必要があります。

ステップ1:external ID取り込みエンドポイントの設定（オプション）

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

重要

external_sourceおよびexternal_source_idフィールドの値は、Punchhに対して一意であり、既存のプロファイルに関連付けられていてはなりません。

1. 新規Punchhユーザー
   external_sourceおよびexternal_source_idフィールドを使用して、PunchhサインアップエンドポイントでPunchhに新しいユーザーを作成します。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"
      }
}'

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"
    }
}'

注

プラットフォーム設定: Punchhで外部識別子を有効にするには、PunchhダッシュボードからCockpit > Dashboard > External User Identifierに移動します。

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

同期できるイベント

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

注

これらの利用可能なイベントのサンプルペイロードの内容については、Punchhのドキュメントを参照してください。

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

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

1. Punchhダッシュボードで、Cockpit > Dashboard > Major Features > Enable Webhook Managementに移動し、Enable Webhook Managementをオンに切り替えます。
   
   
2. 次に、Settings > Webhooks Manager > Configurations > Show Adapters Tabに移動してアダプターを有効にし、Show Adapters Tabをオンに切り替えます。
   
   
3. SettingsタブのWebhooks Managerに移動し、Adaptersタブを選択し、Create Adapterをクリックします。
   
   
   
   
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エンドポイントをwebhook URLとして使用します。ここでは、URLから取得したcustom_segment_idとuser_idをキーと値のペアとして指定できます。
   
   
   
   

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

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

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

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

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

トリガー

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

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

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

セグメンテーション

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

ユースケース

• 登録
• brazeウェルカム
• マスオファー
• 定期的なマスオファー
• 通知付きチェックイン後オファー
• 通知なしチェックイン後オファー
• 記念日
• 呼び戻し