Convercus

Convercusは、SaaS型のロイヤルティおよびクーポンプラットフォームで、オムニチャネルのロイヤルティプログラムやパーソナライズされたクーポンキャンペーンを通じて、ブランドや小売業者の来店頻度、バスケット単価、リピート率の向上を支援します。

この連携はConvercusによって管理されています。

連携について

BrazeとConvercusの連携は双方向です。ロイヤルティデータはカスタム属性、カスタムイベント、購入としてリアルタイムでBrazeに流れ込み、BrazeのCanvasesやCampaignsはwebhookを通じてConvercusのロイヤルティアクションをトリガーできます。同期されたメンバーティア、ポイント残高、購入、クーポンアクティビティをSegments、Liquid、コネクテッドコンテンツで活用できます。Brazeジャーニーからは、クーポンの割り当て、ポイントの獲得・消費トランザクションの記録、Convercusでのメールサブスクリプション設定の更新も可能です。

Convercusが連携をホストするため、追加のインフラを導入する必要はありません。多くのロイヤルティコネクターがデータを一方向にプッシュするだけなのに対し、Convercusはループを閉じます。Brazeでロイヤルティイベントに反応し、Convercusでアクションを実行し、その結果をBrazeで測定できます。

ユースケース

1. ティアアップのお祝い: メンバーがConvercusでロイヤルティティアを上がった際に、ウェルカムメッセージ、ティア限定特典、メンバーの新しいティアとポイント残高を含むパーソナライズされたBraze Canvasをトリガーします。
2. 誕生日やマイルストーンボーナス: Brazeジャーニーから、メンバーの誕生日や記念日にConvercusでボーナスポイントを記録し、新しい残高を確認するお祝いメッセージを送信します。
3. 休眠メンバーの復帰施策: 非アクティブなメンバーに対して、BrazeがWebhookを通じてConvercusでパーソナライズされたクーポンを割り当て、メール、プッシュ、アプリ内メッセージで配信します。
4. メッセージ内のリアルタイムポイント残高: コネクテッドコンテンツを使用してメンバーのリアルタイムポイント残高をBraze Liquidに取り込み、「次の報酬まであとXポイント」のようなケイデンスを実現します。

前提条件

開始する前に、以下が必要です。

システム間で一貫したユーザー識別子が必要です。Brazeでexternal_id（または選択した識別子タイプ）として使用される値は、Convercusの対応するメンバー識別子と一致する必要があります。一致しない場合、イベントは正しいプロファイルに帰属されません。

連携

ステップ1: Convercus SelfserviceでBrazeを設定する

Convercus Selfservice（顧客向け管理UI — Convercusアカウントマネージャーが提供するURLで開きます）で、Brazeに接続するプログラムを開き、Braze integration cardを使用して以下を行います。

1. 連携フォームに入力してBraze接続を設定します。

   フィールド	説明
   apiKey	Braze REST APIキー（users.track権限付き）。
   apiEndpoint	Braze RESTエンドポイント（例: https://rest.iad-01.braze.com）。
   識別子タイプ	external_idまたはuser_alias。ConvercusメンバーをBrazeユーザープロファイルにマッチングする方法を決定します。
   defaultOptins	プログラムのオプトインチャネル（membershipOptinsから）の複数選択。メールサブスクリプションWebhookでリクエストがoptinsを省略した場合のデフォルトとして使用されます。少なくとも1つが選択されるまで、Braze設定は未完了として扱われます。

2. インバウンドコール用のAPIキーを作成します。プログラムごとのX-Convercus-Key認証情報を作成します。生のキーは作成時に一度だけ表示され、cvc_がプレフィックスとして付きます（形式: cvc_<base64url>）。ステップ2でWebhook CampaignsとコネクテッドコンテンツブロックをBrazeで設定する際に保存してください。キーは同じカードからいつでも取り消すことができ、取り消しは即座に有効になります。

Braze接続を保存すると、Convercusはそのプログラムのロイヤルティイベントを即座にBrazeへストリーミングし始めます。追加のインフラセットアップは不要です。

注

各Convercusプログラムは独立して設定されます。単一のConvercusテナントが異なるプログラムを異なるBrazeワークスペースに接続でき、それぞれ独自のAPIキーを持ちます。

ステップ2: BrazeでWebhookを設定する

