カスタム属性
カスタム属性とは、ユーザー固有の特徴の集合です。カスタム属性は、ユーザーに関する属性や、アプリケーション内の価値の低いアクションに関する情報を格納するために最適です。
これらの特徴を Braze に保存すると、オーディエンスセグメントの構成、および Liquid を使用したメッセージングのパーソナライゼーションに使用できます。カスタムイベントとは異なり、カスタム属性の時系列情報は保存されないので、時系列情報に基づくグラフを取得できないことに注意してください。
カスタム属性の管理
ダッシュボードでカスタム属性の作成および管理を行うには、[データ設定] > [カスタム属性] に移動します。
古いナビゲーションを使用している場合、[カスタム属性] は [設定の管理] の下にあります。
![] (/docs/ja/assets/img/export_custom_attributes.png?30524a599cf56159189ec78e0bb4b2d9 )ブーリアンである4つのカスタム属性。
最終更新日」の列には、カスタム属性が最後に編集された時間(ブロックリストやアクティブに設定された時間など)が表示される。
このページから、既存のカスタム属性の表示、管理、作成、または禁止リストへの追加ができます。カスタム属性の横にあるメニューから、以下のアクションを選択します。
ブロックリスト
カスタム属性は、アクションメニューから個別に禁止リストに追加できるほか、最大 10 個の属性を選択して一括で追加できます。カスタム属性をブロックすると、その属性に関するデータは収集されず、既存のデータは再アクティブ化しない限り利用できなくなります。また、禁止リストに追加された属性はフィルターやグラフに表示されません。さらに、属性が現在 Braze ダッシュボードの他の領域のフィルターまたはトリガーによって参照されている場合、「それを参照するフィルターまたはトリガーのすべてのインスタンスが削除され、アーカイブされる」という内容の警告モーダルが表示されます。
PIIとしてマークする
管理者は、このページからカスタム属性を作成して PII としてマークすることもできます。これらの属性は、「PII としてマークされたカスタム属性の表示」権限を持つ管理者とダッシュボードユーザーにのみ表示されます。
説明を加える
Manage Events, Attributes, Purchases
ユーザー権限がある場合、カスタム属性の作成後に説明を追加できます。カスタム属性を編集し、チームへのメモなど好きなものを入力する。
タグを追加する
「イベント、属性、購入を管理する」ユーザー権限がある場合、カスタム属性の作成後にタグを追加できます。その後、タグを使用して、属性のリストをフィルター処理できます。
この機能は現在早期アクセス段階です。この早期アクセスへ参加することに興味がある場合は、カスタマーサクセスマネージャーにお問い合わせください。
カスタム属性を削除する
ユーザープロファイルからカスタム属性を削除する方法には、次の 2 つがあります。
- ユーザー更新ステップで、削除するカスタム属性名を選択する。
- API リクエスト内で
null
値を/users/track
エンドポイントに設定する。
利用レポートを見る
使用状況レポートは、特定のカスタム属性を使用しているすべてのキャンバス、キャンペーン、およびセグメントを一覧表示する。このリストにはリキッドの用途は含まれていない。
各カスタム属性の横にあるチェックボックスを選択し、「使用状況レポートを表示」を選択することで、一度に最大10件の使用状況レポートを表示することができる。
データのエクスポート
カスタム属性のリストを CSV ファイルとしてエクスポートするには、ページ上部の [すべてエクスポート] を選択します。CSVファイルが生成され、ダウンロードリンクがEメールで送信される。
カスタム属性の設定
さまざまなプラットフォームで、カスタム属性の設定に使用する方法を以下に示します。
プラットフォーム別のドキュメントの拡張
カスタム属性の保存
カスタム属性データを含めて、ユーザープロファイルに保存されているデータはすべて、各プロファイルがアクティブである限り、無期限に保持されます。
カスタム属性のデータ型
カスタム属性は、優れたターゲット設定を可能にする非常に柔軟なツールです。
カスタム属性として格納できるデータ型を以下に示します。
ブール値(真/偽){#booleans}
ブール値を持つ属性は、サブスクリプションステータスなど、ユーザーに関する単純な 2 値データを格納する場合に便利です。その属性のレコードがまだ記録されていないユーザーに加えて、変数が明示的に true または false の値に設定されているユーザーを検出できます。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 |
---|---|---|---|
ブール値がtrue、false、trueまたは未設定、falseまたは未設定のいずれかであるかをチェックする | 該当する | TRUE,FALSE,TRUE OR NOT SET, またはFALSE OR NOT SET | このフィルターがcoffee_drinker を指定した場合、ユーザーは以下の状況でこのフィルターにマッチする:
|
ユーザーのプロファイルにboolean値が存在し、かつnullでないことを確認する。 | 空白でない | 該当なし | このフィルターがcoffee_drinker を指定し、ユーザーが属性coffee_drinker の値を持つ場合、そのユーザーはこのフィルターにマッチする。 |
ユーザーのプロファイルにboolean値が存在しないか、NULLであるかをチェックする。 | 空白である | 該当なし | このフィルターがcoffee_drinker を指定し、ユーザーが属性coffee_drinker を持たないか、coffee_drinker の値がNULLの場合、そのユーザーはこのフィルターにマッチする。 |
数値
数値属性には整数や浮動小数点などがあり、さまざまなユースケースがあります。数値のカスタム属性を増分すると、特定のアクションやイベントが発生した回数を、データキャップにカウントせずに保存する場合に便利です。標準数には、以下の記録など、あらゆる用途があります。
- 靴のサイズ
- ウェストサイズ
- ユーザーが特定の製品機能またはカテゴリを表示した回数
支出した金額はこの方法で記録すべきではありません。むしろ、購入方法で記録すべきです。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 |
---|---|---|---|
数値属性が正確に数値であるかどうかをチェックする | 完全一致 | 数値 | このフィルターが10 を指定し、ユーザープロファイルが値10 を持つ場合、そのユーザーはこのフィルターにマッチする。 |
数値属性が数値と 等しくないかチェックする | 等しくない | 数値 | このフィルターが10 を指定し、ユーザープロファイルが値10 を持たない場合、そのユーザーはこのフィルターにマッチする。 |
数値属性が数値 以上かどうかをチェックする | より大きい | 数値 | このフィルターが10 を指定し、ユーザープロファイルが10 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチする。 |
数値属性が数値より 小さいかどうかをチェックする | 未満 | 数値 | このフィルターが10 を指定し、ユーザープロファイルの値が10 より小さい場合、そのユーザーはこのフィルターにマッチする。 |
ユーザーのプロファイルにnumeric属性が存在し、nullでないことを確認する。 | 空白でない | 該当なし | ユーザー・プロファイルに指定された数値属性が含まれる場合、値に関係なく、そのユーザーはこのフィルタにマッチする。 |
numeric属性がユーザーのプロファイルに存在しないか、NULLであるかをチェックする。 | 空白である | 該当なし | ユーザ・プロファイルに指定された数値属性が含まれていないか、属性の値がNULLの場合、そのユーザはこのフィルタにマッチする。 |
数値属性の詳細
- 「正確に 0」と「未満」のフィルターは NULL フィールドを持つユーザーを含みます。
- カスタム属性の値を持たないユーザーを除外するには、[空白でない] フィルターを含める必要があります。
文字列 (英数字)
文字列属性は、お気に入りのブランド、電話番号、アプリケーション内での最後の検索文字列など、ユーザー入力の保存に役立ちます。文字列属性の長さは最大 255 文字です。
単語の間、前後、または後にスペースを含む値を入力すると、Braze はそのスペースもチェックすることに注意してください。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 |
---|---|---|---|
文字列属性が入力された文字列と完全に一致するかどうかをチェックする | 等しい | STRING 大文字と小文字を区別する |
このフィルターがbook を指定し、ユーザープロファイルがlast_item_purchased の文字列属性にbook を含む場合、そのユーザーはこのフィルターにマッチする。 |
文字列属性が入力された文字列に部分的にマッチするかどうかをチェックするOR正規表現 | 正規表現に一致する | 文字列 OR 正規表現 大文字と小文字は区別されない。 |
|
文字列属性が入力された文字列と部分的に一致しないか OR正規表現でチェックする | 正規表現に一致しない * | 文字列 OR 正規表現 大文字と小文字は区別されない。 |
|
文字列属性が入力された文字列と一致しないかチェックする | 等しくない | 文字列 大文字と小文字を区別しない |
このフィルターがbook を指定し、ユーザープロファイルがbook を含まないlast_item_purchased の文字列属性を持つ場合、そのユーザーはこのフィルターにマッチする。 |
ユーザーのプロファイルにstring属性が存在し、かつ空文字列でないかチェックする。 | 空白でない | 該当なし | このフィルターがfavorite_genre を指定し、ユーザープロファイルが属性favorite_genre を持つ場合、そのユーザーは属性値に関係なくこのフィルターにマッチする。例えば、ユーザーは 、、または他の値を持つことができます。 |
ユーザーのプロファイルに文字列属性が存在しないかチェックする | 空白 | 該当なし | このフィルターがfavorite_genre を指定し、ユーザープロファイルが属性favorite_genre を持たない場合、そのユーザーはこのフィルターにマッチする。 |
入力された文字列のいずれかと完全に一致するかどうかをチェックする。 | 次のいずれかである | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがbook 、bookmark 、reading light を指定し、ユーザー・プロファイルがこれらの文字列の少なくとも1つを持つ場合、そのユーザーはこのフィルターにマッチする。 |
文字列属性が、入力された文字列のいずれとも完全に一致しないかどうかをチェックする | 次のいずれでもない | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターに book 、bookmark 、および reading light が指定され、ユーザープロファイルにこれらの文字列がいずれも含まれていない場合、ユーザーはフィルターに一致する。 |
文字列属性が、入力された文字列のいずれかと部分的に一致するかどうかをチェックする | 次のいずれかを含む | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがgold を指定し、ユーザープロファイルがgold_tier やformer_gold_tier などの文字列の中にgold を含む場合、そのユーザーはフィルターにマッチする。 |
文字列属性が、入力された文字列のいずれとも部分的に一致しないかどうかをチェックする | 次のいずれも含まない | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがgold を指定し、ユーザープロファイルがどの文字列にもgold を含まない場合、そのユーザーはこのフィルターにマッチする。 |
「12-1-2021」や「12/1/2021」などの日付文字列は、日時オブジェクトに変換され、時間属性 として扱われます。
[正規表現に一致しない] フィルターを使用してセグメント化する場合、そのユーザープロファイルに、値を持つカスタム属性がすでに存在している必要があります。ターゲットがユーザーに適切に設定されていることを確認するために、「または」ロジックを使用してカスタム属性が空白であるかどうかチェックすることをお勧めします。
配列
配列属性は、ユーザーに関する情報の関連リストの保存に適しています。例えば、ユーザーが視聴した最後のコンテンツ 100 個を配列内に保存すると、特定の関心に基づくセグメンテーションができます。
属性の配列の最大長は、デフォルトで 25 に設定されており、個々の配列について 100 に増やすことができます。例えば、”Movies Watched “のようなアトリビューションを送信し、それが100に設定されている場合、ユーザーが101本目の映画を見ると、最初の映画は配列から削除され、最新の映画が追加される。
この最大値を増やしたい場合は、カスタマーサクセスマネージャーにお問い合わせください。ダッシュボード管理者は、[設定の管理] ページの [カスタム属性] タブから、個々の配列の最大長を 100 より大きくすることができます。
単語の間、前後、または後にスペースを含む値を入力すると、Braze はそのスペースもチェックすることに注意してください。
属性がデータ型を自動的に検出するように設定されている場合、最大長を増やすオプションは使用できません。データ型を配列に設定する必要があります。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 | |||
---|---|---|---|---|---|---|
配列属性に、入力された値と完全一致する値が含まれているかどうかをチェックする | 値を含む | 文字列 | このフィルターがsci-fi を指定し、ユーザープロファイルが値sci-fi を持つ場合、そのユーザーはこのフィルターにマッチする。 |
|||
配列属性に、入力された値と完全一致する値が含まれていないかどうかをチェックする | 値を含まない | 文字列 | このフィルターがsci-fi を指定し、ユーザープロファイルが値sci-fi を持たない場合、そのユーザーはこのフィルターにマッチする。 |
|||
配列属性が、入力された値のいずれかに部分一致する値を含むかをチェックする | [値がいずれかを含む] | 文字列 | 正規表現に一致する | 文字列 OR 正規表現 最大32,764文字 |
||
配列属性に値があるか、空でないかをチェックする | 値がある | 該当なし | このフィルターがfavorite_genres を指定し、ユーザープロファイルがfavorite_genres を任意の値で含む場合、ユーザーはこのフィルターにマッチする。 |
|||
配列属性が空であるか、存在しないことをチェックする | 空である | 該当なし | このフィルターに favorite_genres を指定し、ユーザープロファイルが favorite_genres を含まないか、favorite_genres を含むが値がない場合、そのユーザーはこのフィルターに一致する。 |
|||
配列属性に、入力された値と完全一致する値が含まれているかどうかをチェックする | 次のいずれかの値を含む | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターに sci-fi, fantasy, romance が指定され、ユーザープロファイルに sci-fi 、fantasy 、romance の任意の組み合わせがある場合 (sci-fi のみなど、1 つのみの場合も含む)。sci-fi 、fantasy 、romance のいずれかがある場合、文字列に horror や他の値があってもよい。 |
|||
配列属性に、入力された値と完全一致する値が含まれていないかどうかをチェックする | 次のいずれの値も含まない | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがsci-fi 、fantasy 、romance のどの組み合わせも持っていない場合、そのユーザーはこのフィルターにマッチする。sci-fi 、fantasy 、romance のいずれもない場合、horror や他の値があってもよい。 |
|||
配列属性が、入力された値のいずれかに部分一致する値を含むかどうかをチェックする | 値が次のいずれかを含む | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがgold を指定し、ユーザープロファイル配列が少なくとも1つの文字列にgold を含む場合、ユーザーはこのフィルターにマッチする。gold_tier 、former_gold_tier などの文字列値が該当します。 |
|||
配列属性に、入力された値と部分一致する値を含まないかどうかをチェックする | 値が次のいずれも含まない | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがgold を指定し、ユーザープロファイル配列がどの文字列にもgold を含まない場合、そのユーザーはこのフィルターにマッチする。つまり、gold_tier やformer_gold_tier のような文字列値を持つユーザーは、このフィルターにマッチしないということだ。 |
|||
配列属性が入力された値をすべて含むかどうかをチェックする | 次の全ての値が一致する | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 256 個)。 |
このフィルターがsci-fi, fantasy, romance を指定し、ユーザープロファイルがそれらの値をすべて持っている場合、ユーザーはこのフィルターにマッチする。ユーザーに や他の値があっても、このフィルターに一致する。 |
|||
配列属性が、入力された値のいずれかを含まないかどうかをチェックする | 次の全ての値が一致するわけではない | 文字列 大文字と小文字を区別する。複数の文字列を使用可能 (最大 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
を適用します。
カスタムイベントまたは購入イベントが最後に発生した日付は自動的に記録されます。カスタム時刻属性を使用して再度記録しないでください。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 |
---|---|---|---|
時間属性が選択された日付より 前かどうかをチェックする | 前 | カレンダー日付セレクター | このフィルターが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) が設定されます。このデータは、弊社の [収益] ページに表示できます。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション | 例 |
---|---|---|---|
使用されたドルの合計がある数値より 大きいかどうかをチェックする。 | より大きい | 数値 | このフィルターが500 を指定し、ユーザープロファイルが500 より大きい値を持つ場合、そのユーザーはこのフィルターにマッチする。 |
使用されたドルの合計がある数値より 小さいかどうかをチェックする。 | 未満 | 数値 | このフィルターが500 を指定し、ユーザープロファイルの値が500 より小さい場合、そのユーザーはこのフィルターにマッチする。 |
合計支出額が完全一致する数値であるかどうかをチェックする | 完全一致 | 数値 | このフィルターが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回購入した場合、そのユーザーはこのフィルターにマッチする。 |
特定の購入の発生回数でセグメンテーションを行う場合は、その購入を個別に増分カスタム属性として記録する必要もあります。
カスタム属性のデータ型を変更できますが、データ型の変更による影響に注意する必要があります。