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.
Tenga presente che questa guida è pensata per i marketer esperti di tecnologia o per i clienti che hanno accesso a uno sviluppatore.
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 %}.
| Tag del modello | Nome | Descrizione |
|---|---|---|
{{ catalog_item.description }} |
Descrizione | La descrizione dell'articolo. |
{{ catalog_item.url }} |
URL | L'url per accedere all'articolo nel suo negozio. |
{{ catalog_item.title }} |
Titolo | Il titolo dell'articolo. |
{% currency_format catalog_item.metadata|lookup:"price" %} |
Prezzo | Il prezzo di un articolo. Questo tag formatta il prezzo dell'articolo con il prefisso di valuta corretto. |
{{ catalog_item.currency_symbol }} |
Simbolo della valuta | Il simbolo grafico utilizzato per indicare un'unità di valuta |
{{ catalog_item.currency_code }} |
Codice valuta | Il codice alfabetico utilizzato per indicare la valuta |
{{ catalog_item.featured_image.full.src }} |
Immagine completa | L'url dell'immagine completa dell'articolo. Lo utilizzi all'interno di un blocco di immagini, o di un tag <img>. |
{{ catalog_item.featured_image.thumbnail.src }} |
Miniatura | L'url dell'immagine completa dell'articolo. Lo utilizzi in un tag <img> in un HTML personalizzato, oppure lo utilizzi come URL segnaposto di un'immagine dinamica circondato dai tag di apertura e chiusura {% catalog %}. |
{{ catalog_item.id }} |
Id | L'ID prodotto dell'articolo. |
{{ catalog_id }} |
ID catalogo | L'ID del catalogo, in modo da poter specificare da quale catalogo attingere se ne ha diversi. |
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.
filtro per ID catalogo
Se hai più cataloghi puoi specificare da quale catalogo vuoi attingere utilizzando il tag {{catalog id}} tag. Ad esempio, potresti avere un catalogo sincronizzato tramite Klaviyo integrazioni come Shopify, un catalogo sincronizzato tramite API, o un feed di catalogo personalizzato. I dettagli dell'etichetta possono variare in base alla tua integrazione. Nell'esempio seguente, più cataloghi sono sincronizzati con lo stesso account Klaviyo e vogliamo estrarre una descrizione del prodotto da un prodotto specifico contenuto in un catalogo API.
Per prima cosa, trova l'ID del catalogo:
- In Klaviyo, vai su Contenuto > Prodotti.
- Seleziona il catalogo che desideri utilizzare dal menu a discesa Tutti i cataloghi.
- Copia l'ID del catalogo dall'URL.
Quindi, trova l'ID dell'articolo:
- Dopo aver selezionato il catalogo, seleziona il prodotto che vuoi utilizzare dal catalogo.
- Nella pagina dei dettagli del prodotto, vedrai l'ID dell'articolo.
Per l'esempio precedente, il codice sarà simile a quello che segue:
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935"%} {{ catalog_item.description }} {% endcatalog %}Filtro in base alla lingua
I cataloghi che tengono conto delle impostazioni internazionali, come il catalogo di Shopify in Klaviyo, possono essere cercati in base alle impostazioni internazionali. È possibile fare riferimento alla lingua e all'area geografica con il codice del Paese e della lingua a due lettere utilizzando gli standard ISO 3166 e 639. Se non è possibile trovare un prodotto localizzato, verranno utilizzate le informazioni predefinite sul prodotto.
{% catalog "SAMPLE-DATA-ITEM-15" integration="api" catalog_id="1060935" language='fr' region='CA' %} {{ catalog_item.description }} {% 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 utilizzi un tuo motore di raccomandazione, puoi passare gli ID degli articoli raccomandati al profilo in Klaviyo come Proprietà del profilo personalizzata. Utilizzando un tag {% catalog %}, puoi fare riferimento alle informazioni di uno qualsiasi di questi prodotti quando invii un messaggio 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.
Il tag has_category cerca le corrispondenze complete e parziali con il nome della categoria da lei impostato. Per esempio, se utilizza "sale" come nome della categoria e un prodotto ha un tag "on-sale", il tag has_category valuterà come vero per quel prodotto.