アカウントオブジェクト
アカウントオブジェクトを使用して、アカウントデータによるセグメンテーションとメッセージングのパーソナライゼーションを行います。
アカウントオブジェクトを使用すると、以下のことができます。
- アカウント条件でセグメントを構築する
- Liquidを通じてアカウント属性でメッセージをパーソナライズする
- アカウントレコードを一元管理する
アカウントオブジェクトは、ユーザープロファイルに接続されたワークスペースレベルのデータモデルです。アカウントレコードは、1つの特定のアカウントとそれに関連するフィールドデータです。 企業属性などのアカウントコンテキストがターゲティングやメッセージングのパーソナライゼーションに役立つ場合に、アカウントオブジェクトを使用します。 また、アカウント階層（親アカウントと子アカウントなど）をモデル化し、1つのユーザープロファイルを複数のアカウントにリンクすることもできます。
アカウントオブジェクトを使用する理由
キャンペーンやキャンバスの送信先が個々のユーザーであっても、ユースケースによってはアカウントレベルのコンテキストが必要になる場合があります。
アカウントオブジェクトを使用すると、アカウントデータを一度保存するだけで、Braze全体のセグメンテーションやパーソナライゼーションで再利用できます。
これにより、次のことが可能になります。
- アカウント属性でセグメント化する
- 共有のアカウントコンテキスト (会社名や業種など) を使用してメッセージをパーソナライズする
- アカウント間の関係をモデル化し、1つのユーザープロファイルを複数のアカウントに関連付ける
このアプローチにより、同じアカウント属性を多数のユーザープロファイルに重複して保存する必要がなくなります。
前提条件
開始する前に、以下を確認してください。
- ワークスペースでアカウントがプロビジョニングされている必要があります。アカウントは一般提供されていますが、ダッシュボードまたはデータオブジェクトエンドポイントで使用する前に、プロビジョニングをリクエストする必要があります。手順については、ステップ1: アカウントを有効にするを参照してください。
- Braze にすでにユーザーが存在している必要があります。
アカウントデータモデル
各アカウントには、識別子 (id) と名前 (name) が必要です。
このセクションのアカウントフィールドは、アカウントオブジェクトのスキーマを定義します。これらのフィールドは、Braze に保存するすべての個別アカウントレコードに適用されます。
Braze には、標準フィールドを含むアカウントオブジェクトがデフォルトで用意されています。ユースケースに応じて、カスタムフィールドを追加または削除できます。フィールド名 id、object_id、display_name は予約されているため、カスタムフィールド名として使用することはできません。
| フィールド名 | フィールドタイプ | 必須 | 説明 |
|---|---|---|---|
id |
文字列 | はい | アカウントのシステム ID (例: CRM ID)。ワークスペース内で一意である必要があります。 |
name |
文字列 | はい | アカウント名。 |
type |
文字列 | いいえ | 顧客、パートナー、リセラーなどのアカウントタイプ。 |
annual_revenue |
数値 | いいえ | アカウントの年間収益。 |
industry |
文字列 | いいえ | アカウントの業種。 |
number_of_employees |
数値 | いいえ | 従業員数。 |
address |
文字列 | いいえ | 番地。 |
city |
文字列 | いいえ | 市区町村。 |
state |
文字列 | いいえ | 都道府県または州。 |
postal_code |
文字列 | いいえ | 郵便番号。 |
country |
文字列 | いいえ | 国。 |
notes |
文字列 | いいえ | 補足事項。 |
website |
文字列 | いいえ | Web サイトの URL。 |
main_phone |
文字列 | いいえ | 主要な電話番号。 |
created_date |
時間 | いいえ | アカウント作成のタイムスタンプ。 |
sic_code |
文字列 | いいえ | 標準産業分類 (SIC) コード。 |
| カスタムフィールド | カスタム | いいえ | ユーザーが定義および管理するフィールド。 |
データ統合オプション
アカウントレコードは次の方法で管理できます。
- アカウントレコード用の REST API エンドポイント
- 個々のレコードについては、データ設定 > アカウントでのブラウザー内編集
はじめに
ステップ 1: Accounts を有効にする
Accounts は会社レベルで有効になります。プロビジョニングをリクエストするには、次の手順を実行します。
- Braze ダッシュボードで、データ設定 > Accounts に移動します。
- アンケートに記入します。
アンケートを送信すると、Braze に転送されて審査が行われます。通常は 1 週間以内に回答が届きます。大規模なユースケースの場合は、さらに時間がかかることがあります。
プロビジョニングが完了したら、データ設定 > Accounts に移動し、プロンプトが表示された場合は 1 回限りの初期化フローを完了します。
ステップ 2: アカウントレコードを追加する
REST API またはブラウザー内での編集を使用して、アカウントレコードを追加または更新します。
ステップ 3: アカウント条件の計算フィルターを作成する
アカウントデータでセグメンテーションを行う前に、アカウント条件を定義する計算フィルターを作成します。
- オーディエンス > 計算フィルター に移動します。
- フィルターを作成 を選択し、次に データオブジェクトフィルター を選択します。
- アカウント条件を定義します。
詳細については、計算フィルターを参照してください。
ステップ 4: セグメントビルダーで計算フィルターを使用する
セグメントビルダーで、作成した計算フィルターを選択し、キャンペーンまたはキャンバスのターゲティングに役立つユーザー属性フィルターを必要に応じて追加します。
制限
Accounts には、ほとんどのユースケースに対応できるよう、以下のデフォルト制限が設定されています。
| リソース | デフォルトの制限 |
|---|---|
| 会社あたりのアカウントレコード数 | 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を使用して、アカウントレコードを管理できます。
エンドポイントの詳細については、データオブジェクトエンドポイントを参照してください。
認証と REST エンドポイントの基本については、Braze API の概要を参照してください。
クラウドデータ取り込み
クラウドデータ取り込み (CDI) を使用すると、データウェアハウスから Braze にアカウントレコードを直接同期できます。設定手順と同期の構成については、クラウドデータ取り込みでデータオブジェクトを同期するを参照してください。
よくある質問
アカウントにカスタムフィールドを追加できますか?
はい。ワークスペースでカスタムアカウントフィールドを定義して管理できます。フィールドの要件については、アカウントデータモデルを参照してください。
Accountsは有料アドオンですか?
いいえ。Accountsは有料アドオンではなく、すべてのプランで利用できます。ただし、使用を開始する前にワークスペースのプロビジョニングが必要です。手順については、ステップ1:Accountsを有効にするを参照してください。