Punchh
Punchhは、ブランドが店内でもデジタルでもオムニチャネル 顧客 ロイヤルティプログラムを配信できる、業界をリードするロイヤルティとエンゲージメント プラットフォームです。
Braze とパンチインテグレーションでは、2 つのプラットフォームs 間でギフトやロイヤルティのためにデータを同期できます。Braze で公開されたデーターはセグメンテーションに使用でき、ユーザーデータをBraze webhook でパンチに戻すことができます。
メリットは何でしょうか。
- パンチからBrazeへのロイヤルティをリアルタイムで取り込みます。
- Brazeからの強力なオーディエンス情報を活用し、意味のあるダイナミックな クロスチャネルの体験(アプリ、モバイル、ウェブ、メール、SMS)を提供する
- 顧客 sはsを開封 メールしましたか?顧客は店の近くでアプリを開封しましたか?
- Brazeで送信されるアクション間のメールのルックアンドフィールを標準化します。
- A/B テストと最適化を可能にするジャーニーを作成します。
前提条件
要件 | 説明 |
---|---|
パンチアカウント | この提携の前進タグeを考慮するには、積極的なパンチの勘定が必要である。 |
Braze REST API キー | users.track 権限を持つBraze REST API キー。これは、Settings > API Keys のBraze ダッシュボードで作成できます。 |
Braze REST エンドポイント | [Your REST エンドポイント URL]6.エンドポイントは、インスタンスのBraze URL によって異なります。 |
他に何を知るべきですか?
統合前
- Brazeインテグレーションを使用する場合、パンチに1つ、Brazeに2つのキャンペーンsが必要です。たとえば、オファーが添付されたキャンペーンを送信すると、ギフトキャンペーンはパンチ内で設定され、通知はBrazeから送信できます。
- ゲストはパンチとBrazeにすでに存在するはずです。パンチはまだロイヤルティ客でない顧客をフィルターするだろう。
注意すべき重要事項
- パンチはデフォルト ユーザー 属性sのBrazeへの送信を無効にする機能を追加したので、顧客はデータポイント 超過料金sを発生させません。これは、アダプターのセットアップ中に構成されます。
- キャンペーンが実行されるたびにID が変更されるため、定期的なキャンペーンでカスタムSegments を使用する場合は、キャンペーン ID の代わりにキャンペーンの名前を使用する必要があります。
- パンチギフトキャンペーンで使用できる通信チャネルには、リッチメッセージ、プッシュ通知s、SMS、メールがあります。
- ユーザー s がBraze からパンチカスタムSegmentに送信された後は、削除できません。既存のカスタムSegmentに追加できるのは、新しいゲストのみです。既存のPunchhカスタムSegmentからゲストを削除する必要がある場合は、新しいPunchhカスタムSegmentにユーザーを送信するために、新しいWebhook キャンペーンをBrazeで作成する必要があります。
統合
Punchh には、以下のPunchh API エンドポイントを使用して外部ID をPunchh プラットフォームに追加するために、Braze 顧客 s で使用できるいくつかのエンドポイントが用意されています。外部ID を追加したら、Punchh でアダプターを作成し、Braze 認証情報を入力して、同期したい行動を選択します。次に、パンチSegment ID を取得し、それを使用してパンチWebhookを作成し、キャンバスの旅行で同期をトリガー 顧客できます。
Punchh user_id
はカスタム属性”punchh_ユーザー_id” としてBraze ユーザープロファイルに追加する必要があることに注意してください。同様に、Braze で使用されているexternal_id
は、Punchh ユーザープロファイルのexternal_source_id
フィールドとして含める必要があります。
ステップ1:外部ID 取り込みエンドポイントの設定s
Braze の外部ID は、新規および既設のパンチユーザーs の次のエンドポイントs を使用して追加できます。
external_source
およびexternal_source_id
フィールドは、Punchh に対して一意であり、存在するプロファイルs に関連付けられていない必要があります。
- 新型パンチユーザー
external_source
およびexternal_source_id
フィールドs を使用して、Punchh サインアップエンドポイントでPunchh に新しいユーザーs を作成します。パンチ機能を使用すると、次のいずれかのサインアップエンドポイントs を使用して、external ID全体をユーザープロファイルで送信できます。 - 従来のパンチユーザー
既設パンチユーザーs のexternal_source_id
をアップデートします。パンチ機能を使用すると、ユーザー API 更新 エンドポイントを介してexternal ID全体をプロファイルに追加できます。
このサンプルでは、サインアップ時にユーザープロファイルを持つexternal ID全体を送信できます。これは、external_source
を”顧客_id” およびexternal_source_id
を”111111111111111111” として文字列データ型として送信することによって行われます。
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"
}
}'
このサンプルでは、ユーザープロファイルを使用して全体を更新 external IDできます。これは、external_source
を”顧客_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"
}
}'
プラットフォーム設定:Punchh でexternal ID全体を有効にするには、Punchh ダッシュボードからCockpit> ダッシュボード> 外部ユーザ識別子 に移動します。
ステップ2:パンチでのBrazeアダプターの設定
同期可能なイベント
- ゲスト:サインアップ、ゲストプロファイルへの更新、非アクティブ化または削除時にトリガされます
- ロイヤリティチェックイン:ロイヤルティのトランスアクションでトリガーされるか、レシートからバーコードをスキャンして獲得します
- ギフトチェックイン:キャンペーンから贈られた点をトリガー
- 償還:パンチクーポンを除く報酬償還の場合にトリガーされます。これは、発行と償還を含むクーポンイベントとして別々に送信されるためです
- 報酬:報酬がキャンペーンs、活動、点から報酬sへのコンバージョン、または管理者ギフトから贈られたことをきっかけにした
- トランスアクション通知:パンチシステム内のユーザーのtrans アクション al アクティビティでトリガーされます(たとえば、ポイントの有効期限)。
- マーケティング通知:ユーザー s の関連付けられたSegmentに対して、パンチでのさまざまなキャンペーン設定に基づいてトリガーされます
参考パンチドキュメントでは、これらの利用可能なイベントのサンプル有料読み込むがどのように見えるかを確認できます。
このアダプターをセットアップするには、パンチインプリメンテーション・マネージャーを使用します。
Brazeとパンチインテグレーションを設定するには、以下の手順に従います。
- パンチダッシュボードで、コックピット> ダッシュボード> 主な機能> Webフック管理を有効にし、Webフック管理を有効にします**。
- 次に、Settings> Webフックマネージャ> Configurations> Show Adapters Tabに移動してアダプタを有効にし、Show Adapters Tabで切り替えます。
- Webフックマネージャの設定タブに移動し、アダプタタブを選択し、アダプタの作成をクリックします。
- アダプターの名前、説明、および管理メールを入力します。アダプターとして Braze を選択し、Braze REST API エンドポイントとBraze API キーを入力します。
- 次に、有効にするイベントを選択します。これらのイベントのリストは、Available events to syncにあります。
- Submitを押してWebhookを有効にします。
Braze でのパンチWebhookの作成
Braze は、ユーザー s をパンチSegmentに、パンチカスタムSegments を使用するwebhookを介して追加できます。
-
Punchh でカスタムSegmentを作成し、Punchh Segment ダッシュボード URL に存在する
custom_segment_id
を以下のように書き留めます。古典的またはβSegmentビルダーの両方を使用できます。ただし、classic は最終的に非推奨になるため、ベータは推奨されています。
パンチプラットフォームで、ゲスト> セグメント> カスタムリスト> 新規カスタムリスト に移動します。 -
Braze でWebhook キャンペーンを作成するには、Punchh エンドポイントを使用して、ユーザーをカスタムSegmentにWebhook URL として追加します。ここでは、URL からプルされた
custom_segment_id
とuser_id
をキーと値のペアとして指定できます。 -
このWebhookは、単数キャンペーンとして、またはキャンバス内のステップとして設定できます。または、この特殊なパンチSegmentにユーザーs を追加するWebhookが複数のキャンペーンs またはキャンバスで使用される場合は、テンプレート として設定できます。
Webhook内のuser_id
キーは、パンチユーザー IDにマップされます。この識別子は、Braze で作成されたすべてのwebhookに追加して、ユーザーs をパンチカスタムSegmentに追加する必要があります。punch_user_id
カスタム属性は、Liquid を使用して、user_id
キーの値としてダイナミックな入力できます。punchh_user_id
カスタム属性は、青色の”plus” アイコンを使用して挿入できます。アイコンは、任意のテンプレートd テキストフィールドの右上にあります。 -
Webhookが保存されたら、以下に示すようにユーザーs を同期するために使用できます。たとえば、このBraze Webhook キャンペーンを起動すると、136 人のゲストが「パンチ」カスタムSegmentに追加されます。
Brazeでのwebhookの使用方法の詳細については、Webhookの作成を参照してください。
ユースケースキャンペーン
キャンペーンとキャンバスの設定
トリガー
報酬イベントやゲストイベントなど、パンチイベントがBrazeに送信するBraze メッセージング トリガーのユースケースは、アクション ベースのキャンペーンs または該当するパンチイベントによってトリガーされるキャンバスとして作成できます。
トリガーを追加すると、Braze で作成された行動の一覧がプルアップされます。キャンペーンまたはキャンバスをトリガーし、イベントを記録したユーザーに送信するイベントを選択します。
プロパティー・フィルターs を追加して、トリガーの実行イベントをさらにフィルターできます。たとえば、メッセージは、顧客 トリガーが”checkins_gift”event の場合にのみトリガーされます。この場合、アプリのroved イベントプロパティはtrue
です。これは、すべてのユースケースにアプリ使用できるわけではないオプション機能です。
セグメンテーション
多くの場合、パンチイベントによってトリガーされているBraze キャンペーン s とキャンバスは”すべてのユーザー s” オーディエンスに設定できます。これは、これらのイベントをトリガーするユーザー s のセグメンテーションがパンチ内で決定されるためです。ただし、顧客 は、イベントによってBraze メッセージング トリガーを受け取るユーザーs のオーディエンスをさらに絞り込むために、キャンバスコンポーザーのTarget オーディエンス s セクションまたはEntry オーディエンス にフィルターs とSegments を追加します。
ユースケース
登録キャンペーン
オファーが添付されているサインアップキャンペーンのBraze設定を使用する場合、Punchh内でサインアップギフトキャンペーンを設定し、Brazeでウェルカムメッセージを設定する必要があります。
Punchh はサインアップキャンペーンに実行遅延を追加することを推奨します。そのため、Braze はゲストイベントに基づいてウェルカムメッセージを最初にトリガーできます。ユーザーに贈られたことを知らせるフォローアップメッセージを送りたい場合は、報酬の出来事に基づいてトリガーすることができます。
サインアップキャンペーンでは、すべてのサインアップをSegmentに使用できるため、カスタムBraze Segmentは必要ありません。
必要なパンチ構成:
- キャンペーン:サインアップ
- セグメント情報:登録済み
- 報酬:顧客選択 必要なイベント:
- 報奨イベント
- ゲストイベント 考慮事項:
- 実行遅延は、ゲストが5 ~10 分の遅延を追加することをお勧めします
マスオファーキャンペーン
プレゼントに大量のオファーキャンペーンを使用する場合、パンチとBrazeのメッセージング キャンペーン内で大量のオファーキャンペーンを設定する必要があります。
Braze Segmentをキャンペーンに利用したり、Brazeから通信を送信したりする場合は、パンチキャンペーンにカスタムパンチSegmentが必要になります。
Brazeでこのオファーを受信するユーザーsのSegmentを作成することは、パンチ内で使用できない属性を使用する場合にのみ推奨されます。それ以外の場合は、Punchh セグメンテーションを使用できます。Braze メッセージング キャンペーンは、ユーザーが報酬(Punchh によってトリガーされる報酬事象)を受け取ることによって、アクションベースのキャンペーン トリガーとして作成されます。
必要なパンチ構成:
- キャンペーン:マスオファー
- セグメント情報:カスタムリストまたは顧客の選択肢
- 報酬:顧客選択
セグメンテーションとギフトにパンチ、メッセージングにBrazeを使用:
たとえば、$2 off 報酬は、パンチ内で設定可能なSegmentに送信され、メッセージングはBraze 経由で送信されます。
ギフトにBraze セグメンテーションとメッセージング、パンチを使用する:
たとえば、パンチでは利用できない属性 s を持つSegmentに送信される$2 off 報酬 とメッセージング です。
ギフトまたはメッセージング、またはその両方にBraze セグメンテーションとパンチを使用する:
たとえば、$2 off 報酬は、Punchh で使用できない属性 s を持つSegmentに送信されますが、メッセージングは必要ありません。または、メッセージングはPunchh 経由で送信できます(すべてのゲストがPunchh に存在する必要があることに注意してください)。
定期的なマスオファーキャンペーン
定期的なマスオファーキャンペーンをギフトに使用する場合は、パンチ内にマスオファーキャンペーンを設定し、Brazeにメッセージング キャンペーンを設定する必要があります。顧客がBraze セグメンテーションを使用する場合は、パンチカスタムSegmentが必要になります(パンチ内で属性を使用できない場合のみ推奨)。それ以外の場合は、パンチセグメンテーションを使用でき、Braze メッセージング キャンペーンは報酬の事象に基づいてトリガーされます。
必要なパンチ構成:
- キャンペーン:定期的なマスオファー
- セグメント情報:カスタムリストまたは顧客の選択肢
- 報酬:顧客選択 考慮事項:
- キャンペーンID とキャンペーンの名前は、イベントのイベントプロパティとしてBraze に送信されます。キャンペーンを受信するオーディエンスをさらにフィルターするためにBrazeでパンチキャンペーン 識別子を使用する場合は、キャンペーンID が毎日変更されるため、キャンペーンの名前を使用する必要があります。
通知との事後チェックインオファーキャンペーン
チェックイン後のオファーキャンペーンを利用する場合、Brazeはプレゼントに関する通知を送付し、ゲストがチェックインを行うと、パンチ後のチェックインキャンペーンからプレゼントされます。したがって、チェックイン後のオファーキャンペーンは、パンチとBrazeのメッセージング キャンペーン内で設定する必要があります(キャンペーンを顧客に通知する場合)。
必要なパンチ構成:
- キャンペーン:チェックイン後のオファー
- セグメント情報:カスタムリスト
- 報酬:顧客選択
例えば、今週末に来訪することを客に知らせるメールは、パンチでは利用できない属性sのあるSegmentをダブルポイントする。Brazeからの適格なチェックインとオプションのメッセージングの後に、パンチがこのSegment点をプレゼントします。
を通じてギフトとオプションメッセージをチェックインして受け取ります。
チェックイン後のオファーキャンペーン(通知なし)
キャンペーンは、最初に顧客に通知しないチェックイン後のオファーキャンペーンを使用する場合、ギフト(オプションメッセージング)を付与し、Braze内の通知をトリガーします。したがって、チェックイン後のオファーキャンペーンはPunchh 内で設定する必要がありますが、カスタムリストは必要ありません。代わりに、パンチ内で希望するSegmentを選択することができます。
必要なパンチ構成:
- キャンペーン:チェックイン後のオファー
- セグメント情報:顧客選択
- 報酬:顧客選択
例えば、パンチで利用可能なSegmentに、驚きと喜びのBraze キャンペーンが送られ、来客の来訪に感謝し、次回の訪問から2ドルで報酬する。
から送信された報酬を通知するリコールメッセージが送信されます。
記念日キャンペーン
記念日キャンペーンをご利用の際は、まずパンチキャンペーンから記念日のユーザーをプレゼントします。このギフト(報酬行事)は、ギフトのユーザーを通知するBraze内のメッセージング キャンペーンをトリガーします。そのため、カスタムリストは必要ありません。代わりに、パンチ内のSegmentと記念日の設定を選択することができます。
必要なパンチ構成:
- キャンペーン:記念日キャンペーン
- セグメント情報:顧客選択
- 報酬:顧客選択 考慮事項:
- 登録プレゼント月
- 存続期間(誕生日報酬はどのくらい有効ですか?)
- 経常キャンペーン、必要スケジュール
から送信された報酬を通知するリコールメッセージが送信されます。
回収キャンペーン
非アクティブに基づいてユーザーs をターゲットにする場合は、リコールキャンペーンを使用できます。顧客はパンチ内にSegmentとキャンペーンを作成できますが、メッセージングにはBrazeを使用します。
Braze で作成されたセグメンテーションを使用する場合は、非アクティブに基づいたカスタムPunchh Segment を定期的な一括オファーキャンペーンにアタッチできます。
必要なパンチ構成:
- キャンペーン:回収キャンペーン
- セグメント情報:顧客選択
- 報酬:顧客選択 考慮事項:
- キャンペーンはスケジュールで実行されます
から送信された報酬を通知するリコールメッセージが送信されます。