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

このページで学べること

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

始める前に

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

フィルターの仕組み

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

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

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

変数にフィルタを適用

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

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

追加のスペースは入れないでください。以下は、フィルターを適用した変数の例です。

{{ item.price|floatformat:2 }}

この例では、item.price が変数名、floatformat がフィルタ、2 がフィルタで必要な引数です。

引数がテキストの場合は、ストレートのシングルクォーテーションマーク（つまり ‘ ではなく '）で囲む必要があります。引数が数値の場合は、クォーテーションマークは不要です。例については、Klaviyo の variable filters glossary を参照してください。

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

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

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

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

必要に応じて、1 つの変数に複数のフィルターを適用できます。そのためには、各フィルターをパイプ記号（ | ）で接続し、一般的にフィルターは順番（最初から最後）に適用されることを考慮してください。複数のフィルターが適用された変数の例：

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

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

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

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

その他のリソース