カスタム属性

カスタム属性とは、ユーザー固有の特徴の集合です。カスタム属性は、ユーザーに関する属性や、アプリケーション内の価値の低いアクションに関する情報を格納するために最適です。

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

カスタム属性の管理

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

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

ブロックリスト

カスタム属性は、アクションメニューから個別に禁止リストに追加できるほか、最大 10 個の属性を選択して一括で追加できます。カスタム属性をブロックすると、その属性に関するデータは収集されず、既存のデータは再アクティブ化しない限り利用できなくなります。また、禁止リストに追加された属性はフィルターやグラフに表示されません。さらに、属性が現在 Braze ダッシュボードの他の領域のフィルターまたはトリガーによって参照されている場合、「それを参照するフィルターまたはトリガーのすべてのインスタンスが削除され、アーカイブされる」という内容の警告モーダルが表示されます。

PIIとしてマークする

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

説明を加える

Manage Events, Attributes, Purchases ユーザー権限を持っていれば、作成後にカスタム属性に説明を追加することができる。カスタム属性を編集し、チームへのメモなど好きなものを入力する。

タグを追加する

イベント、アトリビュート、購入の管理」ユーザー権限を持っていれば、作成後にカスタムアトリビュートにタグを追加できる。そのタグを使って、属性のリストをフィルターすることができる。

カスタム属性を削除する

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

• ユーザー更新ステップで削除するカスタム属性名を選択する。
• API リクエストのnull の値を/users/track エンドポイントに設定する。

利用レポートを見る

使用状況レポートは、特定のカスタム属性を使用しているすべてのキャンバス、キャンペーン、およびセグメントを一覧表示する。このリストにはリキッドの用途は含まれていない。

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

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

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

カスタム属性の設定

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

プラットフォーム別にドキュメントを拡張する

• Android と FireOS
• iOS
• Web
• React Native
• Unity
• Xamarin
• Roku

カスタム属性の保存

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

カスタム属性のデータ型

カスタム属性は、優れたターゲット設定を可能にする非常に柔軟なツールです。

カスタム属性として格納できるデータ型を以下に示します。

• ブール値
• 数値
• 文字列
• 配列
• 時刻
• オブジェクト
• オブジェクトの配列

