Come utilizzare gli oggetti personalizzati nei modelli
Per usare questa funzionalità, devi avere accesso a oggetti personalizzati.
Cosa imparerai
Scopri come utilizzare gli oggetti personalizzati nei modelli, così puoi utilizzare i dati degli oggetti negli invii dei flussi e delle campagne.
Devi creare un oggetto prima di poter utilizzare i dati dell'oggetto personalizzato nei modelli. Per il menu di personalizzazione, i filtri degli oggetti e gli elenchi di record dei destinatari, utilizza un oggetto con una relazione con il profilo. I relativi record devono essere collegati al destinatario per apparire nel suo messaggio.
Accesso ai dati degli oggetti tramite il menu di personalizzazione
Puoi personalizzare i blocchi di testo nell’editor di modelli drag-and-drop usando le proprietà di un oggetto personalizzato oppure il numero di record per un oggetto.
Scopri come usare l'editor di modelli di Klaviyo.
Se inizi con un modello HTML, puoi prima creare una copia trascina e rilascia:
- Vai a Contenuti > Modelli, poi apri E-mail: salvate. Apri il menu con 3 puntini del tuo modello HTML e seleziona Clona in trascina e rilascia.
- Apri Modelli convertiti per verificarne l’avanzamento. Quando lo stato è Pronto per l’uso, fai clic sul nome del modello convertito per aprirlo.
- Rivedi il layout del testo e i contenuti personalizzati prima di utilizzarlo. Il modello HTML originale rimane invariato.
Per iniziare ad aggiungere i dati degli oggetti nel tuo modello:
- Aggiungi un nuovo blocco di testo o seleziona un blocco di testo esistente.
- Fai doppio clic nel blocco di testo e poi posiziona il cursore dove vuoi inserire la proprietà dinamica.
- Seleziona il pulsante Personalization nella barra degli strumenti del testo.

- Nel modale di personalizzazione, seleziona Oggetti dal menu a discesa Tutti i tipi .

