Come utilizzare gli oggetti personalizzati nel modello

Tempo di lettura stimato 5 in minuti
|
Ultimo aggiornamento: 31 mar 2025, 15:55 EST
Cosa imparerai

Cosa imparerai

Impara a utilizzare gli oggetti personalizzati nel modello, in modo da poter utilizzare i dati degli oggetti in Flusso e nelle spedizioni di campagna.

È necessario creare un oggetto prima di poter utilizzare i dati dell'oggetto personalizzato nel modello.

Accesso ai dati dell'oggetto attraverso il menu di personalizzazione 

Accesso ai dati dell'oggetto attraverso il menu di personalizzazione 

Puoi personalizzare il blocco del testo nell'editor di modelli utilizzando le proprietà di un oggetto personalizzato o il conteggio dei record di un oggetto.

Scopri come utilizzare l'editor di modelli di Klaviyo

Per iniziare ad aggiungere i dati degli oggetti al tuo modello:

  1. Aggiungi un nuovo blocco di testo o modifica il testo di un blocco di testo esistente nel tuo modello. 
  2. Seleziona il pulsante Personalizzazione in alto a destra. 

  1. Nella maschera di personalizzazione, seleziona Oggetti dal menu a tendina Tutti i tipi .

  1. All'interno di Oggetti, vedrai tutti gli oggetti del tuo account che puoi utilizzare per inserire i dati nel modello. Seleziona l'oggetto che contiene i dati che desideri utilizzare nel modello. 
  2. Seleziona la proprietà specifica dell'oggetto o il filtro dell'oggetto da includere nel modello. Qui puoi anche creare un nuovo filtro per gli oggetti.
  3. Imposta il testo predefinito e gli stili per il tuo testo.

Per specificare le regole di capitalizzazione per i dati degli oggetti, dovrai impostare manualmente la regola nel modello tag. Ad esempio: 

  • {{ object.full_name|title|default:'value' }}
    Sconosciuto 
  • {{ object.full_name|upper|default:'value' }}
    JOHN DOE
  • {{ object.full_name|lower|default:'value' }}
    sconosciuto 

Scopri di più sulla modifica dei valori con Django filtro. 

Accesso ai dati dell'oggetto con il tag modello

Accesso ai dati dell'oggetto con il tag modello

Puoi utilizzare il tag modello nelle e-mail (compreso l'oggetto dell'e-mail), nei messaggi SMS/MMS, nelle notifiche push e in Klaviyo Customer Hub per visualizzare i dati dell'oggetto.

Scopri come utilizzare il tag modello in Klaviyo

Oggetto tag modello di riferimento

Puoi utilizzare il seguente modello di tag con gli oggetti.

Utilizza l'oggetto che ha innescato un Flusso

Questi esempi utilizzano quanto segue:

  • L'oggetto chiamato Pet è un riferimento al tag object del modello.  
  • Proprietà dell'oggetto chiamata Nome
StrutturaEsempio
{{ object.object_property }}{{ object.Name }}
{{ object | lookup:'object_property' }}{{ object | lookup:'Name' }}

Ottenere un oggetto per ID

Questi esempi utilizzano quanto segue:

  • Oggetto chiamato Animale domestico
  • Proprietà dell'oggetto chiamata Nome
  • Evento che ha attivato il Flusso con una proprietà dell'oggetto chiamata pet_id. Questo campo corrisponde all'ID dell'oggetto Pet.
Struttura Esempio

{% get_object id={{ event.object_id }} as alias %}
{{ alias.object_property }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{ pet.Name }}
{% endget_object %}

