Skip to content

Brazeラーニングコースカスタム属性

このページでは、カスタム属性について説明します。カスタム属性は、ユーザー固有の特性をまとめたものです。カスタム属性は、ユーザーに関する属性や、アプリケーション内の低価値アクションに関する情報を保存するのに最適です。

Brazeに保存されたカスタム属性は、オーディエンスセグメントの構築やLiquidを使用したメッセージのパーソナライズに使用できます。Brazeはカスタム属性の時系列情報を保存しないため、カスタムイベントのようにグラフを作成することはできません。

ユースケース

一般的なカスタム属性のユースケースには、以下のようなものがあります。

  • ロイヤルティティア、サブスクリプションステータス、希望言語、プランタイプなどの特性に基づいてユーザーをセグメント化し、オーディエンスのターゲティングや抑制を行う
  • ユーザーの名、報酬ポイント、お気に入りカテゴリなどの属性を参照して、Liquidでメッセージをパーソナライズする
  • オンボーディングステージ、アカウントステータス、トライアル終了日など、ライフサイクルステージやユーザーの状態を追跡する
  • 数値属性で低価値アクションをカウントする（例：ユーザーが機能を閲覧するたびにfeature_views_count属性をインクリメントする）
  • 時間属性を使用して、低価値アクションが最後に発生した日時を記録する（例：last_support_ticket_atやlast_password_reset_at）
  • お気に入りのジャンルや最近閲覧したコンテンツなど、ユーザーの興味や履歴を配列として保存し、興味ベースのターゲティングに活用する
  • 構造化された設定や複数の保存済み住所など、より豊富なプロファイルデータをオブジェクトやオブジェクトの配列として保存する
  • 属性トリガーを使用して、属性値が変更されたときにアクションベースのメッセージをトリガーする（例：ユーザーのrewards_tierが変更されたときにティアアップ通知を送信する）

カスタム属性の管理

ダッシュボードでカスタム属性を作成・管理するには、データ設定 > カスタム属性に移動します。

ブール値の4つのカスタム属性。

最終更新日列には、カスタム属性が最後に編集された日時（ブロックリストへの追加やアクティブへの変更など）が表示されます。

このページから、既存のカスタム属性の表示、管理、作成、またはブロックリストへの追加ができます。カスタム属性の横にあるメニューを選択すると、以下のアクションを実行できます。

ブロックリスト

アクションメニューから個別のカスタム属性をブロックリストに追加したり、最大100個の属性を選択して一括でブロックリストに追加したりできます。

カスタム属性をブロックすると：

  • その属性の今後のデータは収集されなくなります。
  • その属性のブロックが解除されない限り、既存のデータは利用できなくなります。
  • その属性はフィルターやグラフに表示されなくなります。

さらに、ブロックされたカスタム属性がBrazeの他の領域でフィルターやトリガーによって現在参照されている場合、警告モーダルが表示され、それを参照しているフィルターやトリガーのすべてのインスタンスが削除およびアーカイブされることが説明されます。

カスタムデータのブロックリストへの追加と削除の詳細については、カスタムデータのブロックリストを参照してください。

個人を特定できる情報（PII）としてマークする

管理者は、このページからカスタム属性を作成し、PIIとしてマークすることもできます。これらの属性は、管理者と「PIIとしてマークされたカスタム属性を表示」権限を持つダッシュボードユーザーにのみ表示されます。

説明を追加する

Manage Events, Attributes, Purchasesのユーザー権限を持っている場合、カスタム属性の作成後に説明を追加できます。カスタム属性の説明を編集を選択し、チームへのメモなど、任意の内容を入力します。

タグを追加する

「Manage Events, Attributes, Purchases」のユーザー権限を持っている場合、カスタム属性の作成後にタグを追加できます。タグは属性リストのフィルタリングに使用できます。

カスタム属性を削除する

ユーザープロファイルからカスタム属性を削除するには、2つの方法があります。

データをエクスポートする

カスタム属性のリストをCSVファイルとしてエクスポートするには、ページ上部のすべてエクスポートを選択します。CSVファイルが生成され、ダウンロードリンクがメールで送信されます。

カスタム属性のタイプを変更する

前提条件

カスタム属性が、アクティブなキャンペーン、キャンバス、またはセグメントで現在使用されていないことが必要です。属性がまだ参照されている状態でデータタイプを変更しようとすると、ダッシュボードにエラーが表示され、変更がブロックされます。

データタイプの変更

  1. セグメントやフィルターでその属性を使用しているアクティブなキャンペーンまたはキャンバスを停止します。
  2. すべてのセグメント、キャンペーン、キャンバスのフィルターからその属性を削除します。
  3. データ設定 > カスタム属性（またはカスタムイベント）に移動し、属性を見つけて、目的のデータタイプに更新します。
  4. 既存のユーザープロファイルの属性値を新しいデータタイプに合わせて更新します（例：/users/trackエンドポイントを使用）。
  5. 関連するセグメント、キャンペーン、キャンバスに属性を再適用し、停止したキャンペーンやキャンバスを再開します。

注意事項

  • ユーザーデータは遡って更新されません。ユーザープロファイルに古いデータタイプの属性があった場合、その値は変更されません。セグメンテーションフィルターは新しいデータタイプを検索するため、古い値を持つユーザーはプロファイルが更新されるまで、一致するセグメントから除外されます。
  • 新しいデータは新しいデータタイプと一致する必要があります。変更後、この属性に対して以前のデータタイプを送信するAPI呼び出しやSDKイベントは受け付けられません。新しいデータタイプに一致する値のみが取り込まれます。
  • フィルターは自動的に更新されません。変更された属性を参照しているセグメントやキャンペーンのフィルターは遡って更新されません。変更後にフィルターを削除して再追加する必要があります。

使用状況レポートを表示する

使用状況レポートには、特定のカスタム属性を使用しているすべてのキャンバス、キャンペーン、セグメントが一覧表示されます。このリストにはLiquidの使用は含まれません。

対象のカスタム属性の横にあるチェックボックスを選択し、使用状況レポートを表示を選択すると、一度に最大100件の使用状況レポートを表示できます。

値タブ

使用状況レポートを表示する際に、値タブを選択すると、約250,000人のユーザーのサンプルに基づいて、選択したカスタム属性の上位の値を確認できます。結果はユーザーのサブセットからサンプリングされるため、サンプルにはすべての既存の値が含まれるわけではありません。そのため、値タブはトラブルシューティングや、すべてのユーザーのデータを組み込む必要があるユースケースには使用しないでください。

選択したカスタム属性の使用状況レポート。「値」タブが開かれ、「US」や「PR」などの国属性値の円グラフが表示されています。

カスタム属性を設定する

以下は、さまざまなプラットフォームでカスタム属性を設定するために使用される方法の一覧です。

プラットフォーム別のドキュメントを展開

カスタム属性のストレージ

ユーザープロファイルに保存されるすべてのデータ（カスタム属性データを含む）は、各プロファイルがアクティブである限り、無期限に保持されます。

カスタム属性として保存できるすべてのデータタイプ（ブール値、数値、文字列、配列、時間、オブジェクト、オブジェクトの配列）の完全なリファレンスについては、カスタム属性のデータタイプを参照してください。
New Stuff!