カスタム属性
このページでは、ユーザー固有の特性のコレクションであるカスタム属性について説明します。カスタム属性は、ユーザーに関する属性や、アプリケーション内の価値の低いアクションに関する情報を格納するのに最適です。
Braze に保存すると、カスタム属性を使用してオーディエンスセグメントを構築し、Liquid を使用してメッセージングをパーソナライズできます。カスタムイベントとは異なり、カスタム属性の時系列情報は保存されないため、時系列情報に基づくグラフを取得できない点に注意してください。
ユースケース
一般的なカスタム属性のユースケースには、以下のようなものがあります。
- ロイヤルティティア、サブスクリプションステータス、希望言語、プランタイプなどの特性に基づいてユーザーをセグメント化し、オーディエンスのターゲティングや抑制を行う
- ユーザーの名、報酬ポイント、お気に入りカテゴリなどの属性を参照して、Liquidでメッセージをパーソナライズする
- オンボーディングステージ、アカウントステータス、トライアル終了日など、ライフサイクルステージやユーザーの状態をトラッキングする
- 数値属性で価値の低いアクションをカウントする（例：ユーザーが機能を閲覧するたびに
feature_views_count属性をインクリメントする） - 時間属性を使用して、価値の低いアクションが最後に発生した日時を記録する（例：
last_support_ticket_atやlast_password_reset_at） - お気に入りのジャンルや最近閲覧したコンテンツなど、ユーザーの興味や履歴を配列として保存し、興味ベースのターゲティングに活用する
- 構造化された設定や複数の保存済み住所など、より豊富なプロファイルデータをオブジェクトやオブジェクトの配列として保存する
- 属性トリガーを使用して、属性値が変更されたときにアクションベースのメッセージをトリガーする（例：ユーザーの
rewards_tierが変更されたときにティアアップ通知を送信する）
カスタム属性の管理
ダッシュボードでカスタム属性の作成および管理を行うには、データ設定 > カスタム属性 に移動します。
「最終更新日」の列には、カスタム属性が最後に編集された時間（ブロックリストやアクティブに設定された時間など）が表示されます。
メッセージのターゲットを正しく設定するには、カスタム属性のデータタイプが実際のカスタム属性と一致していることを確認してください。
例えば、newsletter_subscribedが文字列として定義されている場合、Liquid構文は次のようになります：{% if {{custom_attribute.${newsletter_subscribed}}} == 'true' %}。newsletter_subscribedがブール値として定義されている場合、Liquid構文には単一引用符を使用しません：{% if {{custom_attribute.${newsletter_subscribed}}} == true %}。
このページから、既存のカスタム属性の表示、管理、作成、またはブロックリストへの追加ができます。カスタム属性の横にあるメニューから、以下のアクションを選択します。
ブロックリスト
カスタム属性は、アクションメニューで個別にブロックリストに追加することも、最大100個の属性を選択して一括でブロックリストに追加することもできます。
カスタム属性をブロックすると：
- その属性に関するデータは今後収集されなくなります。
- その属性のブロックが解除されない限り、既存のデータは利用できなくなります。
- その属性はフィルターやグラフに表示されなくなります。
さらに、ブロックされたカスタム属性が Braze の他の領域でフィルターやトリガーによって現在参照されている場合、警告モーダルが表示され、それを参照しているフィルターやトリガーのすべてのインスタンスが削除およびアーカイブされることが説明されます。
カスタムデータのブロックリストへの追加と削除の詳細については、カスタムデータのブロックリストを参照してください。
個人を特定できる情報（PII）としてマークする
管理者は、このページからカスタム属性を作成し、PIIとしてマークすることもできます。これらの属性は、管理者と「View Custom Attributes Marked as PII」権限を持つダッシュボードユーザーにのみ表示されます。
説明を追加する
Manage Events, Attributes, Purchasesのユーザー権限を持っている場合、カスタム属性の作成後に説明を追加できます。カスタム属性の説明を編集を選択し、チームへのメモなど、任意の内容を入力します。
タグを追加する
「Manage Events, Attributes, Purchases」のユーザー権限を持っている場合、カスタム属性の作成後にタグを追加できます。タグは属性リストのフィルタリングに使用できます。
カスタム属性を削除する
ユーザープロファイルからカスタム属性を削除するには、2つの方法があります。
- ユーザーの更新ステップで、削除するカスタム属性名を選択します。
- APIリクエストで
/users/trackエンドポイントにnull値を設定します。
データをエクスポートする
カスタム属性のリストをCSVファイルとしてエクスポートするには、ページ上部のすべてエクスポートを選択します。CSVファイルが生成され、ダウンロードリンクがメールで送信されます。
カスタム属性のタイプを変更する
前提条件
カスタム属性が、アクティブなCampaign、Canvas、またはSegmentで現在使用されていないことが必要です。属性がまだ参照されている状態でデータタイプを変更しようとすると、ダッシュボードにエラーが表示され、変更がブロックされます。
データタイプの変更
- Segmentやフィルターでその属性を使用しているアクティブなCampaignまたはCanvasを停止します。
- すべてのSegment、Campaign、Canvasのフィルターからその属性を削除します。
- データ設定 > カスタム属性（またはカスタムイベント）に移動し、属性を見つけて、目的のデータタイプに更新します。
- 既存のユーザープロファイルの属性値を新しいデータタイプに合わせて更新します（例：
/users/trackエンドポイントを使用）。 - 関連するSegment、Campaign、Canvasに属性を再適用し、停止したCampaignやCanvasを再開します。
注意事項
- ユーザーデータは遡って更新されません。ユーザープロファイルに古いデータタイプの属性があった場合、その値は変更されません。セグメンテーションフィルターは新しいデータタイプを検索するため、古い値を持つユーザーはプロファイルが更新されるまで、一致するSegmentsから除外されます。
- 新しいデータは新しいデータタイプと一致する必要があります。変更後、この属性に対して以前のデータタイプを送信するAPI呼び出しやSDKイベントは受け付けられません。新しいデータタイプに一致する値のみが取り込まれます。
- フィルターは自動的に更新されません。変更された属性を参照しているSegmentやCampaignのフィルターは遡って更新されません。変更後にフィルターを削除して再追加する必要があります。
使用状況レポートを表示する
使用状況レポートには、特定のカスタム属性を使用しているすべてのCanvas、Campaign、Segmentが一覧表示されます。このリストにはLiquidの使用は含まれません。
対象のカスタム属性の横にあるチェックボックスを選択し、使用状況レポートを表示を選択すると、一度に最大100件の使用状況レポートを表示できます。
値タブ
使用状況レポートを表示する際に、値タブを選択すると、約250,000人のユーザーのサンプルに基づいて、選択したカスタム属性の上位の値を確認できます。結果はユーザーのサブセットからサンプリングされるため、サンプルにはすべての既存の値が含まれるわけではありません。そのため、値タブはトラブルシューティングや、すべてのユーザーのデータを組み込む必要があるユースケースには使用しないでください。
カスタム属性を設定する
以下は、さまざまなプラットフォームでカスタム属性を設定するために使用される方法の一覧です。
プラットフォーム別のドキュメントを展開
カスタム属性のストレージ
ユーザープロファイルに保存されるすべてのデータ（カスタム属性データを含む）は、各プロファイルがアクティブである限り、無期限に保持されます。
カスタム属性として保存できるすべてのデータタイプ（ブール値、数値、文字列、配列、時間、オブジェクト、オブジェクトの配列）の完全なリファレンスについては、カスタム属性のデータタイプを参照してください。