Riferimento ai tag per la ricerca nel catalogo

Cosa imparerai

Scopri come utilizzare il tag catalogo, che ti consente di fare riferimento a informazioni specifiche sui prodotti del tuo catalogo all’interno delle tue e-mail, SMS e notifiche push. È utile quando vuoi creare consigli personalizzati sui prodotti o mettere in relazione informazioni sui prodotti. Ad esempio, se utilizzi un motore di consigli personalizzato, puoi passare i tuoi consigli sui prodotti come dati di evento o dati del profilo a Klaviyo e poi utilizzare questi dati nei modelli.

Il tag {% catalog %}

Il tag {% catalog %} utilizza la seguente sintassi:

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

Sostituisci itemID con l’ ID articolo mostrato nella pagina dei dettagli del prodotto in Klaviyo. Il valore deve corrispondere all’ID articolo archiviato nel tuo catalogo; usa uno SKU solo se è anche l’ID articolo del catalogo. Mantieni le virgolette intorno a un ID letterale. Quando usi una variabile di evento o di profilo, lascia la variabile senza virgolette, come mostrato negli esempi qui sotto.

Includere unpublished="cancel" impedisce l'invio del messaggio se l'elemento a cui fa riferimento non è pubblicato nel tuo catalogo Klaviyo. Questo argomento è facoltativo. Senza, un elemento non pubblicato può comunque apparire nel messaggio.

• Se una ricerca che usa unpublished="cancel" trova un elemento non pubblicato al momento della ricerca, l’intero messaggio viene saltato per quel destinatario.
• Per un messaggio in un flusso, apri le sue analisi e seleziona Attività del destinatario > Saltati. Nel menu a discesa Tipo, seleziona Saltato: articolo del catalogo non disponibile. Questo elenco include i profili i cui messaggi sono stati saltati perché non è stato possibile trovare un articolo a cui si fa riferimento o perché è stato cercato un articolo non pubblicato con unpublished="cancel". Un articolo potrebbe non essere pubblicato perché è esaurito o altrimenti non disponibile nel tuo catalogo.

Quando usi questa funzionalità, tra i tag del catalogo di apertura e di chiusura, puoi fare riferimento a dati specifici dell’articolo associato all’ itemID nel tuo catalogo prodotti Klaviyo.

I seguenti dati sono disponibili come riferimento all’interno di un blocco {% catalog %}.

Potrebbero essere disponibili campi dati aggiuntivi considerati metadati. Per fare riferimento a una di queste proprietà aggiuntive dell’articolo, puoi usare la sintassi delle variabili: {{ catalog_item.metadata.color }}. In questo caso, la variabile recupererà il valore "color" associato all’articolo, memorizzato nei metadati dell’articolo.

Per accedere a un’anteprima di tutti i dettagli disponibili archiviati in un elemento, inclusi tutti i metadati, aggiungi il seguente snippet a un blocco di testo in un modello di test e aggiorna itemID con l’ID elemento di uno dei prodotti attuali nel tuo catalogo.

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

Quindi, visualizza l'anteprima del messaggio. Questa anteprima fornisce una versione non elaborata di tutti i dati disponibili per i tuoi prodotti.

Filtraggio per ID del catalogo

Se hai più cataloghi, usa l'argomento catalog_id nel tag {% catalog %} di apertura per specificare un catalogo. Devi anche includere integration, con entrambi i valori tra virgolette. Ad esempio, potresti avere un catalogo sincronizzato tramite un'integrazione Klaviyo come Shopify, un catalogo sincronizzato tramite API o un feed catalogo personalizzato. Il valore dell'integrazione deve corrispondere all'origine del catalogo. L'esempio seguente usa integration="api" per recuperare una descrizione del prodotto da un catalogo API.

Per prima cosa, trova l’ID del catalogo:

1. In Klaviyo, vai su Contenuto > Prodotti.
2. Usa il filtro Opzioni catalogo per selezionare il catalogo che vuoi utilizzare. La selezione predefinita è Tutti i cataloghi.

3. Copia l’ID del catalogo dall’URL.
   

Poi, trova l'ID dell'articolo:

1. Dopo aver selezionato il catalogo, seleziona il prodotto che vuoi usare dal catalogo.
2. Nella pagina dei dettagli del prodotto, vedrai l'ID articolo.
   

Per l’esempio sopra, il codice sarebbe simile a questo:

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

Sostituisci l'ID dell'articolo di esempio e l'ID del catalogo con i tuoi valori, quindi visualizza l'anteprima del messaggio e verifica che mostri i dettagli del prodotto previsti. Se la ricerca non trova una corrispondenza nel catalogo che specifichi, può ripiegare su un altro catalogo nel tuo account.

Filtro per impostazioni locali

