Track Events API イベント転送拡張機能
Braze Track Events API のイベント転送拡張機能を使用すると、Adobe Experience Platform Edge Network でキャプチャされたデータを利用して、
/users/trackAPI を使用してサーバーサイドのイベントの形式でデータを Braze に送信できます。
このドキュメントは、拡張機能の使用例、イベント転送ライブラリへのインストール方法、およびイベント転送ルールでその機能を使用する方法について説明しています。
Adobeイベント転送を使用すると、Brazeデータポイントの使用量が増加する可能性がある。詳細については、データポイントに関するBrazeのドキュメントを参照のこと。
ユースケース
この拡張機能は、顧客分析およびターゲティング機能を利用するために、Braze で Edge Network からのデータを使用する必要があります。
たとえば、マルチチャネルプレゼンス (Web サイトとモバイル) で展開しており、Web サイトプラットフォームとモバイルプラットフォームからトランザクション入力と会話入力をイベントデータとして取得している小売組織について考えてみます。
さまざまなタグルールを使用して、このデータはリアルタイムでエッジネットワークに送信されます。ここから Braze イベント転送拡張機能により、関連するイベントがサーバーサイドから Braze へ自動的に送信されます。
レート制限
| API | レート制限 |
|---|---|
| ユーザー トラック | 1分あたり50,000件のリクエスト。 詳細については、User Track API のドキュメントを参照してください。 |
統合
ステップ1:必要な構成の詳細を収集する
Edge Network を Braze に接続するには、次のものが必要です。
| キーのタイプ | 説明 |
|---|---|
| Brazeインスタンス | Braze インスタンスは Braze オンボーディングマネージャーから入手できます。また、API 概要ページでも確認できます。 |
| Braze REST API キー | すべての権限を持つBraze REST APIキー。 これは、Brazeダッシュボードの「設定」>「APIキー」から作成できる。 |
ステップ2:シークレットを作成する
新しいイベント転送シークレットを作成し、値をBraze API キーに設定します。これは、アカウントへの接続を認証し、値を安全に保護するために使用されます。
ステップ 3:Braze拡張機能をインストールして構成する
- 拡張機能をインストールするには、イベント転送プロパティを作成するか、既存のプロパティを編集することを選択します。
- 次に、左側のナビゲーションで拡張機能を選択します。「カタログ」タブで、Braze拡張機能のカードの「インストール」を選択します。
- 次の画面で、REST インスタンスと API キーを入力し、完了したら保存を選択します。
ステップ4:送信イベントルールを作成する
拡張機能をインストールした後、新しいイベント転送ルールを作成し、必要に応じてその条件を設定します。ルールのアクションを構成する際に、Braze拡張機能を選択し、アクションタイプとしてイベントを送信を選択します。
| インプット | 説明 |
|---|---|
| 外部ユーザ 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形式の文字列です。 |
| 生年月日 | 文字列形式のユーザーの生年月日（例：1980-12-21）。 |
| タイムゾーン | IANAタイムゾーンデータベースからのタイムゾーン名（例えば、’America/New_York’ または「Eastern Time (US& Canada)」）。 |
id（文字列）、likes（文字列の配列）、num_friends（整数）のいずれかを含むハッシュ。 |
|
screen_name (整数)、followers_count (文字列、X (旧 Twitter) ハンドル)、friends_count (整数)、statuses_count (整数) のいずれかを含むハッシュ。 |
構成内で追加されたすべての属性は、属性の値が変更されたかどうかに関係なく、イベントがBrazeに送信されるたびに送信されます。ユーザー属性を設定する際には、これがデータポイント使用量にどのような影響を与えるかを確認しておくこと。
ステップ 5: 購入イベント送信ルールを作成する
拡張機能をインストールした後、新しいイベント転送ルールを作成し、必要に応じてその条件を設定します。ルールのアクションを構成する際に、Braze拡張機能を選択し、アクションタイプとして購入イベントを送信を選択します。
| インプット | 説明 |
|---|---|
| 外部ユーザ 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形式の文字列です。 |
| 生年月日 | 文字列形式のユーザーの生年月日（例：1980-12-21）。 |
| タイムゾーン | IANAタイムゾーンデータベースからのタイムゾーン名（例えば、’America/New_York’ または「Eastern Time (US& Canada)」）。 |
id（文字列）、likes（文字列の配列）、num_friends（整数）のいずれかを含むハッシュ。 |
|
screen_name (整数)、followers_count (文字列、X (旧 Twitter) ハンドル)、friends_count (整数)、statuses_count (整数) のいずれかを含むハッシュ。 |
構成内で追加されたすべての属性は、属性の値が変更されたかどうかに関係なく、イベントがBrazeに送信されるたびに送信されます。ユーザー属性を設定する際には、これがデータポイント使用量にどのような影響を与えるかを確認してほしい。
ステップ 6: Braze内のデータを検証する
イベントコレクションとAdobe Experience プラットフォームの統合が成功した場合、ユーザープロファイルを表示するときにBrazeコンソール内にイベントが表示されます。具体的には、Brazeに送信された新しいイベントデータは、特定のユーザーの購入またはカスタムイベントセクションの概要タブに反映されます。
GitHub でこのページを編集