Skip to content

Braze Learning コースカスタム属性

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

Brazeに保存すると、カスタム属性を使用してオーディエンスセグメントを構築し、Liquidを使用してメッセージングをパーソナライズできます。カスタムイベントとは異なり、カスタム属性の時系列情報は保存されないため、時系列情報に基づくグラフを取得できない点に注意してください。

ユースケース

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

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

カスタム属性の管理

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

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

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

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

ブロックリスト

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

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

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

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

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

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

管理者は、このページからカスタム属性を作成し、PIIとしてマークすることもできます。これらの属性は、管理者と「View Custom Attributes Marked as 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」などの国属性値の円グラフが表示されています。

カスタム属性を設定する

以下は、カスタム属性の設定に使用される各プラットフォームのメソッドの一覧です。

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

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

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

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

空文字列とnull値

カスタム属性をクリアまたは設定解除する場合、空文字列（""）を渡すかnullを渡すかによって動作が異なります。

値 動作
""（空文字列） 属性は空の値に設定され、ユーザープロファイル上に引き続き表示されます。
null 属性はユーザープロファイルから完全に削除されます。
New Stuff!