Se il tuo catalogo contiene dati di prodotto localizzati, ad esempio un catalogo Shopify con dati localizzati sincronizzati con Klaviyo, puoi cercare un prodotto per locale. Includi sia la lingua sia la regione, usando codici di lingua e paese a 2 lettere tratti rispettivamente da ISO 639 e ISO 3166. Ad esempio, language='fr' e region='CA' richiedono i dati di prodotto in francese per il Canada. Se non è possibile trovare un prodotto localizzato, vengono usate le informazioni di prodotto predefinite.

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

Cerca un ID articolo passato con un evento.

L’uso di una ricerca nel catalogo con un evento viene usato soprattutto negli scenari seguenti:

• Se utilizzi un’integrazione personalizzata in cui i consigli sui prodotti vengono passati insieme a un evento per essere mostrati nel messaggio. Ad esempio, un messaggio di abbandono della navigazione in cui vengono generati consigli univoci in base agli articoli visualizzati. Invece di inserire nel messaggio il singolo articolo visualizzato da un cliente, puoi generare e inserire un insieme di articoli consigliati basati su quell’articolo visualizzato. Devi inviare a Klaviyo un insieme di ID prodotto insieme all’evento.
• Se stai utilizzando un’integrazione personalizzata e preferisci non inviare tutti i dettagli del prodotto che devono essere inclusi in un messaggio. Ad esempio, con un messaggio per carrello abbandonato, invia solo i Product IDs di tutti gli articoli abbandonati e Klaviyo può cercarli per recuperare tutti i dettagli pertinenti. Non è necessario che ogni evento contenga nome del prodotto, prezzo, immagine, ecc., dato che puoi valorizzare tutto questo passando solo il Product ID a Klaviyo e poi cercando le informazioni nel tuo catalogo prodotti Klaviyo.

Quando utilizzi un tag {% catalog %} con un evento, la ricerca si basa sull'ID articolo dell'articolo del catalogo (che sarà l'ID prodotto o lo SKU a seconda dell'integrazione).

Per un evento in cui il valore identificativo passato è l'ID articolo, i tag di ricerca appariranno così:

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

All'interno di questo blocco {% catalog %}, aggiungi tag modello per i dati che vuoi popolare per ciascun elemento (ad esempio titolo o immagine).

Ad esempio, utilizzando i dati di esempio dell'articolo del catalogo riportati di seguito, possiamo creare un blocco {% catalog %} che fa riferimento alle principali informazioni sul prodotto:

Dati degli articoli del catalogo:

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

Sintassi del blocco del modello:

Il seguente esempio HTML richiama l'immagine, il titolo e la descrizione dell'articolo per ogni articolo in event.Items. Presuppone che ogni articolo abbia un valore SKU che corrisponde all'ID articolo nel tuo catalogo Klaviyo. Se il tuo evento utilizza una proprietà diversa per l'ID articolo del catalogo, sostituisci item.SKU con quella proprietà. Usa gli esempi HTML in un'e-mail; per SMS o push, usa i tag del catalogo con campi di testo anziché markup HTML.

{% 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 la ricerca non riesce a trovare l’articolo che sta cercando, il messaggio viene saltato e non viene inviato.

Cerca l’ID di un articolo come proprietà personalizzata

Se utilizzi un tuo motore di consigli, puoi passare gli ID articolo consigliati ai profili in Klaviyo come proprietà del profilo personalizzata. Utilizzando un tag {% catalog %}, puoi fare riferimento alle informazioni di uno qualsiasi di questi prodotti quando invii messaggi a questo cliente.

Se la ricerca non riesce a trovare l’articolo che sta cercando, il messaggio viene saltato e non viene inviato.

Sintassi per più ID articolo archiviati in una singola proprietà

Archivia Recommended Products come elenco di ID articolo, ad esempio ["KLAVIYO-TSHIRT", "KLAVIYO-HAT"]. Sostituisci questi ID di esempio con gli ID del tuo catalogo e sostituisci il nome della proprietà nel codice se il tuo è diverso.

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

Sintassi per un singolo ID articolo in una Proprietà del profilo

Archivia un singolo ID articolo come valore di testo in Recommended Products, ad esempio KLAVIYO-TSHIRT. Usa il nome della proprietà e l'ID articolo del tuo account.

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

Informazioni sul tag has_category

Usa il tag has_category per determinare se un articolo nel tuo catalogo fa parte di una categoria specifica. Deve essere utilizzato all'interno di un tag di ricerca nel catalogo per un articolo specifico.

Usa il codice di esempio qui sotto per usare questo tag, sostituendo itemID con un ID prodotto dal tuo catalogo e category_name con tutto o parte del nome di una categoria.

{% catalog "itemID" %}
{{ catalog_item.title }}
{% has_category catalog_item "category_name" as in_category %}
{% if in_category %}
I am on sale!
{% else %}
{% endif %}
{% endcatalog %}

Questo esempio mostra il titolo del prodotto, quindi verifica se il prodotto rientra in una categoria, category_name. Se questa condizione viene valutata come true, il messaggio "Sono in saldo!" verrà visualizzato dopo il titolo del prodotto.

Risorse aggiuntive