テンプレートでカスタムオブジェクトを使用する方法

このページで学べること

テンプレートでカスタムオブジェクトを使用する方法を確認し、フローやキャンペーンの送信でオブジェクトデータを使用できるようにします。

テンプレートでカスタム オブジェクトデータを使用する前に、まず オブジェクトを作成する必要があります。

パーソナライズメニューからオブジェクトデータにアクセスする

テンプレートエディタでは、カスタムオブジェクトのプロパティ、またはオブジェクトのレコード数を使用してテキストブロックをパーソナライズできます。

Klaviyo のテンプレートエディタの使用方法をご覧ください。

テンプレートにオブジェクトデータを追加し始めるには：

1. 新しいテキストブロックを追加するか、既存のテキストブロックを選択してください。
2. テキストブロック内をダブルクリックしてから、動的プロパティを挿入したい場所にカーソルを置きます。
3. 右上の [パーソナライゼーション] ボタンを選択します。

4. パーソナライズ モーダルで、 すべてのタイプ のドロップダウンから オブジェクト を選択してください。

5. Objects 内に、テンプレートにデータを取り込むために使用できる、アカウント上のすべてのオブジェクトが表示されます。テンプレートで使用するデータが含まれるオブジェクトを選択します。
6. テンプレートに含める特定のオブジェクトプロパティまたは オブジェクトフィルターを選択します。ここで新しいオブジェクトフィルターを作成することもできます。
7. テキストのデフォルトの文章とスタイルを設定します。

オブジェクト データの大文字ルールを指定するには、パーソナライゼーションタグでルールを手動で設定する必要があります。例：

• {{ object.full_name|title|default:'value' }}
  John Doe
• {{ object.full_name|upper|default:'value' }}
  JOHN DOE
• {{ object.full_name|lower|default:'value' }}
  john doe

Django フィルタを使用した値の変更について詳しくは、こちらをご覧ください。

パーソナライゼーションタグを使用してオブジェクト データにアクセスする

オブジェクトデータを表示するために、メール（メールの件名を含む）、SMS/MMS メッセージ、プッシュ通知、カスタマーハブでパーソナライゼーションタグを使用できます。

Klaviyo でパーソナライゼーションタグを使用する方法を学びましょう。

オブジェクトのパーソナライゼーションタグ参照

オブジェクトで次のパーソナライゼーションタグを使用できます。

フローをトリガーしたオブジェクトを使用する

これらの例では、次を使用します：

• テンプレート内で object タグにより参照される Pet という名前のオブジェクト。
• 名前 というオブジェクトプロパティ

ID でオブジェクトを取得

これらの例では、次を使用します：

• ペット というオブジェクト
• 名前 というオブジェクトプロパティ
• pet_id というオブジェクトプロパティを持つオブジェクトによってフローがトリガーされるイベント。このフィールドは、Pet オブジェクトのオブジェクト ID と同じです。

オブジェクトフィルターから単一のオブジェクトを返す

これらの例では、次を使用します：

• oldest_dog と呼ばれる追加のオブジェクトフィルター
• 名前 というオブジェクトプロパティ

オブジェクトフィルターから整数を返す

これらの例では、次を使用します：

• count_of_dogs と呼ばれる追加のオブジェクト フィルター

オブジェクトレコードを取得

オブジェクトの最新のオブジェクトレコードを取得するには、すべてのオブジェクトレコードをループ処理する必要があります。この例では次を使用します:

• Pets という名前のオブジェクト

件名のオブジェクト データ

次のいずれのカスタムオブジェクトタグでも件名をパーソナライズできます：

• {% object_filter %}
• {% object %}
• {% customobject %}

例えば、メッセージの件名で {% object %} タグを使用すると、顧客のペットの名前を直接表示できます。

下書きビュー：

メールプレビュー：

表示/非表示ロジックのオブジェクトデータ

オブジェクトデータに基づいて、テンプレート内でブロックを表示または非表示にするかどうかも設定できます。オブジェクトデータに基づいてブロックを動的に表示または非表示にする場合は、テンプレートビルダーと同じタグを使用します。ID によるオブジェクトの参照、オブジェクトフィルターのプロパティ、またはオブジェクトフィルターの集計を参照できます。

たとえば、Pet オブジェクトに Breed というプロパティがある場合、object.Breed 条件を使用して、特定の犬種のペットオーナーにのみブロックを表示するように選択できます。

表示/非表示ロジックを設定するには、ルールを設定したいブロックをクリックし、[表示] タブで[コードを使用] を選択します。

条件をコードエディターに直接入力します。オブジェクトデータに基づく日付トリガーのフロー向けのメッセージであれば、オブジェクトフィルターとオブジェクトテンプレートタグを使用できます。

さらに柔軟にするには（例：{% customobject %} または {% customobjects %} から返される情報に基づいて一部の情報を条件付きにする場合）、テキストブロック内で {% if ... %} ロジックを直接使用し、{% if ... %} の [高度な条件付きロジック] の利用をご検討ください。

オブジェクト フィルター

オブジェクト フィルターとは何ですか？

オブジェクトフィルターを使用すると、設定した特定の条件に基づいて返されるオブジェクトレコードを制限できるため、特定のタイプのレコードを表示できます。

新しいオブジェクト フィルターを作成する

オブジェクト フィルターの作成を開始するには：

1. テンプレートに新しいテキスト ブロックを追加するか、既存のテキスト ブロック内のテキストを編集します。
2. [パーソナライゼーション] ボタンを選択します。

3. パーソナライゼーションモデル内で、 すべての種類 ドロップダウンから オブジェクト を選択します。
4. フィルターを設定したいデータが含まれるオブジェクトを選択します。
5. フィルターを設定するオブジェクト プロパティを選択します。
6. [新しいフィルターを作成] を選択します。

Create object filter モーダルで、次の情報を設定します：

• 名前
  オブジェクト フィルターの名前を作成します。
• フィルター条件
  テキストブロックに含めるためにオブジェクトが満たす必要があるルールを定義します。
• 複数のレコードが条件を満たす場合の動作
  複数のレコードが条件を満たすケースにおける動作を定義します。

オブジェクトフィルターを作成したら、表示/非表示ロジックおよびパーソナライゼーションタグで使用して、設定した条件に基づいて特定のオブジェクトレコードを表示できます。

その他のリソース