ドキュメントExperience Platformタグ

Braze Track Events API イベント転送拡張機能

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

Braze は、消費者とブランドの間の顧客中心インタラクションをリアルタイムで強化する顧客エンゲージメントプラットフォームです。 Braze を使用すると、次の操作を実行できます。

  • 言語の好み、場所の好みなどに基づいてターゲットユーザーにデータ（マーケティングメッセージなど）を配信して、コンバージョン率を高め、主要なビジネス目標をサポートします。
  • 顧客は、メール、プッシュ通知、アプリ内メッセージなど、複数のチャネルをまたいで、適切なタイミングで、好みの言語でパーソナライズされたメッセージを送信します。
  • マーケティングおよびプロモーションキャンペーンの特定のユーザーをターゲットにして、リピート顧客の数を増やします。
  • ユーザーの行動とパターンを調査し、カスタマイズされたメッセージで特定のオーディエンスをターゲットに設定します。これは、売上高の増加に役立つ可能性があります。

Braze Track Events API イベント転送拡張機能を使用すると、Adobe Experience Platform Edge Networkで取得したデータを活用したり、Braze User Track API を使用してサーバーサイドイベントの形式で Braze に送信したりできます。

このドキュメントでは、拡張機能のユースケース、イベント転送ライブラリへのインストール方法およびイベント転送 ルールでその機能を使用する方法について説明します。

ユースケース

この拡張機能は、Edge Networkのデータを使用して、カスタマー分析とターゲティング機能を活用 Braze る場合に使用します。

例えば、マルチチャネルプレゼンス（web サイトとモバイル）を持ち、web サイトやモバイルプラットフォームからイベントデータとしてトランザクション入力や会話入力を取り込む小売組織について考えてみます。 様々な タグルールを使用して、このデータはリアルタイムでEdge Networkに送信されます。 ここから、Braze イベント転送拡張機能は、関連するイベントをサーバーサイドから Braze に自動的に送信します。

データが送信されたら、組織の分析チームはその機能を活用してデータセットを処理し、ビジネスインサイトを導き出して、グラフ、ダッシュボード、その他のビジュアライゼーションを生成し、ビジネス関係者に情報を提供で Braze’s ます。 プラットフォームの様々なユースケースについて詳しくは、Braze 顧客ページを参照してください。

Braze の前提条件とガードレール prerequisites

そのテクノロジーを使用するには、Braze アカウントが必要です。 アカウントをお持ちでない場合は、Braze の 基本を学ぶページに移動し、Braze Sales に接続してアカウント作成プロセスを開始します。

API ガードレール

この拡張機能では、Braze の API のうち 2 つを使用します。その制限について以下に概説します。

API
レート制限
User Track
1 分あたり 50,000 リクエスト。
詳しくは、User Track API ドキュメントを参照してください。
User Identify
1 分あたり 20,000 リクエスト。
詳しくは、User Identify API ドキュメントを参照してください。
NOTE
適用される制限について詳しくは、Braze API 制限に関するガイドを参照してください。

請求可能なデータポイント

追加のカスタム属性を Braze に送信すると、Braze データポイントの消費量が増える可能性があります。 追加のカスタム属性を送信する前に、Braze アカウントマネージャーにお問い合わせください。 詳しくは、 請求可能なデータポイントに関する Braze のドキュメントを参照してください。

必要な設定の詳細の収集 configuration-details

Edge Networkを Braze に接続するには、次の入力が必要です。

キータイプ
説明
例
Braze Instance
Braze アカウントに関連付けられた REST エンドポイント。 詳しくは、 インスタンスに関する Braze のドキュメントを参照してください。
https://rest.iad-03.braze.com
API キー
Braze アカウントに関連付けられた Braze API キー。
詳しくは、REST API キーに関する Braze ドキュメントを参照してください。
YOUR-BRAZE-REST-API-KEY

秘密鍵の作成

新しい イベント転送の秘密鍵を作成し、値を Braze API キーに設定します。 これは、値を保護しながら、アカウントへの接続を認証するために使用されます。

Braze 拡張機能のインストールと設定 install

拡張機能をインストールするには、 イベント転送プロパティを作成するか、代わりに編集する既存のプロパティを選択します。

