Referencia de etiquetas de búsqueda del catálogo

Qué aprenderás

Descubre cómo usar la etiqueta de catálogo, que te permite hacer referencia a información específica de productos de tu catálogo en tus emails, SMS y mensajes push. Esto resulta útil cuando quieres crear recomendaciones personalizadas de productos o cruzar información de productos. Por ejemplo, si usas tu propio motor de recomendaciones, puedes pasar tus propias recomendaciones de productos como datos de evento o de perfil a Klaviyo y, después, utilizar esos datos en plantillas.

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 del producto sincronizado desde tu propio catálogo de productos. Ten en cuenta que esta búsqueda es específicamente para el ID del producto y no para el SKU.

Incluir unpublished="cancel" garantizará que no envíes tu mensaje en caso de que el artículo al que se hace referencia no esté publicado. 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á el mensaje completo.
• Para un mensaje de flujo determinado, puedes ir a Analítica > Actividad del destinatario > Otros y ver una lista etiquetada como Omitidos: artículo del 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 estaba disponible por algún otro motivo.

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

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

Puede que haya campos de datos adicionales disponibles que se consideren metadatos. Para hacer referencia a una de estas propiedades adicionales del artículo, puedes usar la sintaxis de variable: {{ catalog_item.metadata.color }}. En este caso, la variable recuperará el valor «color» asociado al artículo almacenado en los metadatos del artículo.

Para acceder a una vista previa de todos los detalles disponibles almacenados en 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 %}

Luego, previsualiza el mensaje. Esta vista previa ofrece una versión sin procesar de todos los datos disponibles de tus productos.

Filtrar por ID del catálogo

Si tienes varios catálogos, puedes especificar de qué catálogo quieres extraer la información mediante la etiqueta {{catalog id}}. Por ejemplo, puedes tener un catálogo sincronizado a través de una integración de Klaviyo como Shopify, un catálogo sincronizado mediante API o un feed de catálogo personalizado. Los detalles de la etiqueta pueden variar en función de tu integración. En el siguiente ejemplo, se sincronizan varios catálogos con la misma cuenta de Klaviyo y queremos extraer la descripción de un producto específico incluido en un catálogo de API.

Primero, busca el ID del catálogo:

1. En Klaviyo, ve a Contenido > Productos.
2. Selecciona el catálogo que quieras usar en el menú desplegable Todos los catálogos.
   

3. Copia el ID del catálogo desde la URL.
   

Luego, busca el ID del artículo:

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

En el ejemplo anterior, el código tendría este aspecto:

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

Filtrar por configuración regional

Los catálogos adaptados al mercado, como el catálogo de Shopify en Klaviyo, se pueden buscar por configuración regional. Se puede hacer referencia al idioma y la región de la configuración regional con el código de país y de idioma de dos letras usando las normas ISO 3166 e ISO 639. Si no se puede encontrar un producto localizado, se usará la información del producto predeterminada.

{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }}{% endcatalog %}

Busca un ID de artículo pasado con un evento

El uso de una búsqueda de catálogo con un evento se utiliza principalmente en los siguientes casos:

• Si usas 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 generan recomendaciones únicas en función de los artículos vistos. En lugar de incluir en el mensaje el único artículo que un cliente vio, puedes generar e incluir un conjunto de artículos recomendados en función de ese artículo visto. Se debe enviar a Klaviyo un conjunto de ID de producto junto con el evento.
• Si estás usando una integración personalizada y prefieres no enviar todos los detalles del producto que deben incluirse en un mensaje. Por ejemplo, con un mensaje de carrito abandonado, envía solo los ID de producto de todos los artículos abandonados y Klaviyo puede buscar cada uno para extraer todos los detalles relevantes. No hace falta que cada evento incluya el nombre del producto, el precio, la imagen, etc., ya que todo esto se puede completar pasando solo el ID de producto a Klaviyo y, después, buscando la información en tu catálogo de productos de Klaviyo.

Al usar una etiqueta {% catalog %} con un evento, la búsqueda se basa en el ID del artículo del elemento del catálogo (será el ID del producto o la SKU, según la integración).

Para un evento en el que el valor identificador que se pasa es el ID del artículo, las etiquetas de búsqueda se verán así:

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

Dentro de este bloque {% catalog %}, añade etiqueta de plantilla para los datos que te gustaría completar sobre cada artículo (p. ej., título, imagen, etc.)

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

Datos de artículo de catálogo:

{
  "description": "Standard issue for all Klaviyos. This t-shirt has the Klaviyo logo on the front and mark diagram on the back.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "title": "Classic Klaviyo T-Shirt",
  "featured_image": {
    "full": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-full.png"
    },
    "thumbnail": {
      "src": "https://www.klaviyo.com/media/images/examples/products/klaviyo-tshirt-thumbnail.png"
    }
  },
  "id": "KLAVIYO-TSHIRT",
  "metadata": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

Sintaxis del bloque de plantilla:

La sintaxis del siguiente bloque {% catalog %} incorporaría la imagen, el título y la descripción del artículo desde 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 puede encontrar el artículo que está buscando, el mensaje se omite y no se envía.

Buscar un ID de artículo como una propiedad personalizada

Si usas tu propio motor de recomendaciones, puedes pasar los ID de artículos recomendados a los perfiles en Klaviyo como una propiedades de perfil personalizada. Con una etiqueta {% catalog %}, puedes hacer referencia a la información de cualquiera de estos productos al enviar mensajes a este cliente.

Si la búsqueda no puede encontrar el artículo que está buscando, el mensaje se omite y no se envía.

Sintaxis para varios ID de artículos almacenados 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 único ID de elemento 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

Usa la etiqueta has_category para determinar si un artículo de tu catálogo forma parte de una categoría específica. Debe usarse dentro de una etiqueta de búsqueda de catálogo para un artículo específico.

Utiliza el código de muestra que aparece a continuación para usar esta etiqueta y sustituye 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 %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}

Este ejemplo muestra el título del producto y, a continuación, comprueba si el producto está en una categoría, category_name. Si esto se evalúa como true, el mensaje «¡Estoy de oferta!» aparecerá después del título del producto.

Recursos adicionales