CanvasやCampaignからConvercusアクションをトリガーするには、Convercus連携サービスを呼び出すBraze Webhookアクションを作成します。すべてのリクエストには以下のヘッダーを含める必要があります。

• X-Convercus-Key: cvc_… — ステップ1で生成したAPIキー。
• Content-Type: application/json

すべてのエンドポイントはベースURL <SERVICE_HOST>/v1/programs/{programId} の配下にあります。<SERVICE_HOST>をConvercusアカウントマネージャーが提供するホストに、{programId}をConvercusプログラムIDに置き換えてください。

例 — メンバーにクーポンを割り当てる:

1
2
3
4
5
6
7
8
POST <SERVICE_HOST>/v1/programs/{programId}/campaigns/{couponId}/assign
X-Convercus-Key: cvc_…
Content-Type: application/json

{
  "account_id": "{{custom_attribute.${convercus_account_id}}}",
  "braze_campaign_id": "{{campaign.${api_id}}}"
}

他のアクションも同じパターンに従い、エンドポイントとボディのみが変わります。例えば、ポイント記録は /members/{accountId}/bookings に booking_type（EARNBOOKING または BURNBOOKING）、booking_type_code、points、reason を含めてPOSTします。メールサブスクリプションWebhookは /subscriptions/email に account_id と status（allowed または declined）を含めてPOSTします。

エラーレスポンスとリトライ

警告

5xxレスポンスは成功を確認せずにリトライするのは安全ではありません。これらの操作は冪等ではなく、リトライによりクーポンの二重割り当てやポイント記録の二重計上が発生する可能性があります。これらのWebhookではBrazeの5xx自動リトライを無効にするか、最大リトライ回数を非常に低く設定してください。

ステップ3: Brazeでデータを確認する

1. Convercusでロイヤルティイベントをトリガーします。例えば、ステータスレベルの変更、ポイントトランザクション、クーポンの引き換えなどです。
2. Brazeで対応するユーザーを開き、期待されるカスタム属性、カスタムイベント、または購入がプロファイルに表示されることを確認します。ユーザーはexternal_id（またはステップ1で選択した識別子タイプ）でマッチングされます。
3. 逆方向を確認するには、ステップ2のWebhookの1つを呼び出すBrazeテスト送信を実行し、Convercusでアクションを確認します（クーポンの割り当て、ポイントの記録、またはサブスクリプションの更新）。

BrazeでConvercusを使用する

ステップ1: 同期されたロイヤルティデータでメッセージをパーソナライズする

連携が稼働すると、Convercusイベントは/users/trackエンドポイントを通じてBrazeの各ユーザープロファイルに届き、他のネイティブデータと同様に使用できます。

1. ロイヤルティカスタム属性（例: convercus_status_level、convercus_balance）をSegmentsで使用して、ティア保有者、高残高メンバー、または最近ダウングレードされたユーザーをターゲットにします。
2. カスタムイベント（例: convercus_status_level_changed、クーポンおよびメンバーシップイベント）をCanvasのトリガーステップとして、またはリエンゲージメントCampaignsのフィルターとして使用します。
3. これらのフィールドをLiquidで参照して、メッセージ内パーソナライゼーション（件名、本文、プッシュタイトル）に活用します。
4. Convercusからストリーミングされたpurchaseイベントを使用して、商品対応ジャーニー（補充、カテゴリアップセル、購入後レビューリクエスト）を推進します。

カスタム属性

注

Brazeワークスペース内では、メンバーはconvercus_account_idで一意に識別されます。convercus_user_idは複数のConvercusプログラムにまたがる基盤となる人物を識別し、クロスプログラム分析のために提供されます。Braze内でのセグメンテーションにはconvercus_account_idを使用してください。

email_subscribeのマッピング

カスタムイベント

購入

タイプEARNTRANSACTION（顧客の支出から獲得したポイント）のConvercusトランザクションは、Brazeに購入として報告され、Brazeの収益分析、RFMセグメンテーション、予測機能でカウントされます。トランザクションIDを商品識別子として、トランザクション金額と通貨を価格と通貨として使用します。

タイプPAYWITHPOINTSTRANSACTION（ポイント消費）のトランザクションは購入として報告されません。convercus_account_transactionカスタムイベントとして流れるため、セグメンテーションに引き続き利用できます。獲得トランザクションの取り消しやキャンセルは、マイナス価格の購入として報告され、Brazeの収益をConvercusと整合させます。