左側のナビゲーションの「拡張機能」をクリックします。「カタログ」タブで、Braze 拡張機能のカードの インストール を選択します。

Braze 拡張機能をインストールします。

次の画面で、以前に Braze から収集した次の 設定値を入力します。

  • Braze Rest エンドポイント URL:Braze REST エンドポイント URL の値を、指定された入力にプレーンテキストとして入力できます。
  • API キー:Braze API キーを含む、以前に作成した 秘密鍵データ要素を選択します。

完了したら、「保存」をクリックします。

Braze 拡張機能の設定ページ

Send Event ルールの作成 tracking-rule

拡張機能をインストールした後、新しいイベント転送 ルールを作成し、必要に応じてその条件を設定します。 ルールのアクションを設定する場合は、Braze 拡張機能を選択してから、アクションタイプとして イベントを送信 を選択します。

イベント転送ルールアクション設定を追加します 。

ユーザーの識別

入力
説明
​ 外部ユーザー ID
長く、ランダムで、分散した UUID または GUID です。 ユーザー ID に名前を付ける別の方法を選択する場合は、長く、ランダムで、分散している必要があります。 詳しくは、 推奨されるユーザー ID 命名規則を参照してください。
Braze ユーザー ID
Braze ユーザー識別子。
​ ユーザーエイリアス ​
エイリアスは、一意のユーザー ID の代替として機能します。 エイリアスを使用して、コアユーザー ID とは異なるディメンションに沿ってユーザーを識別します。

ユーザーの alias オブジェクトは、識別子自体の alias_name と、エイリアスのタイプを示す alias_label の 2 つの部分で構成されています。 ユーザーは、異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに 1 つの alias_name のみです。
NOTE
ユーザーにイベントを結び付けるには、「​ 外部ユーザー ID」フィールド、「Braze ユーザー識別子 ​」フィールドまたは「​ ユーザーエイリアス ​」セクションのいずれかを入力する必要があります。

イベントデータ

入力
説明
必須
​ イベント名​
イベントの名前。
○
​ イベント時間 ​
ISO 8601 形式または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としての日時。
○
​ アプリ識別子 ​
アプリ識別子（app_id は、アクティビティをアプリグループ内の特定のアプリに関連付けるパラメーターです。 操作するアプリグループ内のアプリを指定します。 API 識別子のタイプについて詳しく説明します。
​ イベントのプロパティ ​
イベントのカスタムプロパティを含む JSON オブジェクト。
NOTE
Braze イベントの送信 アクションでは、イベント名 と イベント時間 のみを指定する必要がありますが、カスタムプロパティフィールドにはできるだけ多くの情報を含める必要があります。 Braze イベントオブジェクトについて詳しくは、 公式ドキュメントを参照してください。

ユーザー属性

ユーザー属性は、指定されたユーザープロファイル上で、指定された名前と値で属性を作成または更新するフィールドを含む JSON オブジェクトにすることができます。 次のプロパティがサポートされています。

ユーザー属性
説明
​ 名 ​
​ 姓 ​
電話
メール
​ 性別 ​
次の文字列の 1 つ：「M」、「F」、「O」（その他）、「N」（該当なし）、「P」（言いたくない）。
​ 市区町村 ​
国
ISO-3166-1 alpha-2 形式の文字列としての国。
言語
ISO-639-1 形式の文字列としての言語。
​ 生年月日 ​
「YYYY-MM-DD」形式の文字列（例：1980-12-21）。
タイムゾーン
IANA タイムゾーンデータベースからのタイムゾーン名（「アメリカ/ニューヨーク」や「東部時間（米国およびカナダ）」など）。
Facebook
ID （文字列）、likes （文字列の配列）、num_friends （整数）のいずれかを含むハッシュ。
Twitter
ID （整数）、screen_name （文字列、Twitterハンドル）、followers_count （整数）、friends_count （整数）、states_count （整数）のいずれかを含むハッシュ。

Send Purchase Event ルールの作成 purchase-rule

