Domande frequenti sugli oggetti personalizzati

Cosa imparerai

Scopri le domande frequenti sugli oggetti personalizzati in Klaviyo. Se non trovi la tua domanda nella risorsa qui sotto, contattaci sul nostro forum della Community.

Domande generali sugli oggetti

Ho bisogno di uno sviluppatore per creare un oggetto?

Sì, questa funzionalità dipende dall’uso di API per inviare le origini dei dati e, in definitiva, creare oggetti.

Posso creare oggetti personalizzati utilizzando i moduli Klaviyo o i caricamenti CSV?

Al momento, Klaviyo richiede che gli account creino nuovi oggetti personalizzati inviandoci i dati tramite API.

Quando dovrei usare un oggetto personalizzato invece di una Proprietà del profilo o di un evento?

Dovresti usare oggetti personalizzati quando hai una relazione molti-a-uno tra la categoria rappresentata dal tuo oggetto personalizzato e i tuoi profili. Ad esempio, se vuoi conservare informazioni sugli animali domestici della tua clientela e una persona può avere più di un animale domestico, rappresentarli come oggetto personalizzato funziona molto meglio rispetto alle Proprietà del profilo o agli eventi.

Quando esegui il tracciamento di elementi come lo stato di iscrizione, in cui un profilo può avere un solo stato alla volta, la Proprietà del profilo è più adatta. Tuttavia, se vuoi archiviare anche altri dettagli sull’iscrizione di un profilo, un oggetto può essere più adatto.

Quando effettui il tracciamento di qualcosa di ampio, ad esempio quante volte un destinatario ha aperto un e-mail, ti consigliamo di utilizzare gli eventi.

Posso aggiornare il mio oggetto personalizzato dopo la creazione?

Sì, puoi sempre aggiungere proprietà aggiuntive non obbligatorie al tuo oggetto personalizzato. Per saperne di più, leggi come aggiornare un oggetto personalizzato.

Quando devo emettere un evento anziché aggiornare le proprietà dell'oggetto personalizzato?

Gli eventi sono progettati per attivare rapidamente i flussi, consentendoti di inviare comunicazioni tempestive e pertinenti. Quando lo stato di un oggetto cambia e vuoi attivare un messaggio come risultato di questo cambiamento, dovresti aggiornare l’oggetto con le nuove informazioni e inviarci un evento per attivare il flusso.

Puoi personalizzare i modelli con le informazioni dell’oggetto nel flusso attivato dall’evento. Ci sono due modi per farlo:

1. Usa il tag {{ event }} per aggiungere proprietà pertinenti nei metadati del tuo evento da usare nel tuo modello. Funziona bene quando la tempestività è importante.
2. Includi l’ID dell’oggetto nei metadati dell’evento, così puoi recuperare l’oggetto nel modello con {% customobject id={{ event.pet_id }} as pet %}. Tuttavia, l'aggiornamento dell'oggetto con le proprietà più recenti può richiedere del tempo, quindi è possibile che il flusso abbia attivato l'invio di un messaggio prima che l'oggetto venisse aggiornato.

Domande sull’invio dei dati degli oggetti

Come posso iniziare a inviare i miei dati per gli oggetti personalizzati?

1. Crea una nuova fonte dei dati tramite la nostra API.
2. Definisci la tua struttura dei dati (vedi JSON di esempio).
3. Invia i record della tua origine dati a Klaviyo tramite API.
4. Crea il tuo oggetto personalizzato.
5. Crea la relazione tra il tuo oggetto personalizzato e i tuoi profili.

Come vengono create e utilizzate le origini dati?

Dopo aver creato una nuova fonte dei dati, Klaviyo restituirà un identificatore univoco come parte della risposta alla tua richiesta API. Questo consente a Klaviyo di identificare le fonti dei dati, soprattutto nei casi in cui un account abbia più fonti dei dati (ad es. 1 per ogni integrazione personalizzata, magazzino dati o integrazione personalizzata di terze parti su cui il brand si basa per la propria attività).

Con questo identificatore univoco, il tuo sviluppatore può quindi creare record dell'origine dati tramite la API di Klaviyo.

Come devo formattare i miei dati?

Il tuo sviluppatore dovrà inviare a Klaviyo dati in formato JSON. Ti consigliamo di inviare i tuoi dati come testo con un elenco separato da virgole. Potrai usare la segmentazione e l'operatore "contiene" del filtro del flusso per filtrare i valori in questa stringa separata da virgole. Per ulteriori informazioni sul filtro, consulta il riferimento sulle condizioni dei segmenti. 

Tipi di dati supportati negli oggetti personalizzati:

• Testo
• Numero intero
• Decimale
• Data - tutti i valori di data e ora vengono convertiti in UTC nel nostro sistema. Ad esempio, se carichi "2025-04-03" viene convertito in "2025-04-03 00:00:00". Per i clienti con fusi orari con tre ore di anticipo, la data e ora risulterebbe "2025-04-02 21:00:00".
• Valore booleano

Al momento il tipo di dati elenco non è supportato. Per un payload di esempio per l’API del record dell’origine dati, consulta Creazione in blocco dei record dell’origine dati.

Quali sono i limiti di dati per gli oggetti personalizzati?

Puoi caricare un massimo di 2 KB per proprietà e 8 KB per record totale.

Posso mappare con dati nidificati?

Ti consigliamo di definire l'oggetto JSON senza nidificare le proprietà che vuoi usare per l'oggetto personalizzato. Se i dati di origine sono profondamente nidificati o usano un elenco, dovrai inserire manualmente il percorso JSON nel gestore oggetti. Per gli elenchi, puoi mappare una proprietà solo su una posizione all'interno di quell'elenco (ad es. il primo o il secondo valore).

Posso associare più identificatori a un profilo?

Sì, se vuoi usare 2 o più identificatori di profilo (ad es. e-mail e numero di telefono) per associare i record del tuo oggetto personalizzato a un profilo, assicurati di includere entrambe le proprietà in ogni sincronizzazione, anche se il valore di una è null. 

Domande sull'utilizzo degli oggetti con i flussi

Se il mio oggetto non ha attivato un flusso e non ho un id oggetto da un evento, posso comunque personalizzare la mia messaggistica?

Sì, puoi usare i filtri oggetto per trovare l'oggetto giusto quando personalizzi la tua messaggistica.

Posso visualizzare in anteprima i messaggi del flusso quando un oggetto attiva un flusso?

Al momento non è possibile utilizzare la funzione di anteprima nell’app per visualizzare un messaggio quando usi il tag {{ object }}.

Per testare un messaggio del flusso:

1. Crea un flusso attivato dalla data e impostalo come attivo.
2. Crea un profilo con un oggetto che ha una data che attiverà tra almeno 24 ore.

Posso aggiornare i miei oggetti usando azioni di flusso come webhook e codice Klaviyo?

Al momento, ti consigliamo di aggiornare prima la fonte dati originale e poi inviare l’oggetto rivisto a Klaviyo nel formato consentito. Se questi due sistemi non sono sincronizzati, rischi di inviare a Klaviyo dal tuo sistema un record non aggiornato, riportandolo al valore originale.