アカウントオブジェクト
アカウントオブジェクトを使用して、アカウントデータによるセグメンテーションとメッセージングのパーソナライゼーションを行います。
アカウントは早期アクセス段階です。機能の進化に伴い、これらの手順は変更される場合があります。
アカウントオブジェクトを使用すると、以下のことができます。
- アカウント条件でセグメントを構築する
- Liquidを通じてアカウント属性でメッセージをパーソナライズする
- アカウントレコードを一元管理する
アカウントオブジェクトは、ユーザープロファイルに接続されたワークスペースレベルのデータモデルです。アカウントレコードは、1つの特定のアカウントとそれに関連するフィールドデータです。 企業属性などのアカウントコンテキストがターゲティングやメッセージングのパーソナライゼーションに役立つ場合に、アカウントオブジェクトを使用します。 また、アカウント階層（親アカウントと子アカウントなど）をモデル化し、1つのユーザープロファイルを複数のアカウントにリンクすることもできます。
アカウントオブジェクトを使用する理由
一部のユースケースでは、キャンペーンやキャンバスが個々のユーザーに送信される場合でも、アカウントレベルのコンテキストが必要です。
アカウントオブジェクトを使用すると、アカウントデータを一度保存し、Braze全体でセグメンテーションやパーソナライゼーションに再利用できます。
これにより、以下のことが可能になります。
- アカウント属性でセグメントする
- 共有アカウントコンテキスト（会社名や業種など）でメッセージをパーソナライズする
- アカウント間の関係をモデル化し、1つのユーザープロファイルを複数のアカウントに接続する
このアプローチにより、同じアカウント属性を多数のユーザープロファイルに複製する必要がなくなります。
前提条件
始める前に以下を確認してください：
- ワークスペースでアカウント早期アクセスが有効になっている必要があります。Brazeアカウントチームにお問い合わせください。
- Brazeにユーザーがすでに存在している必要があります。
- アカウントが有効になると、データ設定 > アカウントに表示されます。アカウントを初めて使用する場合は、画面上の初期化手順に従ってください。
アカウントデータモデル
各アカウントには識別子（id）と名前（name）が必要です。
このセクションのアカウントフィールドは、アカウントオブジェクトのスキーマを定義します。これらのフィールドは、Brazeに保存するすべての個別アカウントレコードに適用されます。
Brazeはデフォルトで標準フィールドを持つアカウントオブジェクトを含んでいます。ユースケースに基づいてカスタムフィールドを追加・削除できます。フィールド名 id、external_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 | いいえ | 標準産業分類コード。 |
| カスタムフィールド | custom | いいえ | 定義・管理するフィールド。 |
データ統合オプション
アカウントレコードは以下の方法で管理できます。
- アカウントレコード用のREST APIエンドポイント
- データ設定 > アカウントでのブラウザ内編集（個別レコード向け）
はじめに
ステップ1：Accounts を有効にする
Accounts は会社レベルで有効化されます。早期アクセス期間中は、Braze アカウントチームが1回限りの有効化を行います。
Accounts が有効になったら、データ設定 > Accounts に移動し、プロンプトが表示された場合は1回限りの初期化フローを完了してください。
ステップ2：アカウントレコードを追加する
REST APIまたはブラウザ内編集を通じて、アカウントレコードを追加または更新します。
ステップ3：アカウント条件の計算フィルターを作成する
アカウントデータでセグメンテーションを行う前に、アカウント条件を定義する計算フィルターを作成します。
- オーディエンス > 計算フィルターに移動します。
- フィルターを作成を選択し、データオブジェクトフィルターを選択します。
- アカウント条件を定義します。
詳細については、計算フィルターを参照してください。
ステップ4：セグメントビルダーで計算フィルターを使用する
セグメントビルダーで、作成した計算フィルターを選択し、キャンペーンやキャンバスのターゲティングに必要な追加のユーザー属性フィルターを設定します。
アカウントベースのセグメントを作成する
アカウントレコードと計算フィルターの準備ができたら、以下の手順を実行します。
- セグメントビルダーに移動します。
- アカウント条件用に事前設定した計算フィルターを追加します。
- 必要に応じて、追加のユーザー属性フィルターを追加します。
- セグメントを保存します。
例:
- 計算フィルター: アカウントの
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概要を参照してください。
よくある質問
アカウントにカスタムフィールドを追加できますか？
はい。ワークスペースでカスタムアカウントフィールドを定義し、管理できます。フィールドの要件については、アカウントデータモデルを参照してください。
Accountsは有料アドオンですか？
いいえ。Accountsは有料アドオンではなく、すべてのプランで利用できます。早期アクセス期間中は、Brazeアカウントチームがワークスペースで有効にする必要があります。