ステップ2: コネクテッドコンテンツでリアルタイムのロイヤルティデータを取得する

送信時に最新でなければならない値（現在のポイント残高、アクティブなクーポン、最新のティア）については、最後に同期された属性に頼るのではなく、コネクテッドコンテンツを使用してBrazeからConvercusを呼び出します。両方のエンドポイントはWebhookと同じベースURL配下にあり、X-Convercus-Keyヘッダーが必要です。

コネクテッドコンテンツのエンドポイントは、予期される失敗時に常にHTTP 200を返すため、Liquidテンプレートでerrorフィールドに基づいて分岐できます。

例 — メンバーのロイヤルティステータス（ティア、ポイント、アクティブオファー）をレンダリングする:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{% connected_content
  https://<SERVICE_HOST>/v1/programs/{programId}/members/{{custom_attribute.${convercus_account_id}}}/profile
  :headers { "X-Convercus-Key": "cvc_…" }
  :content_type application/json
  :cache_max_age 300
  :retry
  :save member
%}

{% connected_content
  https://<SERVICE_HOST>/v1/programs/{programId}/members/{{custom_attribute.${convercus_account_id}}}/coupons?lang=en
  :headers { "X-Convercus-Key": "cvc_…" }
  :content_type application/json
  :cache_max_age 0
  :retry
  :save coupon_data
%}

{% unless member.error %}
  <h2>Your Loyalty Status</h2>
  <p>Hi {{member.first_name}}, you're a <strong>{{member.tier_name}}</strong> member.</p>
  <p>Points balance: <strong>{{member.points_balance}}</strong></p>

  {% if coupon_data.coupons.size > 0 %}
    <h3>Your Active Offers</h3>
    {% for coupon in coupon_data.coupons %}
      <p><strong>{{coupon.title}}</strong> — valid until {{coupon.valid_to}}</p>
    {% endfor %}
  {% endif %}
{% endunless %}

コネクテッドコンテンツは常に条件分岐でラップしてください（member.errorと空のcouponsをチェック）。一時的なルックアップ失敗が壊れたメッセージを送信しないようにします。プロファイルはキャッシュし（cache_max_age 300）、クーポンはキャッシュしないでください（cache_max_age 0）。クーポンのステータスは送信間で変わる可能性があるためです。

考慮事項

• レイテンシ: ConvercusからBrazeへのイベントはKafkaを通じて伝播し、通常の負荷では数秒でBrazeに到達します。
• Brazeレート制限: 連携は429レスポンスに対してエクスポネンシャルバックオフでBrazeのx-ratelimit-retry-afterヘッダーを尊重しながら自動的にリトライします。
• コネクテッドコンテンツのキャッシュ: Brazeはデフォルトでコネクテッドコンテンツのレスポンスを数分間キャッシュします。送信時に正確でなければならない値（ポイント残高など）については、コネクテッドコンテンツコールでキャッシュウィンドウを短縮またはバイパスしてください。
• プログラムごとに1つの設定: 各ロイヤルティプログラムは単一のBrazeワークスペースにマッピングされます。2つ目のワークスペースを接続するには、別のプログラムで設定してください。
• オブザーバビリティ: プログラムごとのAPIコール統計とエラー履歴（双方向）は90日間保持され、SelfserviceのBraze integration cardから確認できます。

トラブルシューティング

• イベントがBrazeに表示されない: ステップ1で選択した識別子として使用されている値が、Brazeのユーザーのexternal_id（または選択した識別子タイプ）と一致していることを確認してください。識別子の不一致により、イベントが誤ったプロファイルに帰属されるか、ドロップされます。
• Webhookが401を返す: X-Convercus-Keyヘッダーが欠落しているか、cvc_… APIキーが取り消されています。Selfserviceでキーを再生成し、BrazeのWebhookアクションを更新してください。
• Webhookが400を返す: リクエストにContent-Type: application/jsonが欠落しているか、ペイロードがドキュメント化されたスキーマと一致していません。メールサブスクリプションWebhookの場合、400はリクエストされたオプトインがプログラムに認識されていないか、設定されていないことも意味します。
• 詳細なデバッグ: SelfserviceのBraze integration cardでプログラムごとのAPIコール統計とエラー履歴を確認するか、Convercusの担当者にお問い合わせください。