Referencia de etiquetas de búsqueda de catálogo

Objetivos del artículo

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 correos electrónicos, SMS y mensajes push. Esto es útil cuando quieres crear recomendaciones de productos personalizadas 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 luego usar esos datos en plantillas.

La etiqueta {% catalog %}

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

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

Reemplaza itemID por el ID del producto del producto al que haces referencia. Este es el ID del producto tal como se sincronizó 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 el 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 haga referencia en el mensaje no está publicado en el catálogo en el momento de la búsqueda, se omitirá todo el mensaje.
• Para un mensaje de flujo determinado, puedes ir a Análisis > Actividad del destinatario > Otros y ver una lista etiquetada como Omitido: artículo de catálogo no disponible. Esta lista incluye todos los perfiles que se omitieron porque un artículo destacado 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 con el itemID en el catálogo de productos de Klaviyo.

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

Es posible 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 incorporará el valor de "color" asociado con el 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— agrega 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 proporciona una versión sin procesar de todos los datos disponibles para tus productos.

Filtrado por ID de catálogo

Si tienes varios catálogos, puedes especificar de cuál catálogo quieres obtener la información con la etiqueta {{catalog id}}. Por ejemplo, podrías tener un catálogo sincronizado a través de una integración de Klaviyo como Shopify, un catálogo sincronizado mediante la interfaz de programación de aplicaciones (API) o un feed de catálogo personalizado. Los detalles de las etiquetas pueden variar según tus integraciones. En el siguiente ejemplo, se sincronizan varios catálogos en la misma cuenta de Klaviyo y queremos obtener una descripción del producto de un producto específico incluido en un catálogo de interfaz de programación de aplicaciones (API).

Primero, encuentra el ID del catálogo:

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

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

Luego, busca el ID del elemento:

1. Después de seleccionar el catálogo, selecciona el producto que quieras usar 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 se vería así:

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

Filtrar por configuración regional

En Klaviyo, los catálogos adaptados al mercado, como el catálogo de Shopify, se pueden buscar por configuración regional. Se puede hacer referencia al idioma y la región locales con el código de país y de idioma de dos letras usando las normas ISO 3166 y 639. Si no se encuentra 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 %}

Buscar un ID de artículo pasado con un evento

Usar una búsqueda de catálogo con un evento se utiliza principalmente en los siguientes escenarios:

• Si usas una integración personalizada en la que las recomendaciones de productos se envían 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 en función de los artículos vistos. En lugar de completar el único artículo que un cliente vio en el mensaje, puedes generar y completar un conjunto de artículos recomendados en función de ese artículo visto. Es necesario enviar un conjunto de ID de producto a Klaviyo junto con el evento.
• Si usas 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, solo envía los ID del producto de todos los artículos abandonados y Klaviyo puede buscar cada uno 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 completar solo con pasar el ID del producto a Klaviyo y luego buscar la información en el 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 artículo del catálogo (será el ID del producto o el SKU, según la integración).

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

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

Dentro de este bloque {% catalog %}, agrega etiquetas de plantilla para los datos que te gustaría completar sobre cada artículo (por ejemplo, título, imagen, etc.)

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

Datos de artículos del 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 de bloque de plantilla:

La sintaxis del siguiente bloque {% catalog %} incorporaría la imagen, el título y la descripción del artículo del 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.

Busca 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 del perfil. 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 ID de elemento único en una de las 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

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

Usa el código de muestra a continuación para usar esta etiqueta, reemplazando itemID con un ID de producto de tu catálogo y category_name con 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 luego revisa si el producto está en una categoría, category_name. Si esto se evalúa como true, el mensaje "¡Estoy en oferta!" aparecerá después del título del producto.

Recursos adicionales