Skip to content

Braze-to-Braze Webhook

Webhook を使用して、Braze [REST API]2 と通信することができます。基本的には、API で行えるすべての操作を実行できます。弊社では、このように Braze から Braze へ通信する Webhook のことを Braze-to-Braze Webhook と呼んでいます。

前提条件

Braze-to-Braze Webhook を作成するには、目的のエンドポイントの権限を持つ [APIキー]3 が必要です。

ユースケース

Braze-to-BrazeのWebhookでできることはたくさんあるが、ここでは一般的な使用例をいくつか紹介しよう:

  • ユーザがメッセージを受信すると、カウンタのカスタム属性(整数)をインクリメントする。
  • 最初のキャンバスから2番目のキャンバスをトリガーする。

このページの使用例は、[Webhookがどのように機能するか]4 ]と[BrazeでWebhookを作成する方法]5 ]をすでに知っていることを前提としている。

Braze-to-Braze Webhook の作成手順

Webhook リクエストの詳細はユースケースによって異なりますが、Braze-to-Braze Webhook を作成するための一般的なワークフローは変わりません。

  1. キャンペーンまたはキャンバスのコンポーネントとして [ウェブフックを作成]5 します。
  2. [空白のテンプレート] を選択します。
  3. [Compose] タブで、[Webhook URL] と [リクエスト本文] をユースケースに応じて指定します。
  4. [設定] タブで、[HTTP メソッド] と [リクエストヘッダー] を指定します。
  5. 必要に応じて、Webhook の残りの部分を引き続き作成します。ユースケースによっては、カスタムイベントからキャンペーンやキャンバスをトリガーするなど、特定の配信設定が必要なものもあります。

ユースケース:カウンターの整数カスタム属性をインクリメントする

この使用例では、カスタム属性を作成し、特定のアクションが発生した回数をカウントするためにLiquidを使用する。

例えば、ユーザーがアクティブなアプリ内メッセージ・キャンペーンを何回見たかをカウントし、3回見たら二度とキャンペーンを受け取らないようにしたい場合がある。Braze の Liquid ロジックでできることのアイデアについては、Liquid ユースケースライブラリを参照してください。

Braze-to-BrazeのWebhookを作成するための一般的な手順に従い、Webhookを設定する際には以下を参照すること:

  • Webhook URL:[REST エンドポイント URL]7 の後に /users/track を続けます。例えば、US-06 のインスタンスの場合、URL は https://rest.iad-06.braze.com/users/track となります。
  • 要求本文:Raw Text

リクエストヘッダと方法

Braze には、API キーを含む認証用の HTTP ヘッダーと、content-type を宣言する別の HTTP ヘッダーが必要です。

  • 要求ヘッダー:
    • 認証: Bearer {YOUR_API_KEY}
    • Content-Type:application/json
  • HTTP メソッド:POST

YOUR_API_KEY を、users.track 権限を持つ Braze API キーに置き換えます。APIキーは、Brazeダッシュボードの「設定」>「APIキー」で作成できる。

Request body

リクエスト本文にユーザー追跡リクエストと、カウンター変数を代入する Liquid を追加します。詳細については、[ユーザー追跡]8] を参照してください。

以下は、このエンドポイントに必要な Liquid とリクエスト本文の両方の例です。your_attribute_count はユーザーがメッセージを見た回数をカウントするために使用する属性です:

1
2
3
4
5
6
7
8
9
{% assign new_number = {{custom_attribute.${your_attribute_count}}} | plus: 1 %}
{
    "attributes": [
        {
        "external_id": "{{${user_id}}}",
        "your_attribute_count": "{{new_number}}"
        }
    ]
}

ユースケース:最初のキャンバスから2番目のキャンバスをトリガーする

この使用例では、2つのCanvasを作成し、最初のCanvasから2つ目のCanvasをトリガーするためにウェブフックを使用する。これは、ユーザーが別のキャンバス内の特定ポイントに到達したときのエントリトリガーのような役割を果たします。

  1. まず、2 つ目のキャンバスを作成します。これは最初のキャンバスによってトリガーされるキャンバスです。
  2. キャンバスのエントリスケジュールで、[API トリガー] を選択します。
  3. キャンバス ID を書き留めます。これは後のステップで必要になる。
  4. 続いて 2 つ目のキャンバスのステップを作成し、キャンバスを保存します。
  5. 最後に、最初のキャンバスを作成する。2つ目のキャンバスをトリガーしたいステップを見つけ、ウェブフック付きの新しいステップを作成する。

ウェブフックを設定する際は、以下を参照のこと:

  • Webhook URL:[REST エンドポイント URL]7 の後に canvas/trigger/send を続けます。例えば、US-06 のインスタンスの場合、URL は https://rest.iad-06.braze.com/canvas/trigger/send となります。
  • 要求本文:Raw Text

リクエストヘッダと方法

Braze には、API キーを含む認証用の HTTP ヘッダーと、content-type を宣言する別の HTTP ヘッダーが必要です。

  • 要求ヘッダー:
    • 認証: ベアラー YOUR_API_KEY
    • Content-Type:application/json
  • HTTP メソッド:POST

YOUR_API_KEY を、canvas.trigger.send 権限を持つ Braze API キーに置き換えます。APIキーは、Brazeダッシュボードの「設定」>「APIキー」で作成できる。

Request body

テキストフィールドにcanvas/trigger/send リクエストを追加する。詳細については、[API トリガー配信によるキャンバスメッセージの送信]9 を参照してください。以下はこのエンドポイントのリクエスト本文の例です。ここで your_canvas_id は、2 つ目のキャンバスのキャンバス ID です:

1
2
3
4
5
6
7
8
{
      "canvas_id": "your_canvas_id",
      "recipients": [
        {
          "external_user_id": "{{${user_id}}}"
         }
      ]
}

知っておくべきこと

  • Braze-to-Braze Webhook は、エンドポイントのレート制限の対象となります。
  • ユーザー・プロフィールの更新には追加のデータ・ポイントが発生するが、メッセージング・エンドポイントを通じて別のメッセージがトリガーされることはない。
  • 匿名ユーザーをターゲットにしたい場合は、Webhook のリクエスト本文で、external_id の代わりにbraze_id を使用できます。
  • Braze-to-Brazeウェブフックをテンプレートとして保存し、再利用することができる。
  • メッセージ・アクティビティ・ログをチェックして、ウェブフックの失敗を確認し、トラブルシューティングすることができる。
「このページはどの程度役に立ちましたか?」
New Stuff!