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.
Tieni presente che questa guida è pensata per professionisti del marketing con competenze tecniche o clienti che hanno accesso a uno sviluppatore.
Il tag {% catalog %}
Il tag {% catalog %} utilizza la seguente sintassi:
{% catalog itemID unpublished="cancel" %}
...
{% endcatalog %}Sostituisci itemID con l'ID prodotto del prodotto a cui ti riferisci. Questo è l'ID prodotto sincronizzato dal tuo catalogo prodotti. Nota: questa ricerca è specifica per l'ID prodotto e non per lo SKU.
Includere unpublished="cancel" garantirà che il tuo messaggio non venga inviato nel caso in cui l’articolo a cui si fa riferimento venga annullato. Questo argomento è facoltativo.
- Se un articolo a cui fai riferimento nel messaggio non è pubblicato nel tuo catalogo al momento della ricerca, l'intero messaggio verrà ignorato.
- Per un determinato messaggio del flusso, puoi andare su Analisi > Attività destinatari > Altro e vedere un elenco etichettato Saltati: articolo del catalogo non disponibile. Questo elenco include tutti i profili che sono stati saltati perché un articolo presentato nel messaggio era esaurito o altrimenti non disponibile.
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 %}.
Tag modello | Nome | Descrizione |
|---|---|---|
| Descrizione | La descrizione dell’articolo. |
| URL | L’URL per accedere all’articolo nel tuo negozio. |
| Titolo | Il titolo dell’articolo. |
| Prezzo | Il prezzo di un articolo. Questo tag formatta il prezzo dell’articolo con il prefisso di valuta corretto. |
| Simbolo della valuta | Il simbolo grafico utilizzato per indicare un'unità di valuta |
| Codice valuta | Il codice alfabetico utilizzato per indicare la valuta |
| Immagine completa | L’URL dell’immagine completa dell’articolo. Usalo all’interno di un blocco immagine o di un tag <img>. |
| Anteprima | L’URL dell’immagine completa dell’articolo. Usalo in un tag <img> nell’HTML personalizzato oppure usalo come URL segnaposto dell’immagine dinamica, racchiuso tra i tag di apertura e chiusura {% catalog %} |
| ID | L'ID prodotto dell'articolo. |
| ID catalogo | L’ID del catalogo, così puoi specificare da quale catalogo estrarre i dati se ne hai più di uno. |
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 memorizzati su un articolo, inclusi tutti i metadati, aggiungi il seguente snippet a un blocco di testo in un modello di test e aggiorna itemID con l'ID prodotto 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, puoi specificare da quale catalogo vuoi recuperare i dati usando il tag {{catalog id}}. Ad esempio, potresti avere un catalogo sincronizzato tramite un'integrazione Klaviyo come Shopify, un catalogo sincronizzato tramite API o un feed di catalogo personalizzato. I dettagli dei tag possono variare in base alla tua integrazione. Nell'esempio seguente, più cataloghi sono sincronizzati con lo stesso account Klaviyo e vogliamo recuperare 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 vuoi usare dal menu a discesa Tutti i cataloghi.
- Copia l’ID del catalogo dall’URL.
Poi, trova l'ID dell'articolo:
- Dopo aver selezionato il catalogo, seleziona il prodotto che vuoi usare dal catalogo.
- 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 %}Filtro per impostazioni locali
Puoi cercare i cataloghi localizzati, come il catalogo Shopify in Klaviyo, in base alle impostazioni internazionali. Puoi fare riferimento alla lingua e alla regione delle impostazioni internazionali con un codice paese e lingua di due lettere, usando gli standard ISO 3166 e 639. Se non è possibile trovare un prodotto localizzato, verranno usate le informazioni predefinite del prodotto.
{% 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 usi un’integrazione personalizzata e preferisci non inviare tutti i dettagli del prodotto che devono essere inseriti in un messaggio. Ad esempio, con un messaggio per il carrello abbandonato, invia solo gli ID prodotto di tutti gli articoli abbandonati e Klaviyo può cercare ciascuno di essi per recuperare tutti i dettagli pertinenti. Non è necessario che ogni evento contenga nome del prodotto, prezzo, immagine e così via, perché tutto questo può essere compilato passando solo l’ID prodotto a Klaviyo, quindi cercando le informazioni nel tuo catalogo prodotti di 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 compilare per ciascun articolo (ad es. titolo, immagine, ecc.)
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:
La sintassi per il seguente blocco {% catalog %} importerà l'immagine dell'articolo, il titolo dell'articolo e la descrizione dell'articolo dal tuo catalogo, per ciascun articolo nell'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 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à
{% 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
{% 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.
Il tag has_category cerca corrispondenze complete e parziali con il nome della categoria che hai impostato. Ad esempio, se utilizzi “sale” come nome della categoria e un prodotto ha un tag “on-sale”, il tag has_category verrà valutato come true per quel prodotto.
Risorse aggiuntive
- Come utilizzare i feed e le raccomandazioni sui prodotti
Scopra come creare un feed di prodotti in Klaviyo per utilizzare le raccomandazioni di prodotti nella sua messaggistica. I feed di prodotto raccolgono i dati del suo catalogo di prodotti e del comportamento dei clienti (ad esempio, i prodotti che hanno visualizzato o acquistato in passato) e utilizzano queste informazioni per fornire raccomandazioni di prodotti personalizzate ai suoi abbonati.