ドキュメントExperience Platformタグ

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

Last update: Thu Dec 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：
  • Tags

作成対象：

  • Developer

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

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

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

このドキュメントでは、拡張機能の使用例、イベント転送ライブラリでのインストール方法、イベント転送での拡張機能の使用方法について説明します ルール.

ユースケース

この拡張機能は、 Braze を使用して、顧客分析およびターゲティング機能を活用します。

例えば、マルチチャネルの存在（Web サイトとモバイル）があり、Web サイトやモバイルプラットフォームからイベントデータとしてトランザクション入力や会話入力を取り込む小売組織について考えてみましょう。 各種の タグ ルールを使用する場合、このデータはリアルタイムで Edge ネットワークに送信されます。 ここから、 Braze イベント転送拡張機能は、関連イベントをに自動的に送信します。 Braze をサーバー側から削除します。

データを送信したら、組織の分析チームは Braze’s データセットを処理し、ビジネスインサイトを導き出してグラフ、ダッシュボード、その他のビジュアライゼーションを生成し、ビジネス関係者に通知する機能です。 詳しくは、 Braze 顧客 ページを参照してください。

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

次をお持ちの場合は、 Braze その技術を使用するためのアカウント。 アカウントがない場合は、 はじめにページ オン Braze 接続する Braze Sales アカウント作成プロセスを開始します。

API ガードレール

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

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 ネットワークをに接続するには Brazeの場合、次の入力が必要です。

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

秘密鍵の作成

新規作成 イベント転送秘密鍵 の値を Braze API キー. これは、値のセキュリティを維持しながら、アカウントへの接続を認証するために使用されます。

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

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

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

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

次の画面で、次の情報を入力します。 設定値 以前に集めた Braze:

  • Rest エンドポイント URL をブレーズ：の値を入力できます。 Braze rest エンドポイント URL を指定された入力内のプレーンテキストとして指定します。
  • API キー：を選択します。 シークレットデータ要素 先ほど作成したが、 Braze API キー。

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

The Braze 拡張機能の設定ページ。

の作成 Send Event ルール tracking-rule

拡張機能をインストールしたら、新しいイベント転送を作成します。 ルール 必要に応じて、条件を設定します。 ルールのアクションを設定する際に、 ブレーズ 拡張機能、「 イベントの送信 （アクションタイプ用）。

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

ユーザー ID

入力
説明
外部ユーザー ID
長く、ランダムで分散された UUID または GUID。 別の方法でユーザー ID に名前を付ける場合は、長い、ランダムで、十分に分散されている必要もあります。 詳細情報： 推奨されるユーザー ID の命名規則.
ユーザー ID をブレーズ
ユーザー ID をブレーズします。
ユーザーエイリアス
エイリアスは、別の一意のユーザー識別子として機能します。 エイリアスを使用して、コアユーザー ID とは異なるディメンションでユーザーを識別します。

ユーザーの alias オブジェクトは、識別子自体の alias_name と、エイリアスの種類を示す alias_label の 2 つの部分で構成されます。 ユーザーは異なるラベルを持つ複数の別名を持つことができますが、 alias_label 1 つにつき alias_name は 1 つだけです。
NOTE
イベントをユーザーに提供する場合は、 外部ユーザー ID フィールド、または ユーザー識別子を編集 フィールドまたは ユーザーエイリアス 」セクションに入力します。

イベントデータ

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

ユーザー属性

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

ユーザー属性
説明
名
姓
電話
メール
性別
「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（整数）、statuses_count（整数）のいずれかを含むハッシュ。

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

拡張機能をインストールしたら、新しいイベント転送を作成します。 ルール 必要に応じて、条件を設定します。 ルールのアクションを設定する際に、 ブレーズ 拡張機能、「 購入イベントの送信 （アクションタイプ用）。

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

ユーザー ID

入力
説明
外部ユーザー ID
長く、ランダムで分散された UUID または GUID。 別の方法でユーザー ID に名前を付ける場合は、長い、ランダムで、十分に分散されている必要もあります。 詳細情報： 推奨されるユーザー ID の命名規則.
ユーザー ID をブレーズ
ユーザー ID をブレーズします。
ユーザーエイリアス
エイリアスは、別の一意のユーザー識別子として機能します。 エイリアスを使用して、コアユーザー ID とは異なるディメンションでユーザーを識別します。

ユーザーの alias オブジェクトは、識別子自体の alias_name と、エイリアスの種類を示す alias_label の 2 つの部分で構成されます。 ユーザーは異なるラベルを持つ複数の別名を持つことができますが、 alias_label 1 つにつき alias_name は 1 つだけです。
NOTE
イベントをユーザーにリンクするには、 外部ユーザー ID フィールド、 ユーザー識別子を編集 フィールド、または ユーザーエイリアス 」セクションに入力します。

購入データ

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

ユーザー属性

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

ユーザー属性
説明
名
姓
電話
メール
性別
「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（整数）、statuses_count（整数）のいずれかを含むハッシュ。

内のデータの検証 Braze validate

イベント収集および Adobe Experience Platform 統合に成功した場合は、 Braze コンソールの場合： ユーザープロファイルの表示. 特に、に送信される新しいイベントデータ Braze が Purchases 特定のユーザーの 「概要」タブ.

次の手順

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

Experience Platformのイベント転送機能について詳しくは、 イベント転送の概要.

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