Domande frequenti sugli oggetti personalizzati

Cosa imparerai

Scopri le domande più frequenti relative agli oggetti personalizzati in Klaviyo. Se la tua domanda non è presente nelle risorse sottostanti, ti invitiamo a contattarci nel forum della nostra comunità.

Domande generali sugli oggetti

Ho bisogno di uno sviluppatore per creare un oggetto?

Sì, questa funzionalità dipende dall'uso dell'API per inviare dati sorgente e creare oggetti.

Posso creare oggetti personalizzati utilizzando i moduli di Klaviyo o il caricamento di CSV?

Attualmente Klaviyo richiede agli account di creare nuovi oggetti personalizzati inviandoci i dati tramite API. 

Quando devo usare un oggetto personalizzato rispetto a una Proprietà del profilo o a un evento?

Dovresti utilizzare gli oggetti personalizzati quando hai una relazione molti-a-uno tra la categoria che l'oggetto personalizzato rappresenta e il tuo profilo. Ad esempio, se vuoi conservare le informazioni sugli animali domestici dei tuoi clienti e questi ultimi possono avere più di un animale, rappresentarli come un oggetto personalizzato è molto meglio di Proprietà del profilo o di eventi.

Per il tracciamento di elementi come lo stato di appartenenza, dove un profilo può avere solo uno stato alla volta, Proprietà del profilo è più adatto. Tuttavia, se vuoi negoziare anche altri dettagli sull'iscrizione di un profilo, un oggetto può funzionare meglio. 

Per tracciare qualcosa di ampio, come il numero di volte in cui un destinatario ha aperto un'e-mail, si consiglia di utilizzare gli eventi.

Posso aggiornare il mio oggetto personalizzato dopo la sua creazione?

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

Quando devo emettere un evento piuttosto che aggiornare le proprietà dell'oggetto personalizzato?

Gli eventi hanno lo scopo di attivare rapidamente Flusso, consentendoti di inviare messaggi tempestivi e pertinenti. Quando lo stato di un oggetto cambia e vuoi attivare un messaggio in conseguenza di ciò, devi aggiornare, aggiornare l'oggetto con le nuove informazioni e inviarci un evento per attivare il Flusso.

Puoi personalizzare il modello con le informazioni sull'oggetto nell'evento attivato da Flusso. Ci sono due modi per raggiungere questo obiettivo: 

1. Usa il tag {{ event }} per aggiungere le proprietà rilevanti nei metadati dell'evento da utilizzare nel tuo modello. Questo funziona bene quando la tempestività è importante.
2. Includi l'ID dell'oggetto nei metadati dell'evento, il che ti permette di ottenere l'oggetto nel modello con il comando {% customobject id={{ event.pet_id }} as pet %}. Tuttavia, può essere necessario un po' di tempo prima che l'oggetto venga aggiornato con le proprietà più recenti, quindi è possibile che il Flusso abbia attivato un messaggio da inviare prima che l'oggetto fosse 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 di dati utilizzando la nostra API.
2. Definisci la struttura dei dati (vedi esempio JSON).
3. Invia i record della tua fonte di dati a Klaviyo tramite API.
4. Crea il tuo oggetto personalizzato.
5. Crea la relazione tra il tuo oggetto personalizzato e il tuo profilo.

Come vengono create e utilizzate le fonti di dati?

Dopo aver creato una nuova fonte di dati, Klaviyo restituirà un identificativo unico come parte della risposta alla tua richiesta API. Questo permette a Klaviyo di identificare le fonti dei dati, soprattutto nei casi in cui un account abbia più fonti di dati (ad esempio, 1 per ogni integrazione personalizzata, dati di magazzino o integrazioni personalizzate di terze parti su cui il brand fa affidamento per la propria attività).

Con questo identificativo univoco, il tuo sviluppatore può creare record di fonti di dati attraverso l'API di Klaviyo.

Come devo formattare i miei dati?

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

Tipi di dati supportati negli oggetti personalizzati:

• Testo
• Intero
• Decimale
• Data - Tutti i tempi sono 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 fuso orario di tre ore avanti, il datetime sarà "2025-04-02 21:00:00".
• Valore booleano

Il tipo di dati elenco non è attualmente supportato. Per un esempio di payload per il record di origine dati API, vedi Creazione massiva di record di 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 annidati?

Ti consigliamo di definire il tuo oggetto JSON senza annidare le proprietà che vuoi utilizzare per il tuo oggetto personalizzato. Se i dati di origine sono profondamente annidati o utilizzano un elenco, dovrai inserire manualmente il percorso JSON nel gestore degli oggetti. Per gli elenchi, puoi mappare una proprietà solo a una posizione all'interno di quell'elenco (ad esempio, il primo o il secondo valore).

Posso associare più identificatori a un profilo?

Sì, se vuoi utilizzare 2 o più identificatori di profilo (ad esempio, e-mail e numero di telefono) per associare i record dell'oggetto personalizzato a un profilo, assicurati di includere entrambe le proprietà in ogni sincronizzazione, anche se il valore di una di esse è nullo.  

Domande sull'utilizzo degli oggetti con Flusso 

Posso usare il trigger split o il trigger filtro per il Flusso con data?

Al momento, la creazione di trigger split e trigger filtro per Flusso con data non è disponibile.

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

Sì, puoi usare il filtro oggetti per trovare l'oggetto giusto quando personalizzi i tuoi messaggi. 

Posso visualizzare in anteprima i messaggi di Flusso quando un oggetto attiva un Flusso? 

Al momento non è possibile utilizzare la funzione di anteprima dell'applicazione per visualizzare un messaggio quando si utilizza il tag {{ object }} tag.

Per testare un messaggio di Flusso:

1. Crea un Flusso con data e impostalo su live.
2. Crea un profilo con un oggetto che ha una data che si attiverà tra almeno 24 ore.

Posso aggiornare i miei oggetti utilizzando azioni di Flusso come webhook e il codice Klaviyo?

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