Per utilizzare questa funzionalità devi avere accesso agli oggetti personalizzati.
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 personalizzazioneAccesso 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:
- Aggiungi un nuovo blocco di testo o modifica il testo di un blocco di testo esistente nel tuo modello.
- Seleziona il pulsante Personalizzazione in alto a destra.
- Nella maschera di personalizzazione, seleziona Oggetti dal menu a tendina Tutti i tipi .
- 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.
- 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.
- 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 modelloAccesso 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 riferimentoOggetto tag modello di riferimento
Puoi utilizzare il seguente modello di tag con gli oggetti.
Utilizza l'oggetto che ha innescato un Flusso
{{ object }} è disponibile solo quando un oggetto ha attivato un Flusso. Il modello {{ object }} tag è disponibile solo nella versione con data di attivazione Flusso basata su un oggetto. Questo è simile al modello {{ event }} tag per il Flusso attivato dagli eventi.
Questi esempi utilizzano quanto segue:
- L'oggetto chiamato Pet , a cui si fa riferimento 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' }} |
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 |
|
{% customobject {{ event.object_id }} object_type_title="Title" come alias %} |
{% customobject {{ event.pet_id }} object_type_title="Pet" as pet %} |
|
{% customobject {{ event.object_id }} 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 oldest_dog
- Proprietà dell'oggetto chiamata Nome
| Struttura | Esempio |
|
{{ 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 numero intero da un filtro oggetto
Questi esempi utilizzano quanto segue:
- Un filtro oggetto aggiuntivo chiamato count_of_dogs (conta_cani)
| Struttura | Esempio |
| {{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Recupera tutti i record degli oggetti
Per recuperare tutti i record di un oggetto, dovrai eseguire un ciclo di tutti i record dell'oggetto. Questo esempio utilizza quanto segue:
- Oggetto chiamato Animali domestici
| Struttura | Esempio |
| {% customobjects object_type_title="Title" as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} |
{% customobjects object_type_title="Pet Profile" as pets %} |
Oggetti dati in oggetto
Puoi personalizzare il tuo oggetto con uno dei tag personalizzati:
- {% object_filter %}
- {% object %}
- {% customobject %}
Ad esempio, puoi utilizzare il tag {% object %} nell'oggetto del tuo messaggio per visualizzare direttamente il nome dell'animale domestico di un cliente.
Vista della bozza:
Email anteprima:
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.
È necessario creare un filtro per gli oggetti prima di poterli referenziare nella logica di mostra/nascondi.
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. Puoi utilizzare l'oggetto filtro e l'oggetto tag modello se si tratta di un messaggio per un Flusso attivato dalla data basato sui dati dell'oggetto.
Per una maggiore flessibilità (ad esempio, per condizionare alcune informazioni alle informazioni restituite da {% customobject %} o {% customobjects %}), considera l'utilizzo di una logica condizionale avanzata con la logica di {% if … %} direttamente in un blocco di testo.
Oggetto filtroOggetto 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 oggettoCrea un nuovo filtro oggetto
Per iniziare a creare un filtro oggetto:
- Aggiungi un nuovo blocco di testo o modifica il testo di un blocco di testo esistente nel tuo modello.
- Seleziona il pulsante Personalizzazione .
- Nel modello di personalizzazione, seleziona Oggetti dal menu a tendina Tutti i tipi .
- Seleziona l'oggetto che contiene i dati per i quali desideri impostare un filtro.
- Seleziona la proprietà dell'oggetto per la quale desideri impostare un filtro.
- 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 aggiuntiveRisorse aggiuntive
Riferimento alla personalizzazione del messaggio
Come utilizzare il pannello di anteprima per la personalizzazione dei messaggi