フィルターを使用して変数をカスタマイズする方法

このページで学べること

フィルターの仕組みと、それらを使用して変数をカスタマイズする方法を確認してください。フィルターを使用すると、メッセージ内の変数（例：パーソナライゼーションタグ）の形式と内容をカスタマイズできます。テンプレートエディターで使用できるフィルターの一覧については、Klaviyo の 変数フィルター用語集をご参照ください。

始める前に

開始する前に、Klaviyo でパーソナライゼーションがどのように機能するかを確認してください。フィルターを使用するには、正しいベース変数を特定し、テンプレートに追加できる必要があります。

フィルターの仕組み

パーソナライゼーションタグには、表示される出力を調整するためにフィルターが適用されます。想定されるユースケースは次のとおりです：

• テキストに一貫した大文字/小文字のルールを適用します（たとえば、upper フィルタを使用して、任意の変数をすべて大文字にできます）。
• multiply フィルターを使用して、プロモーション適用後のアイテムの価格を表示します。
• floatformat フィルターを使用して、数値変数に表示する小数点以下の桁数を設定します。

サポートされているフィルターの一覧については、 変数フィルター用語集 を参照してください。

変数にフィルタを適用

変数にフィルターを適用するには：

1. パーソナライズーションタグ（例：{{ item.price }}）を特定します。
2. 変数名の後にパイプ記号 ( | ) を追加します。
3. 表示する小数点以下の桁数を指定するために、floatformat などのフィルター名を追加します。
4. フィルターに引数（つまり追加の入力）が必要な場合、または任意の引数を設定する場合は、コロン（：）に続けて引数を追加してください。

コロンの前後にスペースを入れないでください。引用符で囲まれたテキスト引数内のスペースは許容されます。フィルターが適用された変数の例を次に示します：

{{ item.price|floatformat:2 }}

この例では、item.priceが変数名、floatformatがフィルター、2がオプションの引数です。この引数は、フィルターに対して数値を小数点以下2桁に丸め、小数点以下2桁の両方を表示するよう指定します。

引数がテキストの場合は、一致するストレートのシングルまたはダブルの引用符（例：'または"。‘や“ではありません）で囲んでください。引数が数値の場合、引用符は必要ありません。例については、Klaviyoの変数フィルター用語集を参照してください。

フィルターを追加したら、参照しているデータを含むプロファイルまたはイベントでメッセージをプレビューしてください。メールエディターでプレビューをクリックし、値と形式が正しいことを確認してください。

フィルターを使用するためのヒント

フィルターをコピーしてテンプレートに貼り付ける場合は、フィルター自体に加えて書式設定も貼り付けられないように、プレーンテキストとして貼り付けてください。プレーンテキストとして貼り付けるキーボード ショートカット（Ctrl+Shift+V または Cmd+Shift+V）を使用します。

変数で参照されるデータが、使用しているフィルターに対して適切であることを確認することが重要です。一部のフィルタはテキスト データ型 にのみ適用でき、他のフィルタはリストまたは数値でのみ機能します。フィルターが想定どおりに動作しない場合は、使用しているイベントまたはプロファイル データを見直し、正しいタイプであることを確認してください。

複数のフィルタを適用する

必要に応じて、1つの変数に複数のフィルターを適用できます。その場合は、パイプ記号（|）を使用して各フィルターを接続してください。フィルターは（最初から最後まで）順番に適用され、各フィルターは1つ前のフィルターの結果を使用します。複数のフィルターを適用した変数の例をいくつか示します：

{{ first_name|title|default:'there' }}

1 つ目のフィルターは受信者の名の先頭文字を大文字にし、2 つ目のフィルターは名が指定されていない場合に使用する既定の単語を設定します。

{{ item.price|multiply:.8|floatformat:2 }}

最初のフィルターは、基本アイテム価格に0.8を掛けます。（20％オフのクーポンが適用された場合の価格を表示するため）、2つ目のフィルターは小数点以下2桁を表示するよう指定します。

その他のリソース