日付属性

動作原理

First Purchase Date、Last Checkout Date、Last Visit Dateなどの重要なタイムスタンプを保存するために日付属性を使用します。

日付属性はイベント、訪問、および訪問のスコープで利用可能です。

日付フォーマッター

文字列属性を日付に変換するには、日付フォーマッターを使用します。日付形式パネルから文字列値に一致するタイムスタンプコンポーネントを選択します。例えば、01/31/2020のような文字列値はMM/dd/yyyyの形式を使用して日付に変換できます。

日付と時間の文字列パターン：

詳細については、Oracle: SimpleDateFormat Java Classを参照してください。

文字列にTが含まれている場合は、式のTの前後にシングルクォートを含めてください。たとえば、2024-08-22T10:24:58.905の文字列はyyyy-MM-dd'T'HH:mm:ss.SSSの式を使用します。クォートを省略すると、yyyy-MM-ddTHH:mm:ss.SSSのようになり、解析エラーが発生します。

文字列属性として日付値を収集する

イベント属性として文字列で日付値を収集し、それを日付訪問属性に変換するエンリッチメントを使用することがベストプラクティスです。このアプローチは、不正確な形式によって引き起こされるエラーのリスクを最小限に抑え、下流のデータベースシステムでのデータ収集および処理の中断を防ぎます。文字列としてインポートすることで、さまざまな日付形式を扱う際に柔軟性とデータの整合性が保たれます。

例

サインアップ日を文字列としてキャプチャし、日付属性をエンリッチするために、次の手順を使用します：

1. "2023-10-15"のような文字列としてSignup Dateイベント属性を作成します。
2. 日付としてSignup Date訪問属性を作成します。
3. 訪問属性に文字列を日付属性に変換するSet Date enrichmentを使用します。形式はyyyy-MM-ddです。

サイズ制限

各日付属性のサイズは次の範囲に制限されます：

• 最小：-292275055-05-16T16:47:04.192Z
• 最大：+292278994-08-17T07:12:55.807Z

これらの属性は、暗号化および圧縮後のプロファイルの最大サイズ（400 KB）によっても制限されます。

エンリッチメント

日付のキャプチャ

Capture Dateエンリッチメントは、イベント条件の時点での現在のタイムスタンプに属性を構成します。このエンリッチメントはイベント、訪問、および訪問属性で利用可能です。

たとえば、最後の購入日をキャプチャするには、購入イベントを識別するルールでこのエンリッチメントを使用します。

属性名： 最後の購入日

• 開始値: ""
• エンリッチされた値:
• 結果の値: 1491233145706

日付の構成

Set dateエンリッチメントは、他の属性の値に属性を構成します。他の属性が文字列の場合は、Date Formatterを使用して日付に変換します。このエンリッチメントはイベント、訪問、および訪問属性で利用可能です。

属性名: 最後の購入日

• 開始値: ""
• 文字列でエンリッチされた: 01/04/2019
• 使用する形式: dd/MM/yyyy (この形式は、文字列を解析するための日、月、年の順序を指定します。)

Set Dateエンリッチメントを使用して、他の日付属性（EventStreamまたはAudienceStream）からEventStreamの日付を構成する場合、形式文字列のプレースホルダーを使用できます。たとえば、Set Dateエンリッチメントで次のように構成します：

• 構成する日付: 値を構成したい日付属性。この例では、date_of_birth。
• 日付形式で: 任意のプレースホルダーを入力します。たとえば、x。

日付の削除

Remove dateエンリッチメントは、日付属性の値を消去します。このエンリッチメントはイベント、訪問、および訪問属性で利用可能です。

属性名: 最後の訪問日

• 開始値: 1491233145706
• 結果の値: (削除されました)

日付形式からの変換

Convert from date formatエンリッチメントは、受信値の予想される日付形式に基づいて値を構成します。このエンリッチメントは、CollectタグまたはHTTP APIから送信された文字列値を変換するために使用されます。Date Formatterを使用して文字列値を日付に変換します。このエンリッチメントはイベント属性で利用可能です。