Come utilizzare gli oggetti personalizzati nei modelli

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 prima creare un oggetto prima di poter utilizzare i dati dell'oggetto personalizzato nei modelli.

Accesso ai dati degli oggetti tramite il menu di personalizzazione

Puoi personalizzare i blocchi di testo nell'editor di modelli usando le proprietà di un oggetto personalizzato o il conteggio dei record per un oggetto.

Scopri come usare l'editor di modelli di Klaviyo.

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

1. Aggiungi un nuovo blocco di testo o seleziona un blocco di testo esistente.
2. Fai doppio clic nel blocco di testo, poi posiziona il cursore dove vuoi inserire la tua proprietà dinamica.
3. Seleziona il pulsante Personalizzazione in alto a destra.

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

5. 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.
6. Seleziona la proprietà dell'oggetto specifica o filtro oggetto da includere nel modello. Qui puoi anche creare un nuovo filtro oggetto.
7. Imposta il testo predefinito e qualsiasi stile per il tuo testo.

Per specificare le regole di maiuscole e minuscole per i dati degli oggetti, devi impostare manualmente la regola nel tag di personalizzazione. Per esempio:

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

Questi esempi utilizzano quanto segue:

• Oggetto chiamato Pet che viene referenziato con il tag object nel modello. 
• Proprietà dell’oggetto chiamata Nome

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.

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

Restituisce un numero intero da un filtro di oggetti

Questi esempi utilizzano quanto segue:

• Un filtro oggetto aggiuntivo chiamato count_of_dogs

Recupera i record degli oggetti

Per recuperare i record dell'oggetto più recenti per un oggetto, dovrai eseguire un loop su tutti i record dell'oggetto. Questo esempio usa quanto segue:

• Oggetto denominato Animali domestici

Dati dell'oggetto nelle righe dell'oggetto

Puoi personalizzare l'oggetto con qualsiasi tag di oggetto personalizzato:

• {% object_filter %}
• {% object %}
• {% customobject %}

Ad esempio, puoi usare il tag {% object %} nell’oggetto del tuo messaggio per visualizzare direttamente il nome dell’animale domestico di un cliente.

Vista bozza:

Anteprima dell'e-mail:

Dati oggetto nella logica mostra/nascondi

Puoi anche configurare se mostrare o nascondere il blocco in un modello in base ai dati degli oggetti. La visualizzazione o la nascosta dinamica di un blocco in base ai dati degli oggetti usa gli stessi tag del generatore di modelli. Puoi fare riferimento agli oggetti per ID, alle proprietà dai filtri degli oggetti o agli aggregati dai filtri degli oggetti.

Ad esempio, se hai un oggetto Pet con una proprietà chiamata Breed, puoi scegliere di mostrare un blocco solo ai proprietari di animali con una determinata razza di cane usando la condizione object.Breed .

Per impostare la logica di mostra/nascondi, fai clic sul blocco per cui vuoi impostare le regole e seleziona Usa codice nella scheda Visualizzazione.

Inserisci la condizione direttamente nell'editor di codice. Puoi utilizzare i filtri oggetto e il tag modello oggetto se si tratta di un messaggio per un flusso attivato da una data basato sui dati dell'oggetto.

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 ti consentono di limitare i record degli oggetti restituiti in base a criteri specifici che imposti, così puoi visualizzare i record di un determinato tipo.

Crea un nuovo filtro per gli oggetti

Per iniziare a creare un filtro oggetto:

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

3. All'interno del modello di personalizzazione, seleziona Oggetti dal menu a discesa Tutti i tipi .
4. Seleziona l'oggetto che contiene i dati per i quali vuoi impostare un filtro.
5. Seleziona la proprietà dell'oggetto per cui vuoi impostare un filtro.
6. Seleziona Crea nuovo filtro.

Nella finestra modale Create object filter, imposta le seguenti informazioni:

• Nome
  Crea un nome per il filtro oggetto.
• Condizioni del filtro
  Definisci 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 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