- In Oggetti vedrai tutti gli oggetti nel tuo account che puoi usare per inserire dati nel modello. Seleziona l’oggetto che contiene i dati che vuoi usare nel modello.
- Seleziona una proprietà da visualizzare o Numero di oggetti per visualizzare un conteggio. Successivamente, seleziona un filtro per gli oggetti. Puoi anche creare qui un nuovo filtro per gli oggetti.
- Fai clic su Inserisci dopo aver selezionato un filtro esistente. Se crei un nuovo filtro, il suo tag viene inserito quando completi la creazione.
- Applica tutti gli stili di testo di cui hai bisogno. Per un valore di proprietà, aggiungi il testo predefinito modificando il suo tag in modo da includere
|default:'value'. Sostituiscivaluecon il testo da mostrare quando la proprietà è vuota.
Per specificare le regole di maiuscole/minuscole per i dati degli oggetti, devi impostare manualmente la regola nel tag di personalizzazione. Ad esempio, questi tag usano l’oggetto che ha attivato un flusso attivato dalla data:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Scopri di più su come modificare i valori con i filtri Django.
Accesso ai dati degli oggetti con i tag di personalizzazione
Puoi usare i tag di personalizzazione nelle e-mail (incluso l'oggetto dell'e-mail), nei messaggi SMS/MMS, nelle notifiche push e in Customer Hub per mostrare i dati degli oggetti.
Scopri come usare i tag di personalizzazione in Klaviyo.
Riferimento ai tag di personalizzazione degli oggetti
Puoi utilizzare i seguenti tag di personalizzazione con gli oggetti.
Utilizzo dell'oggetto che ha attivato un flusso
{{ object }} è disponibile solo quando un oggetto ha attivato un flusso. Il tag modello {{ object }} è disponibile solo nei flussi attivati dalla data basati su un oggetto. Questo è simile al tag modello {{ event }} per i flussi attivati da un evento.
Questi esempi utilizzano quanto segue:
- Oggetto chiamato Pet che viene referenziato con il tag object nel modello.
- Proprietà dell’oggetto chiamata Nome
Struttura | Esempio |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Recupero di un oggetto in base all'ID
Questi esempi utilizzano quanto segue:
- Oggetto chiamato Pet
- Proprietà dell’oggetto chiamata Nome
- Evento che ha attivato il flusso con una proprietà dell'oggetto chiamata pet_id. Questo campo corrisponde all'ID oggetto dell'oggetto Pet.
Struttura | Esempio |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% id_evento.oggetto_cliente object_type_title="Title" come alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
Restituisce un singolo oggetto da un filtro di oggetti
Questi esempi utilizzano quanto segue:
- Un filtro oggetto aggiuntivo chiamato oldestDog
- Proprietà dell’oggetto chiamata Nome
Struttura | Esempio |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
{{ object_filter.object_filter_name | lookup:'object_property' }} | {{ object_filter.oldestDog | lookup:'Name' }} |
Restituisce un numero intero da un filtro di oggetti
Questi esempi utilizzano quanto segue:
- Un filtro oggetto aggiuntivo chiamato countOfDogs
Struttura | Esempio |
{{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |
Restituisci più oggetti da un filtro di oggetti
Per un filtro denominato dogs configurato con Multiplo, esegui un ciclo tra i record corrispondenti per visualizzare la proprietà Nome di ogni animale domestico:
{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}
Recupera i record degli oggetti
Usa customobjects per recuperare fino a 5 record collegati al destinatario, ordinati dal più recente al più vecchio. Esegui un ciclo tra i record restituiti per visualizzarne le proprietà. Questo esempio utilizza quanto segue:
- Oggetto chiamato profilo animale domestico
- Proprietà dell'oggetto denominata name
Struttura | Esempio |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Dati dell'oggetto nelle righe dell'oggetto
Usa la stessa sintassi degli oggetti personalizzati nell'oggetto come nel corpo del messaggio. Questi esempi mostrano la sintassi per ciascuna origine dati:
{{ object_filter.oldestDog.Name }}mostra la proprietà Name del filtro a oggetto singolo oldestDog.{{ object.Name }}mostra la proprietà Name dell’oggetto che ha attivato un flusso basato sulla data.{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}Cerca un record Pet in base all’ID. Usalo in un flusso attivato da un evento che contiene pet_id.
Ad esempio, usa {{ object.Name }} in un flusso attivato da data basato sull'oggetto Pet per mostrare il nome dell'animale domestico di un cliente nell'oggetto.
Vista bozza:

Anteprima dell'e-mail:
Dati oggetto nella logica mostra/nascondi
Puoi anche configurare se mostrare o nascondere un blocco in un modello in base ai dati dell’oggetto. Usa una proprietà o un conteggio da un filtro oggetto, oppure l’oggetto che ha attivato un flusso attivato da una data. Puoi usare i dati dell’oggetto in un’unica condizione mostra/nascondi o nella condizione per ogni variante della logica mostra/nascondi. Per i dati recuperati tramite ID, usa la logica condizionale avanzata descritta di seguito.
Devi creare i filtri degli oggetti prima di poterli utilizzare nella logica mostra/nascondi.
Ad esempio, in un flusso attivato da una data basato su un oggetto Pet, usa object.Breed == 'Labrador' per mostrare un blocco solo quando la Breed dell’animale che attiva il flusso è Labrador. Usa il valore esatto della razza dai tuoi dati.
- Seleziona il blocco e apri la scheda Visualizzazione. In Logica di visualizzazione/nascondi, seleziona Mostra solo a un pubblico specifico oppure seleziona Personalizza per più pubblici per creare varianti della logica. Quindi seleziona Usa codice.
- Inserisci una condizione come
object_filter.countOfDogs > 0senza{{ }}o{% %}intorno. I filtri degli oggetti possono essere utilizzati nelle campagne e nei flussi. Usaobjectsolo in un flusso attivato da una data basato sui dati degli oggetti. - Fai clic su Salva per applicare la condizione.

Le sezioni degli oggetti personalizzati supportano la logica mostra/nascondi per un solo pubblico. Le varianti di logica non sono disponibili per loro. Scopri di più sulle varianti di logica mostra/nascondi.
Per una maggiore flessibilità (ad es., rendere alcune informazioni condizionali in base alle informazioni restituite da {% customobject %} o {% customobjects %}), valuta l’utilizzo della logica condizionale avanzata con la logica {% if ... %} direttamente in un blocco di testo.
Filtri per gli oggetti
Che cos’è un filtro per gli oggetti?
I filtri degli oggetti selezionano i record collegati a ciascun destinatario usando i criteri che imposti. Puoi visualizzare una proprietà da 1 record corrispondente, le proprietà di un massimo di 10 record corrispondenti oppure un conteggio dei record corrispondenti.
Crea un nuovo filtro per gli oggetti
Per iniziare a creare un filtro oggetto:
- Aggiungi un nuovo blocco di testo o modifica il testo in un blocco di testo esistente nel tuo modello.
- Seleziona il pulsante Personalizzazione .

- Nel modale di personalizzazione, seleziona Oggetti dal menu a discesa Tutti i tipi .
- Seleziona l'oggetto che contiene i dati per i quali vuoi impostare un filtro.
- Seleziona la proprietà che vuoi visualizzare. Per creare invece un filtro di conteggio, seleziona Numero di oggetti.
- Fai clic su Crea se non sono ancora presenti filtri. Se sono presenti filtri nell’elenco, lasciali non selezionati e fai clic su Crea filtro oggetto.
Nella finestra modale Create object filter, imposta le seguenti informazioni:
- Nome
Inserisci un nome univoco contenente solo lettere e numeri, ad esempio oldestDog. Non utilizzare spazi o caratteri speciali. - Imposta le condizioni del filtro
Definisci le regole che un oggetto deve soddisfare per essere incluso nel blocco di testo. - Quanti oggetti visualizzare?
Per un valore di proprietà, seleziona Singolo per 1 record o Multiplo per un massimo di 10 record. I filtri di conteggio non mostrano questa impostazione. - Seleziona proprietà e Ordine di ordinamento
Per un filtro proprietà-valore, scegli la proprietà usata per selezionare o ordinare i record, quindi scegli il suo ordine di ordinamento. Ad esempio, ordina in base a una proprietà compleanno con Più vecchio per selezionare prima l’animale domestico più vecchio. Questi campi non vengono visualizzati per i filtri di conteggio.

Fai clic su Crea filtro oggetto per salvare il filtro e inserire il suo tag nel blocco di testo.
Una volta creato il filtro oggetto, puoi usarlo nella logica mostra/nascondi e nei tag di personalizzazione per mostrare record di oggetti specifici in base ai criteri che hai impostato.
Risorse aggiuntive
- Primi passi con gli oggetti personalizzati
Scopri di più sugli oggetti personalizzati, che ti consentono di memorizzare e associare più proprietà a un singolo "oggetto". Gli oggetti personalizzati ti consentono di mappare diversi concetti di dati multi-relazionali in Klaviyo che non possono essere memorizzati utilizzando le proprietà del profilo. Potrai quindi utilizzare oggetti personalizzati nei tuoi messaggi, segmenti e altro ancora.
- Documentazione sulla personalizzazione dei messaggi
Scopri come utilizzare le variabili di personalizzazione (o tag) di Klaviyo per personalizzare l'esperienza dei clienti.
- Come utilizzare il pannello di anteprima per la personalizzazione dei messaggi
Scopri come usare il pannello di anteprima per capire i dati di personalizzazione disponibili per i tuoi messaggi e come accedere ai tag modello. Usa la modale di anteprima come fonte di verità per le opzioni di personalizzazione.