カスタム属性
このページでは、ユーザー固有の特性のコレクションであるカスタム属性について説明します。カスタム属性は、ユーザーに関する属性や、アプリケーション内の価値の低いアクションに関する情報を格納するのに最適です。
Braze に保存すると、カスタム属性を使用してオーディエンスセグメントを構築し、Liquid を使用してメッセージングをパーソナライズできます。カスタムイベントとは異なり、カスタム属性の時系列情報は保存されないため、時系列情報に基づくグラフを取得できない点に注意してください。
カスタム属性の管理
ダッシュボードでカスタム属性の作成および管理を行うには、[データ設定] > [カスタム属性] に移動します。

「最終更新日」の列には、カスタム属性が最後に編集された時間(ブロックリストやアクティブに設定された時間など)が表示されます。
メッセージのターゲットを正しく設定するには、カスタム属性のデータタイプが実際のカスタム属性と一致していることを確認してください。
例えば、newsletter_subscribed が文字列として定義されている場合、Liquid 構文は次のようになります:{% if {{custom_attribute.${newsletter_subscribed}}} == 'true' %}。newsletter_subscribed がブール値として定義されている場合、Liquid 構文には単一引用符を使用しません:{% if {{custom_attribute.${newsletter_subscribed}}} == true %}。
このページから、既存のカスタム属性の表示、管理、作成、またはブロックリストへの追加ができます。カスタム属性の横にあるメニューから、以下のアクションを選択します。
ブロックリスト
カスタム属性は、アクションメニューで個別にブロックリストに追加することも、最大100個の属性を選択して一括でブロックリストに追加することもできます。カスタム属性をブロックすると、その属性に関するデータは収集されず、既存のデータは再アクティブ化しない限り利用できなくなります。また、ブロックリストに追加された属性はフィルターやグラフに表示されません。さらに、この属性が現在、Braze ダッシュボードの他の領域のフィルターまたはトリガーによって参照されている場合、その属性を参照するフィルターまたはトリガーのすべてのインスタンスが削除され、アーカイブされることを示す警告モーダルが表示されます。
個人識別情報(PII)としてのマーキング
管理者は、カスタム属性を作成し、このページから PII としてマークすることもできます。これらの属性は、「PII としてマークされたカスタム属性の表示」権限を持つ管理者とダッシュボードユーザーにのみ表示されます。
説明を追加する
Manage Events, Attributes, Purchases ユーザー権限がある場合、カスタム属性の作成後に説明を追加できます。カスタム属性を編集し、チームへのメモなど任意の内容を入力します。
タグを追加する
「Manage Events, Attributes, Purchases」ユーザー権限がある場合、カスタム属性の作成後にタグを追加できます。その後、タグを使用して属性のリストをフィルタリングできます。
カスタム属性を削除する
ユーザープロファイルからカスタム属性を削除する方法は2つあります。
- ユーザー更新ステップで、削除するカスタム属性名を選択する。
- API リクエストで
null値を/users/trackエンドポイントに設定する。
データのエクスポート
カスタム属性のリストを CSV ファイルとしてエクスポートするには、ページ上部の [すべてエクスポート] を選択します。CSV ファイルが生成され、ダウンロードリンクがメールで送信されます。
利用レポートの表示
利用レポートは、特定のカスタム属性を使用しているすべてのキャンバス、キャンペーン、およびセグメントを一覧表示します。このリストには、Liquid の使用状況は含まれていません。
各カスタム属性の横にあるチェックボックスを選択し、[利用レポートを表示] を選択すると、一度に最大100件の利用レポートを表示できます。
値タブ
利用レポートを表示しているときに、[値] タブを選択すると、選択したカスタム属性の上位値が、約250,000ユーザーのサンプルに基づいて表示されます。結果はユーザーのサブセットからサンプリングされるため、サンプルに既存のすべての値が含まれるわけではありません。つまり、[値] タブは、トラブルシューティングや、すべてのユーザーのデータを組み込む必要があるユースケースには使用しないでください。