{% get_object id={{ event.object_id }} as alias %}
{{ alias | lookup:'object_property' }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{{ pet | lookup:'Name' }}
{% endget_object %}

Restituisce un singolo oggetto da un filtro di oggetti 

Questi esempi utilizzano quanto segue:

  • Un filtro oggetto aggiuntivo chiamato oldest_dog
  • Proprietà dell'oggetto chiamata Nome
StrutturaEsempio

{{ object_filter.object_filter_name.object_property}}

{{ object_filter.oldest_dog.Name }}
{{ object_filter.object_filter_name | lookup: 'object_property' }}{{ object_filter.oldest_dog | lookup: 'Name' }}

Restituisce un conteggio

Questi esempi utilizzano quanto segue:

  • Oggetto chiamato Animale domestico
  • Un filtro oggetto chiamato count_of_pets (conta animali)
StrutturaEsempio
{{ object.object_filter }}{{ Pet.count_of_pets }}
{{ object | lookup:'object_filter' }}{{ Pet | lookup:'count_of_pets' }}

Restituisce un conteggio da un filtro di oggetti 

Questi esempi utilizzano quanto segue:

  • Un filtro oggetto aggiuntivo chiamato count_of_dogs (conta_cani)
StrutturaEsempio
{{ object_filter.object_filter_name }}{{ object_filter.count_of_dogs }}

 

Dati dell'oggetto nella logica di mostra/nascondi

Dati dell'oggetto nella logica di mostra/nascondi

Puoi anche configurare se mostrare o nascondere i blocchi in un modello in base ai dati dell'oggetto. Mostrare o nascondere dinamicamente un blocco in base ai dati dell'oggetto utilizza lo stesso tag del generatore di modelli. Puoi fare riferimento agli oggetti tramite ID, proprietà dal filtro degli oggetti o aggregati dal filtro degli oggetti.

Ad esempio, se hai un oggetto Pet con una proprietà chiamata Breed, puoi scegliere di mostrare un blocco solo ai proprietari di cani di una certa razza utilizzando la condizione object.Breed.  

Per impostare la logica di mostra/nascondi, clicca sul blocco per il quale desideri impostare le regole e seleziona Usa codice nella scheda Visualizza

Inserisci la condizione direttamente nell'editor di codice. 

Oggetto filtro

Oggetto filtro

Che cos'è un filtro oggetto?

Che cos'è un filtro oggetto?

Il filtro oggetti ti permette di limitare i record degli oggetti restituiti in base a criteri specifici che hai impostato, in modo da poter visualizzare i record di un certo tipo. 

Crea un nuovo filtro oggetto

Crea un nuovo filtro oggetto

Per iniziare a creare un filtro oggetto:

  1. Aggiungi un nuovo blocco di testo o modifica il testo di un blocco di testo esistente nel tuo modello. 
  2. Seleziona il pulsante Personalizzazione

  1. Nel modello di personalizzazione, seleziona Oggetti dal menu a tendina Tutti i tipi
  2. Seleziona l'oggetto che contiene i dati per i quali desideri impostare un filtro. 
  3. Seleziona la proprietà dell'oggetto per la quale desideri impostare un filtro. 
  4. Seleziona Crea nuovo filtro

Nella finestra di dialogo Crea filtro oggetto, imposta le seguenti informazioni: 

  • Nome
    Crea un nome per il tuo filtro oggetto.
  • Condizioni di filtro
    Definisce le regole che un oggetto deve rispettare per essere incluso nel blocco di testo. 
  • Comportamento quando più record soddisfano le condizioni
    Definisci il comportamento per i casi in cui più record soddisfano le condizioni.

Una volta creato il filtro degli oggetti, puoi utilizzarlo nella logica di mostra/nascondi e nel modello dei tag per visualizzare record di oggetti specifici in base ai criteri che hai impostato. 

Risorse aggiuntive 

Risorse aggiuntive 

Primi passi con gli oggetti

Riferimento alla personalizzazione del messaggio

Come utilizzare il pannello di anteprima per la personalizzazione dei messaggi

Questo articolo è stato utile?
Usa questo modulo solo per il feedback sull'articolo. Scopri come contattare l'assistenza.

Esplora altri contenuti di Klaviyo

Community
Connettiti con altre aziende simili, partner ed esperti di Klaviyo per trovare ispirazione, condividere approfondimenti e ottenere risposte a tutte le tue domande.
Formazione dal vivo
Partecipa a una sessione dal vivo con gli esperti di Klaviyo per conoscere le linee guida consigliate, scoprire come configurare le funzionalità chiave e altro ancora.
Assistenza

Accedi all'assistenza tramite il tuo account.

Assistenza via e-mail (prova gratuita e account a pagamento) Disponibile 24 ore su 24, 7 giorni su 7

Chat/assistente virtuale
La disponibilità può variare in base alla località e al tipo di piano