Convercus

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

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

連携について

BrazeとConvercusの連携は双方向です。ロイヤルティデータはカスタム属性、カスタムイベント、購入データとしてリアルタイムでBrazeに取り込まれ、Brazeのキャンバスやキャンペーンはwebhookを通じてConvercusのロイヤルティアクションをトリガーできます。同期された会員ティア、ポイント残高、購入履歴、クーポンアクティビティをセグメント、Liquid、Connected Contentで活用できます。Brazeのジャーニーからは、クーポンの割り当て、ポイント取引の記帳・獲得・消費、Convercusでのメール購読設定の更新も行えます。

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

ユースケース

• ティアアップのお祝い： Convercusでメンバーがロイヤルティティアを昇格した際に、ウェルカムメッセージ、ティア限定の特典、メンバーの新しいティアとポイント残高を含むパーソナライズされたBrazeキャンバスをトリガーします。
• 誕生日やマイルストーンのボーナス： Brazeジャーニーから、メンバーの誕生日や記念日にConvercusでボーナスポイントを付与し、新しい残高を確認するお祝いメッセージを送信します。
• 休眠メンバーの奪還： 非アクティブなメンバーに対して、BrazeからWebhookを通じてConvercusでパーソナライズされたクーポンを割り当て、メール、プッシュ、アプリ内メッセージで配信します。
• メッセージングでのリアルタイムポイント残高： Connected Contentを使用してメンバーのリアルタイムポイント残高をBraze Liquidに取り込み、「次のリワードまであとXポイント」といったケイデンスに活用します。

前提条件

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

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

インテグレーション

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

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

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

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

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

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

注

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

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

キャンバスまたはキャンペーンから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）をセグメントで使用して、ティア保有者、高残高メンバー、または最近ダウングレードされたユーザーをターゲットにします。
2. カスタムイベント（例: convercus_status_level_changed、クーポンおよびメンバーシップイベント）をキャンバスのトリガーステップとして、またはリエンゲージメントキャンペーンのフィルターとして使用します。
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: Connected Content でライブロイヤルティデータを取得する

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

Connected Content エンドポイントは、想定されるエラーでは常に 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 %}

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

考慮事項

• レイテンシー: Convercus から Braze へのイベントは Kafka を経由して伝達され、通常の負荷状態では数秒で Braze に到達します。
• Braze のレート制限: このインテグレーションは 429 レスポンスに対して自動的にリトライを行い、Braze の x-ratelimit-retry-after ヘッダーに従い指数バックオフを適用します。
• Connected Content のキャッシュ: Braze はデフォルトで Connected Content のレスポンスを数分間キャッシュします。送信時に正確な値が必要な場合（ポイント残高など）は、Connected Content の呼び出しでキャッシュウィンドウを短縮するかバイパスしてください。
• プログラムごとに1つの設定: 各ロイヤルティプログラムは1つの Braze ワークスペースにマッピングされます。2つ目のワークスペースを接続するには、別のプログラムで設定を行ってください。
• オブザーバビリティ: プログラムごとの API コール統計とエラー履歴（双方向）は90日間保持され、Selfservice の Braze インテグレーションカードから確認できます。

トラブルシューティング

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