テンプレートの日時パーソナライズに関するレファレンス

このページで学べること

Klaviyo テンプレートで日付を動的に挿入して書式設定する方法をご覧ください。プロファイルプロパティ（例：誕生日）の日付は任意のメッセージに入力でき、イベントメタデータ（例：注文の確定日）の日付は、そのイベントによってトリガーされるフローメッセージに入力できます。

当日、週、月、または年を入力します

日付タグを使用すると、メッセージにキャンペーンの時間をすばやく挿入できます。日付はアカウントのタイムゾーンに基づきます。

• 今日の日付: 今月の今日の日付は {% current_day %} です。
  今月の今日の日付は 5 です。
  
• 現在の曜日：現在の曜日は {% current_weekday %} です。
  現在の曜日は金曜日です。
  
• 当月：当月は {% current_month_name %} です。
  当月は 9 月です。
  
• 現在の年：現在の年は {% current_year %} です。
  現在の年は 2021 年です。

現在、月名と曜日名は英語表記のみサポートしています。

メッセージに動的な日付を追加するには：

1. 任意のテキスト フィールド（例：メールのテキスト ブロック、SMS エディター、プッシュ メッセージ エディター）で、パーソナライズ アイコンをクリックしてください。
   

2. [すべてのタイプ] メニューから [日付] を選択します。
3. 日付タグ（例：Current date、current year など）を選択します。

フロー メールでイベント変数として動的な日付を設定する

たとえば、お客様が注文を行うたびにトリガーされるフローを通じて、お礼メールを送信しているとします。「_____ にいただいたご注文ありがとうございます」といった一文を追加し、注文日を指定できます。

たとえば「Placed Order」のイベントのように、 Klaviyo がイベントとともに受信するデータ を確認すると、注文日を表す変数が見つかるはずです。プロパティ名はデータソースによって異なるため、"order date" またはそれに近い名称のプロパティを探してください。

この変数が見つかると、次に、この日付の形式がテンプレートで使用するには理想的ではないことに気付くはずです。たとえば、UTC タイムスタンプであり、メールでは見栄えがよくありません。

この日付をより顧客にとって分かりやすい形式で表示するには、いくつかのフィルターを適用する必要があります。Klaviyo は、Django テンプレート言語で使用されるフィルターの大半をサポートしています。このユースケースでは、次のフィルターを使用する必要があります。

• Format_date_string
  このフィルタは、UTC タイムスタンプ全体からスライスされた文字列を解析して実際の日付に変換します。日付フィルタを使用して書式設定できるようにするために必要です。
• 日付
  ここでは、日付の形式をどのように設定するかを選択できます。Django には、この方法の概要を示す表があります。

これらのフィルタを適用するには、パイプ (|) で区切り、間にスペースを入れないでください：

{{ your_variable|format_date_string|date:'F d, o' }}

上記により、これは次のように変わります：

2016-02-11T16:46:08-05:00

次のようになります：

2016年2月11日

以下に、その他の一般的な日付と時刻の形式と、それらを表示する際に使用される書式を示します。

日付形式オプションの全一覧については、Django の日付形式ドキュメントを参照してください。

「今日」変数の使用

today 変数を使用すると、メッセージの送信時点の今日の日付を表示できます。今日の日付を表示するには、次のコードを使用します。

{% today "%Y-%m-%d" as today %} {{ today }}

日付は次の形式で表示されます：2021-03-18

異なる書式設定を適用するには、上のセクションのフィルターを {{ today }} 変数に適用します。たとえば、{% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y'  }} は形式 MM/DD/YYYY を使用してレンダリングされます。

将来の日付を計算する

メッセージの送信日を基準に将来の日付を表示する場合は、上記で説明した today 変数に days_later フィルターを適用します。次のように設定してください：

{% today "%Y-%m-%d" as today %} {{ today|days_later:5 }}

この変数には、メッセージ送信から 5 日後の日付が表示されます。そのため、メッセージが 3 月 18 日に送信された場合、表示される日付は 2021-03-23 になります。

このフィルターは、上記で説明した書式設定フィルターと組み合わせて、別の日付形式を使用できます。このコードを例にしてください：

{% today '%Y-%m-%d' as today %} {{ today|days_later:5|format_date_string|date:'M  d' }}

メッセージが 3 月 18 日に送信された場合、これは Mar 23 として表示されます。

その他のリソース