拡張機能をインストールした後、新しいイベント転送 ルールを作成し、必要に応じてその条件を設定します。 ルールのアクションを設定する際に、Braze 拡張機能を選択してから、アクションタイプに 購入イベントを送信 を選択します。

Braze 購入アクションタイプのイベント転送ルールアクション設定を追加します。

ユーザーの識別

入力
説明
​ 外部ユーザー ID
長く、ランダムで、分散した UUID または GUID です。 ユーザー ID に名前を付ける別の方法を選択する場合は、長く、ランダムで、分散している必要があります。 詳しくは、 推奨されるユーザー ID 命名規則を参照してください。
Braze ユーザー ID
Braze ユーザー識別子。
​ ユーザーエイリアス ​
エイリアスは、一意のユーザー ID の代替として機能します。 エイリアスを使用して、コアユーザー ID とは異なるディメンションに沿ってユーザーを識別します。

ユーザーの alias オブジェクトは、識別子自体の alias_name と、エイリアスのタイプを示す alias_label の 2 つの部分で構成されています。 ユーザーは、異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに 1 つの alias_name のみです。
NOTE
イベントをユーザーにリンクするには、「​ 外部ユーザー ID」フィールド、「Braze ユーザー識別子 ​」フィールド、「​ ユーザーエイリアス ​」セクションのいずれかを入力する必要があります。

購入データ

入力
説明
必須
​ 製品 ID ​
購入の識別子。 （例：製品名または製品カテゴリ）
○
​ 購入時間 ​
ISO 8601 形式または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としての日時。
○
​ 通貨​
ISO 4217 アルファベット通貨コード形式の文字列としての通貨。
○
​ 価​
価格：
○
​ 数量​
指定しない場合、デフォルト値は 1 になります。 最大値は 100 未満である必要があります。
​ アプリ識別子 ​
アプリ識別子（app_id は、アクティビティをアプリグループ内の特定のアプリに関連付けるパラメーターです。 操作するアプリグループ内のアプリを指定します。 API 識別子のタイプについて詳しく説明します。
​ 購入プロパティ ​
購入のカスタムプロパティを含む JSON オブジェクト。
NOTE
Braze イベントの送信 アクションでは、イベント名 と イベント時間 のみを指定する必要がありますが、カスタムプロパティフィールドにはできるだけ多くの情報を含める必要があります。 Braze イベントオブジェクトについて詳しくは、 公式ドキュメントを参照してください。

ユーザー属性

ユーザー属性は、指定されたユーザープロファイル上で、指定された名前と値で属性を作成または更新するフィールドを含む JSON オブジェクトにすることができます。 次のプロパティがサポートされています。

ユーザー属性
説明
​ 名 ​
​ 姓 ​
電話
メール
​ 性別 ​
次の文字列の 1 つ：「M」、「F」、「O」（その他）、「N」（該当なし）、「P」（言いたくない）。
​ 市区町村 ​
国
ISO-3166-1 alpha-2 形式の文字列としての国。
言語
ISO-639-1 形式の文字列としての言語。
​ 生年月日 ​
「YYYY-MM-DD」形式の文字列（例：1980-12-21）。
タイムゾーン
IANA タイムゾーンデータベースからのタイムゾーン名（「アメリカ/ニューヨーク」や「東部時間（米国およびカナダ）」など）。
Facebook
ID （文字列）、likes （文字列の配列）、num_friends （整数）のいずれかを含むハッシュ。
Twitter
ID （整数）、screen_name （文字列、Twitterハンドル）、followers_count （整数）、friends_count （整数）、states_count （整数）のいずれかを含むハッシュ。

Braze 内のデータの検証 validate

イベントの収集と Adobe Experience Platform の統合が成功した場合は、 ユーザープロファイルの表示時に Braze コンソール内にイベントが表示されます。 特に、Braze に送信された新しいイベントデータは、特定のユーザーの 概要タブの Purchases セクションに反映されます。

次の手順

このガイドでは、イベント転送を使用してコンバージョンイベントを Braze に送信する方法について説明しました。 Braze に送信されるイベントデータのダウンストリームアプリケーションについて詳しくは、 公式ドキュメントを参照してください。

Experience Platformのイベント転送機能について詳しくは、 イベント転送の概要を参照してください。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743