データタイプ

このページでは、カスタム属性、イベントプロパティ、カタログでサポートされているデータタイプをまとめています。各カスタムデータタイプは、サポートされるデータタイプと制約がそれぞれ若干異なります。

定義

以下の表を使用して、ユーザープロファイル属性、イベントデータ、またはカタログアイテムに使用できるデータタイプを確認してください。各タイプの使用方法と制約については、後続のセクションを参照してください。

データタイプ	定義	カスタム属性	イベントプロパティ	カタログ
ブール値	値は true または false	✅ サポート	✅ サポート	✅ サポート
数値	整数または小数	✅ サポート	✅ サポート	✅ サポート
文字列	テキスト。255文字以下	✅ サポート	✅ サポート	✅ サポート
時間	標準形式（ISO 8601）の日付と時刻	✅ サポート	✅ サポート	✅ サポート
配列	値の順序付きリスト	✅ サポート	✅ サポート	✅ サポート
オブジェクト	名前付きフィールドを持つ構造化データ（ネストされたキーと値のペア）	✅ サポート	✅ サポート	✅ サポート
オブジェクトの配列	オブジェクトのリスト	✅ サポート	❌ 非サポート	❌ 非サポート

重要な考慮事項

• 配列: カスタム属性とイベントプロパティにはサイズ制限があります。イベントプロパティの配列内では日時はサポートされていません。カタログは文字列配列のみをサポートし、最大100要素です。
• オブジェクト: Brazeでは、カスタム属性の場合は「階層化カスタム属性」、イベントプロパティの場合は「ネストされたオブジェクト」、カタログの場合は「JSONオブジェクト」として表示されます。
• 時間: イベントプロパティでは、このタイプは「Datetime」と表示されます。

カスタム属性のデータタイプ

カスタム属性は、定義の表に記載されているデータタイプをサポートしています。以下では、サポートされている各データタイプの使用方法とセグメンテーションについて説明します。

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

カスタム属性のデータタイプは変更できますが、その影響に注意する必要があります。詳細については、カスタム属性またはイベントのデータタイプの変更を参照してください。

統合された演算子

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

データタイプ	旧演算子	新演算子	値
文字列	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つ以上の値

イベントプロパティのデータタイプ

イベントをログに記録する際、追加情報（例えば、商品名や価格）をイベントプロパティとして添付できます。各プロパティには名前と値があります。イベントプロパティの値は、定義の表に記載されているデータタイプをサポートしています（時間はイベントプロパティでは「Datetime」と表示されます）。

期待される形式

プロパティ値はオブジェクトとして送信されます。キーはプロパティ名、値はプロパティ値です。プロパティ名は空でない文字列で、255文字以下、先頭にドル記号（$）を含めないでください。

イベントプロパティ固有のルール:

• 時間（Datetime）: ISO 8601 または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式を使用します。配列内ではサポートされていません。
• 配列: 配列内では日時はサポートされていません。
• ネストされたオブジェクト: ネストされたオブジェクトを参照してください。
• ペイロード: 配列またはオブジェクトの値を含むイベントプロパティオブジェクトは、最大102,400バイト（100 KiB）です。

カスタムイベントプロパティのデータタイプは変更できますが、データ収集後のデータタイプの変更の影響に注意してください。

イベントプロパティの完全な動作、予約キー、トリガーやパーソナライゼーションでの使用方法については、カスタムイベントプロパティを参照してください。

購入イベントと収益

購入および収益データは、購入イベントまたは推奨eコマースイベントを通じて記録されます。

購入イベントをログに記録すると、各ユーザープロファイルの生涯価値（LTV）が確立され、このデータは収益ページで時系列で表示できます。使用金額、最終購入日、時間枠内の購入回数などでセグメンテーションできます。

購入イベントプロパティのデータタイプ

購入イベントプロパティの値（購入の properties オブジェクト）は、定義の表に記載されているデータタイプをサポートしており、イベントプロパティと同じ構造および命名規則に従います。

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

Data type	Description
Number	Integer or float
Boolean	Value true or false
Datetime	String in ISO 8601 or yyyy-MM-dd'T'HH:mm:ss:SSSZ format. Not supported within arrays.
String	255 characters or fewer
Array	Supported; datetimes are not supported within arrays.
Object	Ingested as strings (not nested objects). For nested data, use a string value (for example, JSON serialized).

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

購入オブジェクトの完全なスキーマと例については、購入オブジェクトを参照してください。購入イベントのログ記録、セグメンテーションフィルター、および完全な詳細については、購入イベントを参照してください。

カスタム属性またはイベントのデータタイプの変更

カスタム属性またはイベントのデータタイプを変更するには:

1. データ設定に移動し、カスタム属性またはカスタムイベントを選択します。
2. リストから属性またはイベントを見つけ、 その他のアクションを選択します。
3. ドロップダウンから新しいデータタイプを選択します。
4. 保存を選択します。

カスタム属性またはイベントのデータタイプを変更する場合（例えば、time を string に変更する場合）、以下の点を考慮してください。

• フィルターは自動的に更新されません。 変更された属性またはイベントを使用しているセグメント、キャンペーン、キャンバス、またはその他の場所は更新されません。データタイプを変更する前に、セグメントやフィルターでその属性を使用しているキャンペーンやキャンバスを停止し、それを参照しているフィルターから属性を削除してください。
• 既存のユーザーデータは遡及的に更新されません。 変更前にユーザープロファイルに変更された属性があった場合、その値は古いデータタイプのままです。フィルターが新しいデータタイプを検索するため、変更された属性を含むセグメントからユーザーが外れる可能性があります。それらのユーザープロファイルを更新して（例えば、/users/track エンドポイントを使用して）、新しいタイプに一致させ、必要に応じてセグメントに再度入るようにしてください。
• 新しいデータは新しいタイプに一致する必要があります。 変更された属性に対して以前のデータタイプを送信するAPIコールは受け付けられません。新しいデータタイプを送信してください。

カタログのデータタイプ

カタログは、定義の表に記載されているタイプをサポートしています。以下の表は、各タイプ、作成または更新の方法、形式と例を示しています。

データタイプ	説明	CSVアップロードで利用可能	APIおよびCDIで利用可能
文字列	文字のシーケンス（例: 名前、説明、ID）。	✅ はい	✅ はい
数値	整数または浮動小数点の数値（例: 価格、数量、評価）。	✅ はい	✅ はい
ブール値	true または false の値。	✅ はい	✅ はい
時間	ISO 8601 形式の日付と時刻、またはUnixタイムスタンプ（秒）。	✅ はい	✅ はい
JSONオブジェクト（オブジェクト）	キーと値のペアを持つネストされたオブジェクト。プラットフォームに表示されますが、APIまたはCDIを通じてのみ作成または更新できます。	❌ いいえ	✅ はい
文字列配列（配列）	文字列のリスト。プラットフォームに表示されますが、APIまたはCDIを通じてのみ作成または更新できます。最大100要素。	❌ いいえ	✅ はい

形式と例

データタイプ	形式	例
文字列	テキスト	"Hello World"
時間	ISO 8601またはUnixタイムスタンプ（秒）	"2024-03-15T14:30:00Z"
ブール値	true または false	true
数値	整数または小数	42 または 19.99
オブジェクト	JSONオブジェクト	{"key": "value", "price": 10}
配列	文字列の配列	["red", "blue", "green"]

カタログの作成と更新については、カタログの作成を参照してください。