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

Qué aprenderás

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. 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 %}

Sustituya itemID por el ID del producto al que hace referencia. Este es el ID del producto tal y como se sincroniza desde su propio catálogo de productos. Tenga en cuenta que esta búsqueda es específicamente para el ID del producto y no para el SKU.

Si incluye unpublished="cancele" se asegurará de que no envía su mensaje en caso de que el artículo al que hace referencia no esté publicado. Este argumento es opcional. 

• Si algún artículo al que se hace referencia en su mensaje no está publicado en su catálogo en el momento de la búsqueda, se omitirá todo el mensaje.
• Para un mensaje de flujo determinado, puede navegar a Analytics > Actividad del destinatario > Otro y ver una lista etiquetada como Omitido: Elemento 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 por cualquier otro motivo.

Al utilizar esta función, entre las etiquetas de apertura y cierre del catálogo, puede hacer referencia a datos específicos del artículo asociado al itemID en su catálogo de productos Klaviyo.

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

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

Para acceder a una vista previa de todos los detalles disponibles almacenados en un artículo -incluidos todos los metadatos-, añada el siguiente fragmento a un bloque de texto de una plantilla de prueba y actualice itemID con el ID de producto de uno de los productos actuales de su 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.

filtro 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, catálogo sincronizado a través de 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 de Klaviyo y queremos extraer una descripción de producto de un producto concreto contenido en un catálogo de la 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 artículo pasado con un evento

El uso de una búsqueda en el catálogo con un evento se utiliza sobre todo en los siguientes escenarios:

• Si está utilizando una integración personalizada en la que las recomendaciones de productos se pasan junto con un evento para mostrarlas en el mensaje. Por ejemplo, un mensaje de abandono de navegación en el que se generen recomendaciones únicas basadas en los artículos vistos. En lugar de rellenar el único artículo que ha visto un cliente en el mensaje, puede 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 está utilizando una integración personalizada y prefiere no enviar todos los detalles del producto que deben ir en un mensaje. Por ejemplo, con un mensaje de carrito abandonado, envíe únicamente 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 hay necesidad de 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 su catálogo de productos Klaviyo.

Cuando se utiliza una etiqueta {% catalog %} 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 en función de la integración).

Para un evento en el que el valor de identificación pasado es ID de artículo, las etiquetas de búsqueda aparecerán así:

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

Dentro de este bloque {% catalog %}, añada variables de plantilla para los datos que desee rellenar en relación con cada elemento (es decir. título, imagen, etc.)

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

Datos del artículo del catálogo:

{
  "descripción": "Número estándar para todos los Klaviyos. Esta camiseta tiene el logotipo de Klaviyo en la parte delantera y el diagrama de marcas en la trasera.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "título": "Camiseta clásica Klaviyo",
  "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",
  "metadatos": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

Sintaxis del bloque de plantillas:

La sintaxis del siguiente bloque {% catalog %} extraería la imagen del artículo, el título del artículo y la descripción del artículo de su 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 un ID de 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 de perfil personalizadas. Utilizando 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 múltiples ID de artículos almacenados en una única 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 único ID de artículo en una propiedad de 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

Utilice la etiqueta has_category para determinar si un artículo de su 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. 

Utilice el código de ejemplo siguiente para utilizar esta etiqueta, sustituyendo itemID por un ID de producto de su 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 en oferta!
{% else %}
{% endif %}
{% endcatalog %}

Este ejemplo muestra el título del producto y, a continuación, comprueba si el producto pertenece a una categoría, category_name. 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 los feeds de productos y las recomendaciones
• Visión general del editor de plantillas de correo electrónico