Referência de tag de pesquisa de catálogo

O que você vai aprender

Saiba como usar o catálogo tag, que permite que o senhor faça referência a informações específicas de produtos do seu catálogo nas mensagens de e-mail, SMS e push. Isso é útil quando o senhor deseja criar recomendações personalizadas de produtos ou fazer referência cruzada às informações do produto. Por exemplo, se o senhor estiver usando seu próprio mecanismo de recomendação, poderá passar suas próprias recomendações de produtos como evento ou dados do perfil para Klaviyo e, em seguida, utilizar esses dados no modelo.

A tag {% catalog %}

A tag {% catalog %} usa a seguinte sintaxe:

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

Substitua itemID pelo ID do produto ao qual o senhor está fazendo referência. Esse é o ID do produto, conforme sincronizado a partir de seu próprio catálogo de produtos. Observe que essa pesquisa é especificamente para o ID do produto e não para o SKU.

A inclusão de unpublished=" cancel " garantirá que o senhor não envie sua mensagem caso o item referenciado não seja publicado. Esse argumento é opcional. 

• Se algum item mencionado em sua mensagem não estiver publicado em seu catálogo no momento da pesquisa, a mensagem inteira será ignorada.
• Para uma determinada mensagem de fluxo, o senhor pode navegar até Analytics > Recipient Activity > Other e ver uma lista rotulada como Skipped: Catalog Item Unavailable (Item de catálogo indisponível). Essa lista inclui todos os perfis que foram ignorados porque um item apresentado na mensagem estava fora de estoque ou indisponível.

Ao usar esse recurso, entre as tags de abertura e fechamento do catálogo, o senhor pode fazer referência a dados específicos do item associado ao itemID no seu catálogo de produtos Klaviyo.

Os dados a seguir estão disponíveis para referência dentro de um bloco {% catalog %}.

Pode haver campos de dados adicionais disponíveis que são considerados metadados. Para fazer referência a uma dessas propriedades adicionais do item, o senhor pode usar a sintaxe da variável: {{ catalog_item.metadata.color }}. Nesse caso, a variável extrairá o valor "color" associado ao item armazenado nos metadados do item.

Para acessar uma visualização de todos os detalhes disponíveis armazenados em um item, incluindo todos os metadados, adicione o seguinte snippet a um bloco de texto em um modelo de teste e atualize itemID com o ID do produto de um dos produtos atuais em seu catálogo.

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

Em seguida, visualize a mensagem. Essa visualização fornece uma versão bruta de todos os dados disponíveis para seus produtos.

Além disso, se tiver vários catálogos (ou seja, se estiver sincronizando vários catálogos personalizados com a sua conta), poderá especificar de qual catálogo deseja extrair usando a tag {{ catalog_id }}. Por exemplo: 

{% catalog "womens-jewelry-bundle" integration="demandware" catalog_id="catalogID"%} {{ catalog_item.internal_id }} {% endcatalog %}

Procurar um ID de item passado com um evento

O uso de uma pesquisa de catálogo com um evento é usado principalmente nos seguintes cenários:

• Se o senhor estiver usando uma integração personalizada em que as recomendações de produtos são passadas junto com um evento para serem exibidas na mensagem. Por exemplo, uma mensagem de abandono de navegação em que recomendações exclusivas são geradas com base nos itens visualizados. Em vez de preencher o único item que o cliente visualizou na mensagem, o senhor pode gerar e preencher um conjunto de itens recomendados com base no item visualizado. Um conjunto de IDs de produto precisa ser enviado à Klaviyo junto com o evento.
• Se o senhor estiver usando uma integração personalizada e preferir não enviar todos os detalhes do produto que precisam ir em uma mensagem. Por exemplo, com uma mensagem de carrinho abandonado, envie apenas os IDs de produto de todos os itens abandonados e a Klaviyo poderá pesquisar cada um deles para obter todos os detalhes relevantes. Não é necessário que cada evento contenha o nome do produto, o preço, a imagem etc., pois tudo isso pode ser preenchido apenas passando o ID do produto para o Klaviyo e, em seguida, buscando as informações no catálogo de produtos do Klaviyo.

Ao usar uma tag {% catalog %} com um evento, a pesquisa se baseia no ID do item do catálogo (que será o ID do produto ou o SKU, dependendo da integração).

Para um evento em que o valor de identificação passado é Item ID, as tags de pesquisa aparecerão assim:

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

Dentro desse bloco {% catalog %}, adicione variáveis de modelo para os dados que o senhor gostaria de preencher em relação a cada item (ou seja título, imagem, etc.)

Por exemplo, usando os dados do item de catálogo de amostra abaixo, podemos criar um bloco {% catalog %} que faça referência às principais informações do produto:

Dados do item de catálogo:

{
  "description": "Problema padrão para todos os Klaviyos. Esta camiseta tem o logotipo da Klaviyo na frente e o diagrama da marca nas costas.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "Título": "Camiseta clássica da Klaviyo",
  "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",
  "metadados": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

Sintaxe do bloco de modelos:

A sintaxe do seguinte bloco {% catalog %} extrairia a imagem do item, o título do item e a descrição do item do seu catálogo, para cada item do 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 %}

Se a pesquisa não conseguir encontrar o item que está procurando, a mensagem será ignorada e não será enviada.

Procurar um ID de item como uma propriedade personalizada

Se o senhor estiver usando seu próprio mecanismo de recomendação, poderá passar IDs de itens recomendados para perfis no Klaviyo como uma propriedade de perfil personalizada. Usando uma tag {% catalog %}, o senhor pode fazer referência a informações de qualquer um desses produtos ao enviar mensagens a esse cliente.

Se a pesquisa não conseguir encontrar o item que está procurando, a mensagem será ignorada e não será enviada.

Sintaxe para vários IDs de itens armazenados em uma única propriedade

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

Sintaxe para um único ID de item em uma propriedade 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>

Sobre a tag has_category

Use a tag has_category para determinar se um item em seu catálogo faz parte de uma categoria específica. Ele deve ser usado em uma tag de pesquisa de catálogo para um item específico. 

Use o código de exemplo abaixo para usar essa tag, substituindo itemID por um ID de produto de seu catálogo e category_name por todo ou parte de um nome de categoria. 

{% catalog itemID %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
Estou em promoção!
{% else %}
{% endif %}
{% endcatalog %}

Este exemplo exibe o título do produto e, em seguida, verifica se o produto está em uma categoria, category_name. Se essa avaliação for verdadeira, a mensagem "Estou em promoção!" será exibida após o título do produto. 

Recursos adicionais

• Como usar feeds e recomendações de produtos
• Visão geral do editor de modelos de e-mail