Riferimento del tag di ricerca del catalogo

Imparerai

Impara a usare il tag catalogo, che ti permette di fare riferimento a informazioni specifiche sui prodotti del tuo catalogo all'interno di e-mail, SMS e messaggi push. Questo è utile quando vuoi creare consigli personalizzati sui prodotti o fare riferimenti incrociati alle informazioni sui prodotti. Ad esempio, se utilizzi il tuo motore di raccomandazione, puoi passare i tuoi consigli sui prodotti come eventi o dati del profilo a Klaviyo e poi utilizzare questi dati nel modello.

Il tag {% catalog %}

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

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

Sostituisca itemID con l'ID prodotto del prodotto a cui sta facendo riferimento. Si tratta dell'ID prodotto sincronizzato dal suo catalogo prodotti. Si noti che questa ricerca riguarda specificamente l'ID prodotto e non la SKU.

Includendo unpublished="cancel" si assicurerà di non inviare il messaggio nel caso in cui l'articolo a cui fa riferimento non sia pubblicato. Questo argomento è facoltativo. 

• Se un articolo a cui fa riferimento il suo messaggio non è pubblicato nel suo catalogo al momento della ricerca, l'intero messaggio verrà saltato.
• Per un determinato messaggio di flusso, può navigare in Analytics > Attività del destinatario > Altro e vedere un elenco con la dicitura Saltato: Oggetto del catalogo non disponibile. Questo elenco comprende tutti i profili che sono stati saltati perché un articolo presentato nel messaggio era esaurito o comunque non disponibile.

Quando utilizza questa funzione, tra i tag di apertura e chiusura del catalogo, può fare riferimento a dati specifici dell'articolo associato all'itemID nel suo catalogo prodotti Klaviyo.

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

Potrebbero essere disponibili altri campi di dati che sono considerati metadati. Per fare riferimento ad una di queste proprietà aggiuntive dell'articolo, può utilizzare la sintassi della variabile: {{ catalog_item.metadata.color }}. In questo caso, la variabile inserirà il valore "color" associato all'articolo memorizzato nei metadati dell'articolo.

Per accedere ad un'anteprima di tutti i dettagli disponibili memorizzati su un articolo - compresi tutti i metadati - aggiunga il seguente snippet ad un blocco di testo in un modello di prova e aggiorni itemID con l'ID prodotto di uno dei prodotti attuali del suo catalogo.

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

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

Inoltre, se dispone di più cataloghi (ad esempio, sta sincronizzando più cataloghi personalizzati sul suo account), può specificare da quale catalogo vuole attingere utilizzando il tag {{ catalog_id }}. Per esempio: 

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

Cerchi l'ID di un articolo passato con un evento

L'utilizzo di una ricerca di catalogo con un evento è utilizzato soprattutto nei seguenti scenari:

• Se sta utilizzando un'integrazione personalizzata in cui le raccomandazioni sui prodotti vengono trasmesse insieme a un evento da mostrare nel messaggio. Ad esempio, un messaggio di abbandono della navigazione in cui vengono generate raccomandazioni uniche in base agli articoli visualizzati. Invece di inserire nel messaggio il singolo articolo visualizzato dal cliente, può generare e inserire un insieme di articoli consigliati in base all'articolo visualizzato. È necessario inviare a Klaviyo una serie di ID prodotto insieme all'evento.
• Se sta utilizzando un'integrazione personalizzata e preferisce non inviare tutti i dettagli del prodotto che devono essere inviati in un messaggio. Per esempio, con un messaggio di carrello abbandonato, invii solo gli ID prodotto di tutti gli articoli abbandonati e Klaviyo potrà cercare ognuno di essi per ottenere tutti i dettagli rilevanti. Non è necessario che ogni evento contenga il nome del prodotto, il prezzo, l'immagine, ecc. poiché tutto questo può essere popolato solo passando l'ID del prodotto a Klaviyo, per poi cercare le informazioni nel catalogo prodotti di Klaviyo.

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

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

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

All'interno di questo blocco {% catalog %}, aggiunga delle variabili modello per i dati che desidera popolare in relazione a ciascun articolo (ad es. titolo, immagine, ecc.)

Ad esempio, utilizzando i dati degli articoli del catalogo campione qui sotto, possiamo creare un blocco {% catalog %} che fa riferimento alle informazioni chiave del prodotto:

Dati dell'articolo del catalogo:

{
  "descrizione": "Edizione standard per tutti i Klaviyos. Questa t-shirt presenta il logo Klaviyo sul davanti e il diagramma dei marchi sul retro.",
  "url": "https://klaviyogear.myshopify.com/collections/klaviyo-classics/products/short-sleeve-t-shirt-1",
  "titolo": "Maglietta classica di Klaviyo",
  "featured_image": {
   "full": {
      "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",
  "metadati": {
    "Color": "Grey",
    "Design": "Standard"
  }
}

Sintassi del blocco template:

La sintassi per il seguente blocco {% catalog %} preleverebbe l'immagine dell'articolo, il titolo dell'articolo e la descrizione dell'articolo dal suo catalogo, per ogni articolo dell'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 il lookup non trova l'elemento che sta cercando, il messaggio viene saltato e non viene inviato.

Cerchi l'ID di un articolo come proprietà personalizzata

Se utilizza il suo motore di raccomandazione, può passare gli ID degli articoli raccomandati ai profili in Klaviyo come proprietà personalizzata del profilo. Utilizzando un tag {% catalog %}, può fare riferimento alle informazioni di uno qualsiasi di questi prodotti quando invia messaggi a questo cliente.

Se il lookup non trova l'elemento che sta cercando, il messaggio viene saltato e non viene inviato.

Sintassi per gli ID multipli degli articoli memorizzati in una singola proprietà

{% 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 l'ID di un singolo articolo in una proprietà del profilo

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

Utilizzi il tag has_category per determinare se un articolo del suo catalogo fa parte di una determinata categoria. Deve essere utilizzato all'interno di un tag di ricerca del catalogo per un determinato articolo. 

Utilizzi il codice di esempio qui sotto per utilizzare questo tag, sostituendo itemID con un ID prodotto del suo 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 %}
Sono in saldo!
{% else %}
{% endif %}
{% endcatalog %}

Questo esempio visualizza il titolo del prodotto, quindi verifica se il prodotto si trova in una categoria, nome_categoria. Se la valutazione è vera, il messaggio "Sono in vendita!" apparirà dopo il titolo del prodotto. 

Risorse aggiuntive

• Come utilizzare i feed e le raccomandazioni sui prodotti
• Panoramica dell'editor di modelli e-mail