Track Events APIイベント転送拡張機能
Braze Track Events APIのイベント転送拡張機能を使用すると、Adobe Experience Platform Edge Networkでキャプチャされたデータを利用して、
/users/trackAPIを使用してサーバーサイドのイベントの形式でBrazeに送信できます。
このドキュメントでは、拡張機能のユースケース、イベント転送ライブラリへのインストール方法、およびイベント転送ルールでその機能を使用する方法について説明します。
Adobeイベント転送を使用すると、Brazeのデータポイント使用量が増加する可能性があります。詳細については、データポイントに関するBrazeのドキュメントを参照してください。
ユースケース
この拡張機能は、Brazeの顧客分析およびターゲティング機能を活用するために、Edge Networkからのデータを使用します。
たとえば、マルチチャネルプレゼンス（Webサイトとモバイル）を展開しており、Webサイトプラットフォームとモバイルプラットフォームからトランザクション入力や会話入力をイベントデータとして取得している小売組織について考えてみます。
さまざまなタグルールを使用して、このデータはリアルタイムでEdge Networkに送信されます。ここからBrazeイベント転送拡張機能により、関連するイベントがサーバーサイドからBrazeへ自動的に送信されます。
レート制限
| API | レート制限 |
|---|---|
| User Track | 1分あたり50,000件のリクエスト。 詳細については、User Track APIのドキュメントを参照してください。 |
統合
ステップ1:必要な設定の詳細を収集する
Edge NetworkをBrazeに接続するには、以下が必要です。
| キーのタイプ | 説明 |
|---|---|
| Brazeインスタンス | Brazeインスタンスは、Brazeオンボーディングマネージャーから入手できます。また、API概要ページでも確認できます。 |
| Braze REST APIキー | すべての権限を持つBraze REST APIキー。 これは、BrazeダッシュボードのSettings > API Keysから作成できます。 |
ステップ2:シークレットを作成する
新しいイベント転送シークレットを作成し、値をBraze APIキーに設定します。これは、アカウントへの接続を認証し、値を安全に保護するために使用されます。
ステップ3:Braze拡張機能をインストールして設定する
- 拡張機能をインストールするには、イベント転送プロパティを作成するか、既存のプロパティを編集することを選択します。
- 次に、左側のナビゲーションでExtensionsを選択します。Catalogタブで、Braze拡張機能のカードのInstallを選択します。
- 次の画面で、RESTインスタンスとAPIキーを入力し、完了したらSaveを選択します。
ステップ4:送信イベントルールを作成する
拡張機能をインストールした後、新しいイベント転送ルールを作成し、必要に応じてその条件を設定します。ルールのアクションを設定する際に、Braze拡張機能を選択し、アクションタイプとしてSend Eventを選択します。
| 入力 | 説明 |
|---|---|
| 外部ユーザーID | 長く、ランダムで、よく分散されたUUIDまたはGUID。ユーザーIDの命名に別の方法を選択する場合、それらも長く、ランダムで、よく分散されている必要があります。推奨されるユーザーID命名規則について詳しく学びます。 |
| BrazeユーザーID | Brazeユーザー識別子。 |
| ユーザーエイリアス | エイリアスは、代替の一意のユーザー識別子として機能します。エイリアスを使用して、コアユーザーIDとは異なる次元でユーザーを識別します。 ユーザーエイリアスオブジェクトは2つの部分で構成されています。識別子自体の alias_nameとエイリアスの種類を示すalias_labelです。ユーザーは異なるラベルを持つ複数のエイリアスを持つことができますが、alias_nameはalias_labelごとに1つしか持つことができません。 |
イベントをユーザーに結びつけるには、External User IDフィールド、Braze User Identifierフィールド、またはUser Aliasセクションのいずれかを入力する必要があります。
| 入力 | 説明 | 必須 |
|---|---|---|
| イベント名 | イベントの名前。 | はい |
| イベント時間 | ISO 8601またはyyyy-MM-dd'T'HH:mm:ss:SSSZ形式の日付時刻文字列。 |
はい |
| アプリ識別子 | アプリ識別子またはapp_idは、ワークスペース内の特定のアプリとアクティビティを関連付けるパラメーターです。ワークスペース内のどのアプリと対話するかを指定します。 |
いいえ |
| イベントプロパティ | イベントのカスタムプロパティを含むJSONオブジェクト。 | いいえ |
Braze Send EventアクションにはEvent NameとEvent Timeを指定するだけで済みますが、カスタムプロパティフィールドにはできるだけ多くの情報を含めるべきです。詳細についてはイベントオブジェクトを参照してください。
ユーザー属性は、指定されたユーザープロファイル上の指定された名前と値で属性を作成または更新するフィールドを含むJSONオブジェクトにすることができます。次のプロパティがサポートされています。
| ユーザー属性 | 説明 |
|---|---|
| 名 | ユーザーの名。 |
| 姓 | ユーザーの姓。 |
| 電話 | ユーザーの電話番号。 |
| メール | ユーザーのメールアドレス。 |
| 性別 | 次の文字列のいずれか:「M」、「F」、「O」（その他）、「N」（該当なし）、「P」（回答しない）。 |
| 市区町村 | ユーザーの市区町村。 |
| 国 | ISO-3166-1 alpha-2形式の文字列としてのユーザーの国。 |
| 言語 | ISO-639-1形式の文字列としてのユーザーの言語。 |
| 生年月日 | 「YYYY-MM-DD」形式の文字列としてのユーザーの生年月日（例：1980-12-21）。 |
| タイムゾーン | IANAタイムゾーンデータベースからのタイムゾーン名（例：’America/New_York’または’Eastern Time (US & Canada)’）。 |
id（文字列）、likes（文字列の配列）、num_friends（整数）のいずれかを含むハッシュ。 |
|
id（整数）、screen_name（文字列、X（旧Twitter）ハンドル）、followers_count（整数）、friends_count（整数）、statuses_count（整数）のいずれかを含むハッシュ。 |
設定内で追加されたすべての属性は、属性の値が変更されたかどうかに関係なく、イベントがBrazeに送信されるたびに送信されます。ユーザー属性を設定する際には、これがデータポイント使用量にどのような影響を与えるかを確認してください。
ステップ5:購入イベント送信ルールを作成する
拡張機能をインストールした後、新しいイベント転送ルールを作成し、必要に応じてその条件を設定します。ルールのアクションを設定する際に、Braze拡張機能を選択し、アクションタイプとしてSend Purchase Eventを選択します。
| 入力 | 説明 |
|---|---|
| 外部ユーザーID | 長く、ランダムで、よく分散されたUUIDまたはGUID。ユーザーIDの命名に別の方法を選択する場合、それらも長く、ランダムで、よく分散されている必要があります。推奨されるユーザーID命名規則について詳しく学びます。 |
| BrazeユーザーID | Brazeユーザー識別子。 |
| ユーザーエイリアス | エイリアスは、代替の一意のユーザー識別子として機能します。エイリアスを使用して、コアユーザーIDとは異なる次元でユーザーを識別します。 ユーザーエイリアスオブジェクトは2つの部分で構成されています。識別子自体の alias_nameとエイリアスの種類を示すalias_labelです。ユーザーは異なるラベルを持つ複数のエイリアスを持つことができますが、alias_nameはalias_labelごとに1つしか持つことができません。 |
イベントをユーザーにリンクするには、External User IDフィールド、Braze User Identifierフィールド、またはUser Aliasセクションのいずれかを入力する必要があります。
| 入力 | 説明 | 必須 |
|---|---|---|
| プロダクトID | 購入の識別子（例：製品名や製品カテゴリ）。 | はい |
| 購入時刻 | ISO 8601またはyyyy-MM-dd'T'HH:mm:ss:SSSZ形式の日付時刻文字列。 |
はい |
| 通貨 | ISO 4217アルファベット通貨コード形式の文字列としての通貨。 | はい |
| 価格 | オブジェクトの価格。 | はい |
| 数量 | 購入数量。指定されていない場合、デフォルト値は1になります。最大値は100未満にする必要があります。 | いいえ |
| アプリ識別子 | アプリ識別子またはapp_idは、ワークスペース内の特定のアプリとアクティビティを関連付けるパラメーターです。ワークスペース内のどのアプリと対話するかを指定します。 |
いいえ |
| 購入プロパティ | 購入のカスタムプロパティを含むJSONオブジェクト。 | いいえ |
Send Purchase EventアクションにはProduct ID、Purchase Time、Currency、およびPriceのみを指定する必要がありますが、購入プロパティフィールドにはできるだけ多くの情報を含めるべきです。詳細については購入オブジェクトを参照してください。
設定ビュー内で各イベントに属性を送信するかどうかを選択できます。
ユーザー属性は、指定されたユーザープロファイル上の指定された名前と値で属性を作成または更新するフィールドを含むJSONオブジェクトにすることができます。次のプロパティがサポートされています。
| ユーザー属性 | 説明 |
|---|---|
| 名 | ユーザーの名。 |
| 姓 | ユーザーの姓。 |
| 電話 | ユーザーの電話番号。 |
| メール | ユーザーのメールアドレス。 |
| 性別 | 次の文字列のいずれか:「M」、「F」、「O」（その他）、「N」（該当なし）、「P」（回答しない）。 |
| 市区町村 | ユーザーの市区町村。 |
| 国 | ISO-3166-1 alpha-2形式の文字列としてのユーザーの国。 |
| 言語 | ISO-639-1形式の文字列としてのユーザーの言語。 |
| 生年月日 | 「YYYY-MM-DD」形式の文字列としてのユーザーの生年月日（例：1980-12-21）。 |
| タイムゾーン | IANAタイムゾーンデータベースからのタイムゾーン名（例：’America/New_York’または’Eastern Time (US & Canada)’）。 |
id（文字列）、likes（文字列の配列）、num_friends（整数）のいずれかを含むハッシュ。 |
|
id（整数）、screen_name（文字列、X（旧Twitter）ハンドル）、followers_count（整数）、friends_count（整数）、statuses_count（整数）のいずれかを含むハッシュ。 |
設定内で追加されたすべての属性は、属性の値が変更されたかどうかに関係なく、イベントがBrazeに送信されるたびに送信されます。ユーザー属性を設定する際には、これがデータポイント使用量にどのような影響を与えるかを確認してください。
ステップ6:Braze内のデータを検証する
イベントコレクションとAdobe Experience Platformの統合が成功した場合、ユーザープロファイルを表示する際にBrazeコンソール内にイベントが表示されます。具体的には、Brazeに送信された新しいイベントデータは、特定のユーザーの概要タブのPurchasesまたはCustom Eventsセクションに反映されます。