カスタム属性の設定
さまざまなプラットフォームでカスタム属性の設定に使用する方法を以下に示します。
プラットフォーム別のドキュメントを展開
カスタム属性の保存
カスタム属性データを含め、ユーザープロファイルに保存されているすべてのデータは、各プロファイルがアクティブである限り、無期限に保持されます。
カスタム属性のデータタイプ
カスタム属性は、優れたターゲティングを可能にする非常に柔軟なツールです。
カスタム属性として格納できるデータタイプを以下に示します。
ブール値(真/偽){#booleans}
ブール値属性は、サブスクリプションステータスなど、ユーザーに関する単純な2値データを格納する場合に便利です。変数が明示的に true または false の値に設定されているユーザーに加えて、その属性のレコードがまだ記録されていないユーザーも検出できます。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| ブール値が true、false、true または未設定、false または未設定のいずれかであるかをチェックします | IS | TRUE、FALSE、TRUE OR NOT SET、または FALSE OR NOT SET | このフィルターが coffee_drinker を指定した場合、ユーザーは以下の状況でこのフィルターにマッチします:
|
| ユーザーのプロファイルにブール値が存在し、かつ null でないことを確認します | IS NOT BLANK | N/A | このフィルターが coffee_drinker を指定し、ユーザーが属性 coffee_drinker の値を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| ユーザーのプロファイルにブール値が存在しないか、null であるかをチェックします | IS BLANK | N/A | このフィルターが coffee_drinker を指定し、ユーザーが属性 coffee_drinker を持たないか、coffee_drinker の値が null の場合、そのユーザーはこのフィルターにマッチします。 |
数値
数値属性には整数や浮動小数点数があり、さまざまなユースケースがあります。増分型の数値カスタム属性は、特定のアクションやイベントが発生した回数を、データキャップにカウントせずに保存する場合に便利です。標準的な数値には、以下の記録など、あらゆる用途があります。
- 靴のサイズ
- ウエストサイズ
- ユーザーが特定の製品機能またはカテゴリを表示した回数
支出金額はこの方法で記録すべきではありません。代わりに、購入方法で記録してください。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| 数値属性が正確に数値であるかどうかをチェックします | EXACTLY | NUMBER | このフィルターが 10 を指定し、ユーザープロファイルが値 10 を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 数値属性が数値と等しくないかチェックします | DOES NOT EQUAL | NUMBER | このフィルターが 10 を指定し、ユーザープロファイルが値 10 を持たない場合、そのユーザーはこのフィルターにマッチします。 |
| 数値属性が数値より大きいかどうかをチェックします | MORE THAN | NUMBER | このフィルターが 10 を指定し、ユーザープロファイルが 10 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 数値属性が数値より小さいかどうかをチェックします | LESS THAN | NUMBER | このフィルターが 10 を指定し、ユーザープロファイルの値が 10 より小さい場合、そのユーザーはこのフィルターにマッチします。 |
| ユーザーのプロファイルに数値属性が存在し、null でないことを確認します | IS NOT BLANK | N/A | ユーザープロファイルに指定された数値属性が含まれる場合、値に関係なく、そのユーザーはこのフィルターにマッチします。 |
| 数値属性がユーザーのプロファイルに存在しないか、null であるかをチェックします | IS BLANK | N/A | ユーザープロファイルに指定された数値属性が含まれていないか、属性の値が null の場合、そのユーザーはこのフィルターにマッチします。 |
数値属性の詳細
- 「正確に 0」と「未満」のフィルターは NULL フィールドを持つユーザーを含みます。
- カスタム属性の値を持たないユーザーを除外するには、IS NOT BLANK フィルターを含める必要があります。
文字列(英数字){#strings}
文字列属性は、お気に入りのブランド、電話番号、アプリケーション内での最後の検索文字列など、ユーザー入力の保存に役立ちます。文字列属性の長さは最大255文字です。
単語の間、前、または後にスペースを含む値を入力すると、Braze はそのスペースもチェックする点に注意してください。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| 文字列属性が入力された文字列または正規表現と部分的にマッチするかどうかをチェックします | MATCHES REGEX | STRING OR REGULAR EXPRESSION 大文字と小文字は区別されません。最大32,764文字 |
|
| 文字列属性が入力された文字列または正規表現と部分的にマッチしないかどうかをチェックします | DOES NOT MATCH REGEX * | STRING OR REGULAR EXPRESSION 大文字と小文字は区別されません。最大32,764文字 |
|
| ユーザーのプロファイルに文字列属性が存在し、かつ空文字列でないかチェックします | IS NOT BLANK | N/A | このフィルターが favorite_genre を指定し、ユーザープロファイルが属性 favorite_genre を持つ場合、そのユーザーは属性値に関係なくこのフィルターにマッチします。例えば、ユーザーは sci-fi、romance、または他の値を持つことができます。 |
| ユーザーのプロファイルに文字列属性が存在しないかチェックします | BLANK | N/A | このフィルターが favorite_genre を指定し、ユーザープロファイルが属性 favorite_genre を持たない場合、そのユーザーはこのフィルターにマッチします。 |
| 文字列が入力された文字列のいずれかと完全に一致するかどうかをチェックします | IS ANY OF | STRING 大文字と小文字を区別します。複数の文字列を使用可能(最大256個) |
このフィルターが book、bookmark、reading light を指定し、ユーザープロファイルがこれらの文字列の少なくとも1つを持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 文字列属性が入力された文字列のいずれとも完全に一致しないかどうかをチェックします | IS NONE OF | STRING 大文字と小文字を区別します。複数の文字列を使用可能(最大256個) |
このフィルターが book、bookmark、reading light を指定し、ユーザープロファイルにこれらの文字列がいずれも含まれていない場合、そのユーザーはこのフィルターにマッチします。 |
| 文字列属性が入力された文字列のいずれかと部分的に一致するかどうかをチェックします | CONTAINS ANY OF | STRING 大文字と小文字を区別します。複数の文字列を使用可能(最大256個) |
このフィルターが gold を指定し、ユーザープロファイルが gold_tier や former_gold_tier などの文字列の中に gold を含む場合、そのユーザーはフィルターにマッチします。 |
| 文字列属性が入力された文字列のいずれとも部分的に一致しないかどうかをチェックします | DOESN’T CONTAIN ANY OF | STRING 大文字と小文字を区別します。複数の文字列を使用可能(最大256個) |
このフィルターが gold を指定し、ユーザープロファイルがどの文字列にも gold を含まない場合、そのユーザーはこのフィルターにマッチします。 |
「12-1-2021」や「12/1/2021」などの日付文字列は、日時オブジェクトに変換され、時間属性として扱われます。
DOES NOT MATCH REGEX フィルターを使用してセグメント化する場合、そのユーザープロファイルに、値が割り当てられたカスタム属性がすでに存在している必要があります。ユーザーが適切にターゲティングされるようにするため、「OR」ロジックを使用してカスタム属性が空白であるかどうかをチェックすることをお勧めします。
配列
配列属性は、ユーザーに関する情報の関連リストの保存に適しています。例えば、ユーザーが視聴した最後のコンテンツ100個を配列内に保存すると、特定の関心に基づくセグメンテーションが可能になります。
配列の最大サイズは100 KBです。属性のデフォルトの長さは最大500項目です。例えば、「Movies Watched」のような属性を送信し、それが500に設定されている場合、ユーザーが501本目の映画を見ると、最初の映画が配列から削除され、最新の映画が追加されます。
単語の間、前、または後にスペースがある値を入力すると、Braze でも同じスペースがチェックされる点に注意してください。
属性がデータタイプを自動的に検出するように設定されている場合、最大長を増やすオプションは使用できません。データタイプを配列に設定する必要があります。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| 配列属性に、入力された値と完全一致する値が含まれているかどうかをチェックします | INCLUDES VALUE | STRING | このフィルターが sci-fi を指定し、ユーザープロファイルが値 sci-fi を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 配列属性に、入力された値と完全一致する値が含まれていないかどうかをチェックします | DOESN’T INCLUDE VALUE | STRING | このフィルターが sci-fi を指定し、ユーザープロファイルが値 sci-fi を持たない場合、そのユーザーはこのフィルターにマッチします。 |
| 配列属性に、入力された値または正規表現と部分一致する値が含まれているかを確認します | MATCHES REGEX | STRING OR REGULAR EXPRESSION 最大32,764文字 |
|
| 配列属性に値があるか、空でないかをチェックします | HAS A VALUE | N/A | このフィルターが favorite_genres を指定し、ユーザープロファイルが favorite_genres を任意の値で含む場合、そのユーザーはこのフィルターにマッチします。 |
| 配列属性が空であるか、存在しないかをチェックします | IS EMPTY | N/A | このフィルターが favorite_genres を指定し、ユーザープロファイルが favorite_genres を含まないか、favorite_genres を含むが値がない場合、そのユーザーはこのフィルターにマッチします。 |
| 配列属性に、入力された値のいずれかと完全一致する値が含まれているかどうかをチェックします | INCLUDES ANY OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが sci-fi, fantasy, romance を指定し、ユーザープロファイルに sci-fi、fantasy、romance の任意の組み合わせがある場合(sci-fi のみなど、1つのみの場合も含む)、マッチします。sci-fi、fantasy、romance のいずれかがある場合、文字列に horror や他の値があってもマッチします。 |
| 配列属性に、入力された値のいずれとも完全一致する値が含まれていないかどうかをチェックします | INCLUDES NONE OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが sci-fi, fantasy, romance を指定し、ユーザープロファイルが sci-fi、fantasy、romance のどの組み合わせも持っていない場合、そのユーザーはこのフィルターにマッチします。sci-fi、fantasy、romance のいずれもない場合、horror や他の値があってもマッチします。 |
| 配列属性が、入力された値のいずれかに部分一致する値を含むかどうかをチェックします | VALUES CONTAIN ANY OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが gold を指定し、ユーザープロファイル配列が少なくとも1つの文字列に gold を含む場合、そのユーザーはこのフィルターにマッチします。gold_tier、former_gold_tier などの文字列値が該当します。 |
| 配列属性に、入力された値のいずれとも部分一致する値が含まれていないかどうかをチェックします | VALUES DON’T CONTAIN ANY OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが gold を指定し、ユーザープロファイル配列がどの文字列にも gold を含まない場合、そのユーザーはこのフィルターにマッチします。つまり、gold_tier や former_gold_tier のような文字列値を持つユーザーは、このフィルターにマッチしません。 |
| 配列属性が入力された値をすべて含むかどうかをチェックします | IS ALL OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが sci-fi, fantasy, romance を指定し、ユーザープロファイルがそれらの値をすべて持っている場合、そのユーザーはこのフィルターにマッチします。horror や他の値があっても、このフィルターにマッチします。 |
| 配列属性が入力された値のすべてを含まないかどうかをチェックします | ISN’T ALL OF | STRING 大文字と小文字を区別します。複数の値を使用可能(最大256個) |
このフィルターが sci-fi, fantasy, romance を指定し、ユーザープロファイルがそれらの値をすべて持っていない場合、そのユーザーはこのフィルターにマッチします。 |
正規表現(regex)の使い方については、以下のリソースをチェックしてください:
時刻
時刻属性は、特定のアクションが最後に実行された時刻の保存に役立ちます。これにより、コンテンツ固有の再エンゲージメントメッセージをユーザーに提供できます。
相対日付(例: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 を適用します。
カスタムイベントまたは購入イベントが最後に発生した日付は自動的に記録されます。カスタム時刻属性を使用して再度記録しないでください。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| 時刻属性が選択された日付より前かどうかをチェックします | BEFORE | CALENDAR DATE SELECTOR | このフィルターが 2024-01-31 を指定し、ユーザープロファイルの日付が 2024-1-31 より前の場合、そのユーザーはこのフィルターにマッチします。 |
| 時刻属性が選択された日付より後かどうかをチェックします | AFTER | CALENDAR DATE SELECTOR | このフィルターが 2024-01-31 を指定し、ユーザープロファイルの日付が 2024-1-31 より後の場合、そのユーザーはこのフィルターにマッチします。 |
| 時刻属性がX日以上前かどうかをチェックします | MORE THAN | NUMBER OF DAYS AGO | このフィルターが 7 を指定し、ユーザープロファイルの日付が7日以上前の場合、そのユーザーはこのフィルターにマッチします。 |
| 時刻属性がX日未満前かどうかを確認します | LESS THAN | NUMBER OF DAYS AGO | このフィルターが 7 を指定し、ユーザープロファイルの日付が7日未満前の場合、そのユーザーはこのフィルターにマッチします。 |
| 時刻属性がX日以上先の未来であるかどうかを確認します | IN MORE THAN | NUMBER OF DAYS IN FUTURE | このフィルターが 7 を指定し、ユーザープロファイルの日付が7日以上先の未来の場合、そのユーザーはこのフィルターにマッチします。 |
| 時刻属性がX日未満先の未来であるかどうかを確認します | IN LESS THAN | NUMBER OF DAYS IN FUTURE | このフィルターが 7 を指定し、ユーザープロファイルの日付が7日未満先の未来の場合、そのユーザーはこのフィルターにマッチします。 |
| ユーザーのプロファイルに時刻属性が存在し、かつ null でないことを確認します | IS NOT BLANK | N/A | このフィルターがユーザープロファイルにある時刻属性を指定した場合、そのユーザーはこのフィルターにマッチします。 |
| ユーザーのプロファイルに時刻属性が存在しないか、null であるかをチェックします | IS BLANK | N/A | このフィルターがユーザープロファイルにない時刻属性を指定した場合、そのユーザーはこのフィルターにマッチします。 |
時刻属性の詳細
- 定期的なイベントの日
- 「定期的なイベントの日」フィルターを使用し、「定期的なイベントのカレンダー日」を選択するよう求められたときに、
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 日までの日付が含まれます。
オブジェクト
階層化カスタム属性を使用して、カスタム属性のデータタイプとしてオブジェクトを送信できます。詳細については、「階層化カスタム属性」を参照してください。
オブジェクトの配列
関連する属性をグループ化するには、オブジェクトの配列を使用します。詳細については、「オブジェクトの配列」の記事を参照してください。
演算子の統合
属性フィルター、カスタム属性フィルター、階層化カスタム属性フィルターで使用できる演算子のリストを統合しました。既存のフィルターでこれらの演算子を使用している場合、新しい演算子を使用するように自動的に更新されます。
| データタイプ | 旧演算子 | 新演算子 | 値 |
|---|---|---|---|
| 文字列 | equals | is any of | 少なくとも1つの値 |
| 文字列 | does not equal | is none of | 少なくとも1つの値 |
| 配列 | includes value | includes any of | 少なくとも1つの値 |
| 配列 | doesn’t include value | includes none of | 少なくとも1つの値 |
購入と収益のトラッキング
アプリ内購入の記録に購入方法を使用すると、個々のユーザープロファイルに生涯価値(LTV)が設定されます。このデータは、収益ページに時系列で表示できます。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション | 例 |
|---|---|---|---|
| 合計支出額がある数値より大きいかどうかをチェックします | GREATER THAN | NUMBER | このフィルターが 500 を指定し、ユーザープロファイルが 500 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 合計支出額がある数値より小さいかどうかをチェックします | LESS THAN | NUMBER | このフィルターが 500 を指定し、ユーザープロファイルの値が 500 より小さい場合、そのユーザーはこのフィルターにマッチします。 |
| 合計支出額が正確に数値であるかどうかをチェックします | EXACTLY | NUMBER | このフィルターが 500 を指定し、ユーザープロファイルが値 500 を持つ場合、そのユーザーはこのフィルターにマッチします。 |
| 最後に購入したのが X 日以降かどうかをチェックします | AFTER | TIME | このフィルターが 2024/31/1 を指定し、ユーザーの最後の購入が 2024/31/1 以降である場合、そのユーザーはこのフィルターにマッチします。 |
| 最後に購入したのが X 日より前かどうかをチェックします | BEFORE | TIME | このフィルターが 2024/31/1 を指定し、ユーザーの最後の購入が 2024/31/1 より前の場合、そのユーザーはこのフィルターにマッチします。 |
| 最後に購入したのが X 日以上前かどうかをチェックします | MORE THAN | TIME | このフィルターが 7 を指定し、ユーザーの最終購入日が今日から7日以上前の場合、そのユーザーはこのフィルターにマッチします。 |
| 最後に購入したのが X 日以内かチェックします | LESS THAN | TIME | このフィルターが 7 を指定し、ユーザーの最終購入日が今日から7日以内の場合、そのユーザーはこのフィルターにマッチします。 |
| 購入が X(最大50)回以上行われたかどうかをチェックします | MORE THAN | 過去 Y 日間(Y = 1,3,7,14,21,30) | このフィルターが 7 回と 21 日を指定し、ユーザーが過去21日間に7回以上購入した場合、そのユーザーはこのフィルターにマッチします。 |
| 購入回数が X 回(最大50回)未満かどうかをチェックします | LESS THAN | 過去 Y 日間(Y = 1,3,7,14,21,30) | このフィルターが 7 回と 21 日を指定し、ユーザーが過去21日間に7回未満の購入をした場合、そのユーザーはこのフィルターにマッチします。 |
| 購入が正確に X 回(最大50回)行われたかどうかをチェックします | EXACTLY | 過去 Y 日間(Y = 1,3,7,14,21,30) | このフィルターが 7 回と 21 日を指定し、ユーザーが過去21日間に7回購入した場合、そのユーザーはこのフィルターにマッチします。 |
特定の購入の発生回数でセグメンテーションを行う場合は、その購入を個別に増分カスタム属性として記録する必要もあります。
カスタム属性のデータタイプを変更できますが、データタイプの変更による影響に注意する必要があります。
GitHub でこのページを編集