ブール値（真/偽）{#booleans}

ブール値を持つ属性は、サブスクリプションステータスなど、ユーザーに関する単純な 2 値データを格納する場合に便利です。その属性のレコードがまだ記録されていないユーザーに加えて、変数が明示的に true または false の値に設定されているユーザーを検出できます。

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
ブール値がtrue、false、trueまたは未設定、falseまたは未設定のいずれかであるかをチェックする	IS	TRUE,FALSE,TRUE OR NOT SET, またはFALSE OR NOT SET	このフィルターがcoffee_drinker を指定した場合、ユーザーは以下の状況でこのフィルターにマッチする： このフィルターが true という値を持っている。 coffee_drinker このフィルターが false という値を持っていない。 coffee_drinker このフィルターが true or not set という値を持っている。 coffee_drinker または値なし このフィルターが false or not set そして、ユーザーは coffee_drinker または任意の値
ユーザーのプロファイルにboolean値が存在し、かつnullでないことを確認する。	空白ではない	該当なし	このフィルターがcoffee_drinker を指定し、ユーザーが属性coffee_drinker の値を持つ場合、そのユーザーはこのフィルターにマッチする。
ユーザーのプロファイルにboolean値が存在しないか、NULLであるかをチェックする。	空欄	該当なし	このフィルターがcoffee_drinkerを指定し、ユーザーが属性coffee_drinker を持たないか、coffee_drinker の値がNULLの場合、そのユーザーはこのフィルターにマッチする。

数値

数値属性には整数や浮動小数点などがあり、さまざまなユースケースがあります。数値のカスタム属性を増分すると、特定のアクションやイベントが発生した回数を、データキャップにカウントせずに保存する場合に便利です。標準数には、以下の記録など、あらゆる用途があります。

• 靴のサイズ
• ウェストサイズ
• ユーザーが特定の製品機能またはカテゴリを表示した回数

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
数値属性が正確に 数値 であるかどうかをチェックする	その通りだ。	NUMBER	このフィルターが10 を指定し、ユーザープロファイルが値10 を持つ場合、そのユーザーはこのフィルターにマッチする。
数値属性が数値と 等しくないかチェックする	イコールではない	NUMBER	このフィルターが10 を指定し、ユーザープロファイルが値10 を持たない場合、そのユーザーはこのフィルターにマッチする。
数値属性が数値 以上かどうかをチェックする	以上	NUMBER	このフィルターが10 を指定し、ユーザープロファイルが10 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチする。
数値属性が数値より 小さいかどうかをチェックする	未満	NUMBER	このフィルターが10 を指定し、ユーザープロファイルの値が10 より小さい場合、そのユーザーはこのフィルターにマッチする。
ユーザーのプロファイルにnumeric属性が存在し、nullでないことを確認する。	空白ではない	該当なし	ユーザー・プロファイルに指定された数値属性が含まれる場合、値に関係なく、そのユーザーはこのフィルタにマッチする。
numeric属性がユーザーのプロファイルに存在しないか、NULLであるかをチェックする。	空欄	該当なし	ユーザ・プロファイルに指定された数値属性が含まれていないか、属性の値がNULLの場合、そのユーザはこのフィルタにマッチする。

数値属性の詳細

• 「正確に 0」と「未満」のフィルターは NULL フィールドを持つユーザーを含みます。
  • カスタム属性の値を持たないユーザーを除外するには、[空白でない] フィルターを含める必要があります。

文字列 (英数字)

文字列属性は、お気に入りのブランド、電話番号、アプリケーション内での最後の検索文字列など、ユーザー入力の保存に役立ちます。文字列属性の長さは最大 255 文字です。

単語の間、前後、または後にスペースを含む値を入力すると、Braze はそのスペースもチェックすることに注意してください。

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
文字列属性が入力された文字列と完全に一致するかどうかをチェックする	イコール	ストリング 大文字と小文字を区別する	このフィルターがbook を指定し、ユーザープロファイルがlast_item_purchased の文字列属性にbook を含む場合、そのユーザーはこのフィルターにマッチする。
文字列属性が入力された文字列に部分的にマッチするかどうかをチェックするOR正規表現	マッチ REGEX	文字列 OR 正規表現 大文字と小文字は区別されない。
文字列属性が入力された文字列と部分的に一致しないか OR正規表現でチェックする	正規表現にマッチしない	文字列 OR 正規表現 大文字と小文字は区別されない。
文字列属性が入力された文字列と一致しないかチェックする	イコールではない	ストリング 大文字と小文字を区別しない	このフィルターがbook を指定し、ユーザープロファイルがbook を含まないlast_item_purchased の文字列属性を持つ場合、そのユーザーはこのフィルターにマッチする。
ユーザーのプロファイルにstring属性が存在し、かつ空文字列でないかチェックする。	空白ではない	該当なし	このフィルターがfavorite_genre を指定し、ユーザープロファイルが属性favorite_genre を持つ場合、そのユーザーは属性値に関係なくこのフィルターにマッチする。例えば、ユーザーはsci-fi 、romance 、または別の値を持つことができる。
ユーザーのプロファイルに文字列属性が存在しないかチェックする	BLANK	該当なし	このフィルターがfavorite_genre を指定し、ユーザープロファイルが属性favorite_genre を持たない場合、そのユーザーはこのフィルターにマッチする。
入力された文字列のいずれかと完全に一致するかどうかをチェックする。	のいずれかである。	ストリング 大文字と小文字を区別する。	このフィルターがbook 、bookmark 、reading light を指定し、ユーザー・プロファイルがこれらの文字列の少なくとも1つを持つ場合、そのユーザーはこのフィルターにマッチする。
文字列属性が、入力された文字列のいずれとも完全に一致しないかどうかをチェックする	のどれでもない。	ストリング 大文字と小文字を区別する。	このフィルターがbook 、bookmark 、reading light を指定し、ユーザー・プロファイルにこれらの文字列が含まれていない場合、そのユーザーはフィルターにマッチする。
文字列属性が、入力された文字列のいずれかと部分的に一致するかどうかをチェックする	のいずれかを含む。	ストリング 大文字と小文字を区別する。	このフィルターがgold を指定し、ユーザープロファイルがgold_tier やformer_gold_tier などの文字列の中にgold を含む場合、そのユーザーはフィルターにマッチする。
文字列属性が、入力された文字列のいずれとも部分的に一致しないかどうかをチェックする	を含んでいない。	ストリング 大文字と小文字を区別する。	このフィルターがgold を指定し、ユーザープロファイルがどの文字列にもgold を含まない場合、そのユーザーはこのフィルターにマッチする。

配列

配列属性は、ユーザーに関する情報の関連リストの保存に適しています。例えば、ユーザーが視聴した最後のコンテンツ 100 個を配列内に保存すると、特定の関心に基づくセグメンテーションができます。

属性の配列の最大長は、デフォルトで 25 に設定されており、個々の配列について 100 に増やすことができます。例えば、「視聴した映画」のような属性を渡していて、配列長が 100 に設定されている場合、ユーザーが 101 本目の映画を視聴すると、配列から最初の映画が削除され、最新の映画が追加されます。

この最大値を増やしたい場合は、カスタマーサクセスマネージャーにお問い合わせください。ダッシュボード管理者は、[設定の管理] ページの [カスタム属性] タブから、個々の配列の最大長を 100 より大きくすることができます。

単語の間、前後、または後にスペースを含む値を入力すると、Braze はそのスペースもチェックすることに注意してください。

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
配列属性が入力された値と完全に一致する値を含むかどうかを確認します	バリューを含む	ストリング	このフィルターがsci-fi を指定し、ユーザープロファイルが値sci-fi を持つ場合、そのユーザーはこのフィルターにマッチする。
配列の属性が入力された値と完全に一致する値を含まないかどうかを確認します	価値を含まない	ストリング	このフィルターがsci-fi を指定し、ユーザープロファイルが値sci-fi を持たない場合、そのユーザーはこのフィルターにマッチする。
	配列属性が、入力された値のいずれかに部分一致する値を含むかをチェックする	[値がいずれかを含む]	文字列	マッチ REGEX	文字列 OR 正規表現 最大32,764文字
配列属性に値があるか、空でないかをチェックする	価値がある	該当なし	このフィルターがfavorite_genres を指定し、ユーザープロファイルがfavorite_genres を任意の値で含む場合、ユーザーはこのフィルターにマッチする。
配列属性が空であるか、存在しないかをチェックする	空である	該当なし	このフィルターがfavorite_genres を指定し、ユーザープロファイルがfavorite_genres を含まないか、favorite_genres を含むが値がない場合、そのユーザーはこのフィルターにマッチする。
配列属性に、入力された値のいずれかと完全に一致する値が含まれているかどうかをチェックする	のいずれかを含む。	ストリング 大文字と小文字を区別する。	このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがsci-fi 、fantasy 、romance のいずれかの組み合わせを持っている場合、そのうちの1つだけを含む（たとえばsci-fi ）。ユーザーは、sci-fi 、fantasy 、romance のいずれかを持っていれば、horror または別の値を文字列に持つことができる。
配列属性に、入力された値のいずれとも完全に一致する値が含まれていないかどうかをチェックする	にはいずれも含まれていない。	ストリング 大文字と小文字を区別する。	このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがsci-fi 、fantasy 、romance のどの組み合わせも持っていない場合、そのユーザーはこのフィルターにマッチする。sci-fi 、fantasy 、romance のいずれかを持っていない場合、ユーザーはhorror または別の値を持つことができる。
配列属性に、入力された値のいずれかと部分的に一致する値が含まれているかどうかをチェックする	のいずれかを含む。	ストリング 大文字と小文字を区別する。	このフィルターがgold を指定し、ユーザープロファイル配列が少なくとも1つの文字列にgold を含む場合、ユーザーはこのフィルターにマッチする。これには、gold_tier 、former_gold_tier などの文字列値が含まれる。
配列属性に、入力された値のいずれとも部分的に一致する値が含まれていないかどうかをチェックする	のいずれかを含まない。	ストリング 大文字と小文字を区別する。	このフィルターがgold を指定し、ユーザープロファイル配列がどの文字列にもgold を含まない場合、そのユーザーはこのフィルターにマッチする。つまり、gold_tier やformer_gold_tier のような文字列値を持つユーザーは、このフィルターにマッチしないということだ。
配列属性が入力された値をすべて含むかどうかをチェックする	のすべてである。	ストリング 大文字と小文字を区別する。	このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがそれらの値をすべて持っている場合、ユーザーはこのフィルターにマッチする。ユーザーは、horror 、あるいは他の値を持ち、このフィルターにマッチすることもできる。
配列属性が入力された値をすべて含んでいないかチェックする	のすべてではない	ストリング 大文字と小文字を区別する。	このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがそれらの値をすべて持っていない場合、そのユーザーはこのフィルターにマッチする。

時刻

時刻属性は、特定のアクションが最後に実行された時刻の保存に役立ちます。そのため、コンテンツ固有の再エンゲージメントメッセージをユーザーに提供できます。

相対日付 (1 日超前、2 日未満など) を使用した時刻フィルターでは、1 日を 24 時間として扱います。これらのフィルターを使用して実行するキャンペーンには、24 時間範囲のすべてのユーザーが含まれます。例えば、last used app more than 1 day ago はキャンペーンが実行される正確な時刻から「アプリの最終使用が 24 時間超前」のすべてのユーザーを取得します。より長い日付範囲が設定されているキャンペーンも同様です。つまり、「アクティブ化から 5 日間」は、以前の 120 時間を意味します。

例えば、24 ～ 48 時間後に含まれる時刻属性を持つユーザーを対象にするセグメントを構成するには、フィルター in more than 1 day in the future と in less than 2 days in the future を適用します。

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
時間属性が選択された日付より 前かどうかをチェックする	ビフォア	カレンダー日付セレクタ	このフィルターが2024-01-31 を指定し、ユーザー・プロフィールの日付が2024-1-31 より前の場合、そのユーザーはこのフィルターにマッチする。
時間属性が選択された日付より 後にあるかどうかをチェックする。	AFTER	カレンダー日付セレクタ	このフィルターが2024-01-31 を指定し、ユーザー・プロフィールの日付が2024-1-31 より後の場合、そのユーザーはこのフィルターにマッチする。
時間属性がX 日以上前かどうかをチェックする	以上	日前	このフィルターが7 、ユーザープロファイルの日付が7日以上前である場合、そのユーザーはこのフィルターにマッチする。
時間属性がX 日前 以下かどうかをチェックする	未満	日前	このフィルターが7 、ユーザー・プロフィールの日付が7日未満である場合、そのユーザーはこのフィルターにマッチする。
時間属性がX 日 以上 先かどうかをチェックする。	より多く	将来日数	このフィルターが7 、ユーザー・プロフィールの日付が7日以上先である場合、そのユーザーはこのフィルターにマッチする。
時間属性がX 日 以上 先かどうかをチェックする。	未満で	将来日数	このフィルターが7 を指定し、ユーザー・プロフィールの日付が7日未満先のものである場合、そのユーザーはこのフィルターにマッチする。
ユーザーのプロファイルにtime属性が存在し、かつnullでないことを確認する。	空白ではない	該当なし	このフィルターがユーザープロファイルにある時間属性を指定した場合、そのユーザーはこのフィルターにマッチする。
ユーザーのプロファイルにtime属性が存在しないか、NULLであるかをチェックする。	空欄	該当なし	このフィルターがユーザープロファイルにない時間属性を指定した場合、そのユーザーはこのフィルターにマッチする。

時間属性の詳細

• 定期的なイベントの日
  • [定期的なイベントの日] フィルターを使用し、その後に [定期的なイベントのカレンダー日] を選択するように求められたときに、IS LESS THAN または IS MORE THAN を選択すると、現在の日付がそのセグメンテーションフィルターでカウントされます。
  • 例えば、2020 年 3 月 10 日に選択した属性の日付が LESS THAN ... March 10, 2020 である場合、その属性で考慮される日付は 2020 年 3 月 10 日まで (2020 年 3 月10 日を含む) になります。
• 過去 X 日間以内:「過去 X 日間以内」フィルターには、過去 X 日から現在の日付 / 時刻までの日付が含まれます。
• 未来 X 日間以内: 現在の日付 / 時刻から未来 X 日までの日付が含まれます。

オブジェクト

階層化カスタム属性を使用して、カスタム属性のデータ型としてオブジェクトを送信できます。詳細については、「階層化カスタム属性」を参照してください。

オブジェクト配列

関連する属性をグループ化するには、オブジェクト配列を使用します。詳細については、「オブジェクト配列」の記事を参照してください。

演算子の集約

属性フィルター、カスタム属性フィルター、階層化カスタム属性フィルターで使用できる演算子のリストを整理しました。既存のフィルターでこれらの演算子を使用している場合、新しい演算子を使用するように自動的に更新されます。

データタイプ	旧オペレーター	新オペレーター	価値
string	イコール	のいずれかである。	少なくとも1つの値
string	とは等しくない。	のどれでもない。	少なくとも1つの値
配列	価値を含む	のいずれかを含む。	少なくとも1つの値
配列	価値を含まない	にはいずれも含まれていない。	少なくとも1つの値

購入と収益の追跡{#purchase-revenue-tracking}

アプリ内購入の記録に弊社の購入方法を使用すると、個々のユーザープロファイルに生涯価値 (LTV) が設定されます。このデータは、弊社の [収益] ページに表示できます。

セグメンテーション・オプション	ドロップダウン・フィルター	入力オプション	例
使用されたドルの合計がある数値より 大きいかどうかをチェックする。	より大きい	NUMBER	このフィルターが500 を指定し、ユーザープロファイルが500 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチする。
使用されたドルの合計がある数値より 小さいかどうかをチェックする。	未満	NUMBER	このフィルターが500 を指定し、ユーザープロファイルの値が500 より小さい場合、そのユーザーはこのフィルターにマッチする。
使用したドルの合計が正確に 数字 であるかどうかをチェックする。	その通りだ。	NUMBER	このフィルターが500 を指定し、ユーザープロファイルが値500 を持つ場合、そのユーザーはこのフィルターにマッチする。
最後に購入したのがX日以降かどうかをチェックする	AFTER	時間	このフィルターが2024/31/1 を指定し、ユーザーの最後の購入が2024/31/1 以降である場合、そのユーザーはこのフィルターにマッチする。
最後に購入したのがX日より前かどうかをチェックする	ビフォア	時間	このフィルターが2024/31/1 を指定し、ユーザーの最後の購入が2024/31/1 より前の場合、そのユーザーはこのフィルターに一致する。
最後に購入したのがX日以上前かどうかをチェックする	以上	時間	このフィルターが7 、ユーザーの最後の購入が今日から7日以上前である場合、そのユーザーはこのフィルターに一致する。
最後に購入したのがX日以内かチェックする	未満	時間	このフィルターが7 、ユーザーの最後の購入が今日から7日以内である場合、そのユーザーはこのフィルターに一致する。
購入がX（最大50）回以上行われたかどうかをチェックする。	以上	過去Y日間 (Y = 1,3,7,14,21,30)	このフィルターが7 回と21 日を指定し、ユーザーが過去21日間に7回以上購入した場合、ユーザーはこのフィルターに一致する。
購入回数がX回（最大50回）以下かどうかをチェックする。	未満	過去Y日間 (Y = 1,3,7,14,21,30)	このフィルターが7 回と21 日を指定し、ユーザーが過去21日間に7回未満の購入をした場合、ユーザーはこのフィルターに一致する。
購入が正確にX回（最大50回）行われたかどうかをチェックする。	その通りだ。	過去Y日間 (Y = 1,3,7,14,21,30)	このフィルターが7 回と21 日を指定し、ユーザーが過去21日間に7回購入した場合、そのユーザーはこのフィルターにマッチする。

カスタム属性のデータ型を変更できますが、データ型の変更による影響に注意する必要があります。