アカウントオブジェクト
アカウントオブジェクトを使用して、アカウントデータによるセグメンテーションとメッセージングのパーソナライゼーションを行います。
アカウントオブジェクトを使用すると、以下のことができます。
- アカウント条件でセグメントを構築する
- Liquidを通じてアカウント属性でメッセージをパーソナライズする
- アカウントレコードを一元管理する
アカウントオブジェクトは、ユーザープロファイルに接続されたワークスペースレベルのデータモデルです。アカウントレコードは、1つの特定のアカウントとそれに関連するフィールドデータです。 企業属性などのアカウントコンテキストがターゲティングやメッセージングのパーソナライゼーションに役立つ場合に、アカウントオブジェクトを使用します。 また、アカウント階層（親アカウントと子アカウントなど）をモデル化し、1つのユーザープロファイルを複数のアカウントにリンクすることもできます。
アカウントオブジェクトを使用する理由
キャンペーンやキャンバスで個々のユーザーにメッセージを送信する場合でも、ユースケースによってはアカウントレベルのコンテキストが必要になります。
アカウントオブジェクトを使用すると、アカウントデータを一度保存するだけで、Braze全体のセグメンテーションやパーソナライゼーションに再利用できます。
これにより、次のことが可能になります。
- アカウント属性でセグメント化する
- 共有のアカウントコンテキスト (会社名や業界など) でメッセージをパーソナライズする
- アカウント間の関係をモデル化し、1つのユーザープロファイルを複数のアカウントに関連付ける
このアプローチにより、同じアカウント属性を多数のユーザープロファイルに重複して保存する必要がなくなります。
前提条件
始める前に:
- ワークスペースでAccountsがプロビジョニングされている必要があります。Accountsは一般提供されていますが、ダッシュボードまたはデータオブジェクトエンドポイントを通じて使用する前に、プロビジョニングをリクエストする必要があります。手順については、ステップ 1: Accountsを有効にするを参照してください。
- Brazeにすでにユーザーが存在している必要があります。
アカウントデータモデル
各アカウントには、識別子 (id) と名前 (name) が必要です。
このセクションのアカウントフィールドは、アカウントオブジェクトのスキーマを定義します。これらのフィールドは、Braze に保存するすべての個別のアカウントレコードに適用されます。
Braze には、標準フィールドを備えたアカウントオブジェクトがデフォルトで含まれています。ユースケースに応じて、カスタムフィールドを追加または削除できます。フィールド名 id、object_id、display_name は予約されているため、カスタムフィールド名として使用することはできません。
| フィールド名 | フィールドタイプ | 必須 | 説明 |
|---|---|---|---|
id |
string | はい | アカウントのシステム ID (CRM ID など)。ワークスペース内で一意である必要があります。 |
name |
string | はい | アカウント名。 |
type |
string | いいえ | 顧客、パートナー、リセラーなどのアカウントタイプ。 |
annual_revenue |
number | いいえ | アカウントの年間収益。 |
industry |
string | いいえ | アカウントの業種。 |
number_of_employees |
number | いいえ | 従業員数。 |
address |
string | いいえ | 番地。 |
city |
string | いいえ | 市区町村。 |
state |
string | いいえ | 州または都道府県。 |
postal_code |
string | いいえ | 郵便番号。 |
country |
string | いいえ | 国。 |
notes |
string | いいえ | 追加のメモ。 |
website |
string | いいえ | Web サイトの URL。 |
main_phone |
string | いいえ | 主要な電話番号。 |
created_date |
time | いいえ | アカウント作成のタイムスタンプ。 |
sic_code |
string | いいえ | 標準産業分類 (SIC) コード。 |
| カスタムフィールド | custom | いいえ | ユーザーが定義および管理するフィールド。 |
データ統合オプション
アカウントレコードは以下の方法で管理できます。
- アカウントレコード用の REST API エンドポイント
- 個々のレコードの場合は、データ設定 > アカウントでのブラウザ内編集
はじめに
ステップ 1:アカウントを有効にする
アカウントは会社レベルで有効になります。プロビジョニングをリクエストするには:
- Braze ダッシュボードで、データ設定 > アカウントに移動します。
- アンケートに回答します。
アンケートを送信すると、Braze に転送されてレビューが行われます。通常、1週間以内に回答が届きます。大規模なユースケースの場合は、さらに時間がかかることがあります。
プロビジョニングが完了したら、データ設定 > アカウントに移動し、表示された場合は1回限りの初期化フローを完了します。
ステップ 2:アカウントレコードを追加する
REST API またはブラウザー内編集を使用して、アカウントレコードを追加または更新します。
ステップ 3:アカウント条件の計算フィルターを作成する
アカウントデータでセグメント化する前に、アカウント条件を定義する計算フィルターを作成します。
- オーディエンス > 計算フィルターに移動します。
- フィルターを作成を選択し、次にデータオブジェクトフィルターを選択します。
- アカウント条件を定義します。
詳細については、計算フィルターを参照してください。
ステップ 4:セグメントビルダーで計算フィルターを使用する
セグメントビルダーで作成した計算フィルターを選択し、キャンペーンやキャンバスのターゲティングに役立つユーザー属性フィルターを必要に応じて追加します。
制限
アカウントには、ほとんどのユースケースに対応できるよう、次のデフォルトの制限があります。
| リソース | デフォルトの制限 |
|---|---|
| 会社あたりのアカウントレコード数 | 50,000 |
| アカウントタイプあたりのフィールド数 | 500 |
| リレーションシップタイプあたりのフィールド数 | 25 |
| ユーザーあたりのアカウントオブジェクト数 | 1,000 |
| アカウントオブジェクトあたりのユーザー数 | 10,000 |
| アカウントオブジェクトあたりの関連オブジェクト数 | 1,000 |
これらは初期の容量です。アカウントレコードをさらに追加したい場合や、より高い制限が必要な場合は、Braze のアカウントチームに連絡して引き上げをリクエストしてください。
制限に関するエラーコードや、API リクエストが制限を超える場合の動作については、製品の制限を参照してください。
アカウントベースのセグメントを作成する
アカウントレコードと計算フィルターの準備ができたら、次の手順を実行します。
- セグメントビルダーに移動します。
- アカウント条件用に事前設定した計算フィルターを追加します。
- 必要に応じて、追加のユーザー属性フィルターを追加します。
- セグメントを保存します。
例:
- 計算フィルター: アカウントの
industryがhealthcareと完全に一致する - ユーザー属性フィルター:
days_since_last_loginが30未満である
Liquidでパーソナライズする
{% data_object account %} Liquidタグを使用して、ユーザーのアカウントデータを data_objects 配列に読み込みます。
プレビューとテストを使用する場合は、パーソナライゼーションが正しく解決されるよう、アカウントデータを含むセグメントを使用してください。
{% data_object account %}
Hi {{${first_name}}},
We'd love to invite you and your peers at {{ data_objects[0].name }}.
一致したすべてのアカウントを反復処理するには、次のようにします。
{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}
APIの基本
REST APIを使用して、アカウントレコードを管理できます。
エンドポイントの詳細については、Data Objectsエンドポイントを参照してください。
認証とRESTエンドポイントの基本については、Braze APIの概要を参照してください。
よくある質問
アカウントにカスタムフィールドを追加できますか?
はい。ワークスペースでカスタムアカウントフィールドを定義し、管理できます。フィールドの要件については、アカウントデータモデルを参照してください。
Accountsは有料のアドオンですか?
いいえ。Accountsは有料のアドオンではなく、すべてのプランで利用できます。ただし、使用する前にワークスペースのプロビジョニングが必要です。手順については、ステップ1:Accountsを有効にするを参照してください。