Referencia de la etiqueta de búsqueda del catálogo

Objetivos de aprendizaje

Aprende a utilizar la etiqueta de catálogo, que te permite hacer referencia a información específica de productos de tu catálogo dentro de tu correo electrónico, SMS, y mensajes push de notificación. Esto es útil cuando quieres crear recomendaciones de productos personalizadas, o cruzar información sobre productos. Por ejemplo, si utilizas tu propio motor de recomendación, puedes pasar tus propias recomendaciones de productos como evento o datos del perfil a Klaviyo, y luego utilizar esos datos en plantilla.

La etiqueta {% catalog %}

La etiqueta {% catalog %} utiliza la siguiente sintaxis:

{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}

Sustituye itemID por el ID del producto al que haces referencia. Este es el ID de producto sincronizado desde tu propio catálogo de productos. Ten en cuenta que esta búsqueda es específicamente para el ID de producto y no para el SKU.

Si incluyes unpublished="cancel" te asegurarás de no enviar tu mensaje en caso de que el elemento al que se hace referencia esté inédito. Este argumento es opcional. 

• Si algún artículo al que se hace referencia en tu mensaje no está publicado en tu catálogo en el momento de la búsqueda, se omitirá todo el mensaje.
• Para un determinado mensaje de flujo, puedes navegar a análisis > destinatarios Actividad > Otros y ver una lista con la etiqueta Omitido: Artículo de catálogo no disponible. Esta lista incluye todos los perfiles que se omitieron porque un artículo incluido en el mensaje estaba agotado o no disponible.

Al utilizar estas funciones/características, entre la etiqueta de apertura y la de cierre del catálogo, puedes hacer referencia a datos específicos del artículo asociado al itemID en tu Klaviyo catálogo de productos.

Los siguientes datos están disponibles como referencia dentro de un bloque {% catalog %} bloque.

Puede haber campos de datos adicionales que se consideren metadatos. Para hacer referencia a una de estas propiedades adicionales de los elementos, puedes utilizar la sintaxis variable: {{ catalog_item.metadata.color }}. En este caso, la variable extraerá el valor "color" asociado al artículo tienda, comercio en los metadatos del artículo.

Para acceder a una vista previa de todos los detalles disponibles tienda, comercio sobre un artículo -incluidos todos los metadatos- añade el siguiente fragmento a un bloque de texto en una plantilla de prueba, y actualiza itemID con el ID de producto de uno de los productos actuales de tu catálogo.

{% catalog itemID %} {{ catalog_item }} {% endcatalog %}

A continuación, previsualiza el mensaje. Esta vista previa proporciona una versión sin procesar de todos los datos disponibles para tus productos.

Filtrar por ID de catálogo 

Si tienes varios catálogos, puedes especificar de qué catálogo quieres tirar utilizando la etiqueta {{catalog id}} etiqueta Por ejemplo, puedes tener un catálogo sincronizado a través de una Klaviyo integraciones como Shopify, un catálogo sincronizado a través de una interfaz de programación de aplicaciones (API), o un feed de catálogo personalizado. Los detalles de la etiqueta pueden variar en función de tus integraciones. En el siguiente ejemplo, varios catálogos están sincronizados con la misma cuenta Klaviyo y queremos extraer una descripción de producto de un producto concreto contenido en un catálogo de interfaz de programación de aplicaciones (API).

Primero, busca el ID del catálogo:

1. En Klaviyo, navega hasta Contenido > Productos.
2. Selecciona el catálogo que quieras utilizar en el desplegable Todos los catálogos.
   
3. Copia el ID del catálogo de la URL.
   

A continuación, busca el ID del artículo:

1. Después de seleccionar el catálogo, selecciona el producto que quieres utilizar del catálogo.
2. En la página de detalles del producto, verás el ID del artículo.
   

Para el ejemplo anterior, el código tendría el siguiente aspecto:

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }} {% endcatalog %}

Buscar un ID de elemento pasado con un evento

Utilizar una búsqueda en el catálogo con un evento se utiliza sobre todo en los siguientes casos:

