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?

Hai bisogno di uno sviluppatore per inviare dati personalizzati tramite API. Puoi creare l'origine dati e configurare l'oggetto in Klaviyo.

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

I moduli di Klaviyo e i caricamenti CSV non inviano record di oggetti personalizzati. Usa l'API per inviare i tuoi dati personalizzati, quindi mappali a un oggetto in Klaviyo.

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 si effettua il tracciamento di elementi come lo stato di iscrizione, in cui un profilo può avere un solo stato alla volta, una Proprietà del profilo è più adatta. Tuttavia, se vuoi archiviare anche altri dettagli sull’iscrizione di un profilo, un oggetto può funzionare meglio.

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 aggiungere proprietà non obbligatorie fino al limite di proprietà dell’oggetto del tuo account. 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. Includi le proprietà di cui hai bisogno nei dati dell’evento, poi fai riferimento a queste nel tuo modello. Ad esempio, se l’evento include una proprietà pet_name, usa {{ event.pet_name }}. Funziona bene quando la tempestività è importante.
2. Includi l’ID dell’oggetto nei dati dell’evento, quindi recupera l’oggetto nel modello. Per un oggetto denominato Pet con una proprietà Name e una proprietà dell’evento denominata pet_id, usa {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Sostituisci questi nomi con i nomi del tuo oggetto, della tua proprietà e del campo evento. Gli aggiornamenti degli oggetti possono richiedere tempo prima di essere disponibili, quindi un messaggio del flusso potrebbe essere inviato prima che l’oggetto abbia i valori più recenti.

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 utilizzando il JSON di esempio in Creazione in blocco di record dell'origine dati.
3. Invia i record della tua origine dati a Klaviyo tramite API.
4. Crea il tuo oggetto personalizzato utilizzando quella fonte di dati. Scegli un ID oggetto univoco e mappa le proprietà che vuoi usare.
5. Crea la relazione tra il tuo oggetto personalizzato e i tuoi profili mappando gli identificatori del profilo nei tuoi dati, come e-mail o numero di telefono.
6. Rivedi le tue mappature, fai clic su Crea oggetto, quindi fai di nuovo clic su Crea oggetto per confermare.

Come vengono create e utilizzate le origini dati?

Quando crei una fonte dati tramite l'API, Klaviyo restituisce un identificatore univoco come parte della risposta alla tua richiesta API. Questo consente a Klaviyo di identificare le fonti dati, soprattutto nei casi in cui un account ha più fonti dati (ad esempio, 1 per ogni integrazione personalizzata, magazzino dati o integrazione personalizzata di terze parti su cui il brand fa affidamento 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 dati in formato JSON a Klaviyo. Per una proprietà con più valori di testo, invia un array di stringhe e mappalo come Elenco (Testo). Puoi filtrare questi valori in segmenti e flussi. Consulta il riferimento alle condizioni dei segmenti per maggiori informazioni sul filtraggio.

Tipi di dati supportati negli oggetti personalizzati:

• Testo
• Numero (intero)
• Numero (decimale)
• Timestamp: le date e gli orari vengono archiviati in UTC. Un valore senza un fuso orario, come 2025-04-03, viene trattato come 2025-04-03 00:00:00 UTC. Un valore con un offset, come 2025-04-03T00:00:00+03:00, viene convertito in 2025-04-02 21:00:00 UTC.
• Valore booleano
• Elenco (testo)

Elenco (testo) supporta array di stringhe, ad esempio ["cane", "gatto"]. Non supporta array di numeri, elenchi annidati o oggetti. Per un payload di esempio per l’API del record dell’origine dati, consulta Bulk Create Data Source Records.

Quali sono i limiti di dati per gli oggetti personalizzati?

Ogni proprietà dell'oggetto personalizzato mappata può contenere fino a 2 KB e ogni record dell'oggetto personalizzato mappato può contenere fino a 8 KB.

Posso mappare con dati nidificati?

Ti consigliamo di definire l’oggetto JSON senza annidare le proprietà che vuoi usare per l’oggetto personalizzato. Per i dati annidati, seleziona una proprietà dal menu a discesa Proprietà origine dati oppure inserisci manualmente il relativo percorso JSON. Per un elenco di valori di testo, mappa l’elenco stesso come Elenco (Testo). Per mappare un singolo elemento da un array, usa la relativa posizione, ad esempio [0] per il 1° elemento o [1] per il 2°.

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?

Sì. Puoi visualizzare in anteprima i messaggi che utilizzano i dati {{ object }} in un flusso attivato da una data basato su un oggetto personalizzato, prima di pubblicare il flusso.

Per visualizzare l'anteprima di un'e-mail:

1. Apri un’e-mail in un flusso attivato dalla data basato su un oggetto personalizzato, quindi fai clic su Anteprima nell’editor e-mail.
2. Seleziona un profilo associato a un record per quell’oggetto, quindi controlla il messaggio personalizzato.

L'anteprima utilizza un oggetto di esempio associato al profilo selezionato. Se non è disponibile, utilizza un record di esempio dello stesso tipo di oggetto. Verifica i valori mostrati: l'anteprima non conferma quale record attiverà il flusso. Se non sono disponibili record, non sono presenti dati oggetto da visualizzare in anteprima.

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.