• Si utilizas integraciones personalizadas en las que las recomendaciones de productos se pasan junto con un evento para mostrarlas en el mensaje. Por ejemplo, un mensaje de abandono de la navegación en el que se generan recomendaciones únicas basadas en los artículos vistos. En lugar de rellenar el único artículo que un cliente ha visto en el mensaje, puedes generar y rellenar un conjunto de artículos recomendados basados en ese artículo visto. Es necesario enviar a Klaviyo un conjunto de ID de producto junto con el evento.
• Si utilizas integraciones personalizadas y prefieres no enviar todos los detalles del producto que deben ir en un mensaje. Por ejemplo, con un mensaje de carrito abandonado, envía sólo los ID de producto de todos los artículos abandonados y Klaviyo podrá buscar cada uno de ellos para extraer todos los detalles relevantes. No es necesario que cada evento contenga el nombre del producto, el precio, la imagen, etc., ya que todo esto se puede rellenar con sólo pasar el ID del producto a Klaviyo, y luego buscar la información en tu catálogo de productos de Klaviyo.

Cuando se utiliza una {% catalog %} etiqueta con un evento, la búsqueda se basa en el ID de artículo del artículo del catálogo (será ID de producto o SKU, según las integraciones).

Para un evento en el que el valor identificativo pasado es ID de artículo, la etiqueta de búsqueda aparecerá así:

{% catalog event.ItemID %}
...
{% endcatalog %}

Dentro de este {% catalog %} bloque, añade etiquetas de plantilla para los datos que quieras rellenar sobre cada elemento (por ejemplo título, imagen, etc.)

Por ejemplo, utilizando los datos del artículo del catálogo de muestra que aparecen a continuación, podemos crear un bloque {% catalog %} que haga referencia a la información clave del producto:

Datos del artículo del catálogo:

{
 " descripción": "Standard asunto para todos los Klaviyos. Esta camiseta tiene el logotipo de Klaviyo en la parte delantera y el diagrama de marcas en la espalda.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "título": "Clásico Klaviyo Camiseta",
 " featured_image": {
 " completa": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
    },
 " miniatura": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
    }
  },
 " id": "Klaviyo-TSHIRT",
 " metadata": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

plantilla bloque sintaxis:

La sintaxis del siguiente bloque {% catalog %} obtendría la imagen, el título y la descripción del artículo de tu catálogo, para cada artículo del evento:

{% for item in event.Items %}
	{% catalog item.SKU %}
 		<img src="{{ catalog_item.featured_image.full.src }}" />
 		{{ catalog_item.title }}
 		{{ catalog_item.description }}
 	{% endcatalog %}
{% endfor %}

Si la búsqueda no encuentra el elemento que busca, el mensaje se omite y no se envía.

Buscar el ID de un artículo como propiedad personalizada

Si utilizas tu propio motor de recomendación, puedes pasar los ID de los artículos recomendados a perfil en Klaviyo como propiedades personalizadas del perfil. Con una etiqueta {% catalog %} puedes hacer referencia a la información de cualquiera de estos productos cuando envíes un mensaje a este cliente.

Si la búsqueda no encuentra el elemento que busca, el mensaje se omite y no se envía.

Sintaxis para varios ID de artículos tienda, comercio en una sola propiedad

{% for item in person|lookup:'Recommended Products' %}{% catalog item %} 

<img src="{{ catalog_item.featured_image.thumbnail.src }}" style="display: inline-block; border: none" width="150px" />

<p>{{ catalog_item.title }} {% endcatalog %}</p>

{% endfor %}

Sintaxis para un ID de elemento único en a propiedades del perfil

{% catalog person|lookup:"Recommended Products" %} 

<img style="display: inline-block; border: none;" src="{{ catalog_item.featured_image.thumbnail.src }}" width="150px"/>

  <p>{{ catalog_item.title }} {% endcatalog %}</p>

Acerca de la etiqueta has_category

Utiliza la etiqueta has_category para determinar si un elemento de tu catálogo forma parte de una categoría determinada. Debe utilizarse dentro de una etiqueta de búsqueda de catálogo para un artículo concreto. 

Utiliza el código de ejemplo siguiente para utilizar esta etiqueta, sustituyendo itemID por un ID de producto de tu catálogo y category_name por todo o parte del nombre de una categoría. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
¡Estoy de rebajas!
{% else %}
{% endif %}
{% endcatalog %}

Este ejemplo muestra el título del producto y, a continuación, comprueba si el producto está en una categoría, nombre_categoría. Si se evalúa como verdadero, aparecerá el mensaje "¡Estoy de oferta!" a continuación del título del producto. 

Recursos adicionales

• Cómo utilizar la fuente de productos y recomendaciones
• Visión general del editor de plantillas de correo electrónico