Primi passi con gli oggetti personalizzati

Cosa imparerai

Impara a conoscere gli oggetti personalizzati: come impostare un oggetto e come utilizzare gli oggetti in tutto Klaviyo.

Prima di iniziare

Per utilizzare questa funzionalità devi avere accesso agli oggetti personalizzati. 

Cosa sono gli oggetti personalizzati?

Gli oggetti personalizzati sono un tipo di struttura di dati in Klaviyo che ti abilita a mappare concetti di dati diversi e multirelazionali in Klaviyo che non possono essere negoziati utilizzando Proprietà del profilo. Ad esempio, supponiamo che tu voglia vendere dati sugli animali domestici dei clienti su Klaviyo. Ogni animale ha una serie di attributi che lo riguardano (ad esempio, nome, età, razza). ecc.) rendendo difficile negoziare queste informazioni con la Proprietà del profilo quando un profilo ha più animali domestici. 

Puoi quindi utilizzare questi dati oggetto in Flusso, modello e segmento su Klaviyo per personalizzare meglio il tuo marketing. 

Esempi di casi d'uso

Di seguito sono riportati alcuni esempi che dimostrano come gli oggetti personalizzati siano flessibili nei dati che è possibile negoziare in Klaviyo. 

Appuntamento

Se sei un'azienda in cui i clienti possono fissare appuntamenti, puoi utilizzare un oggetto Appuntamento per negoziare i dati degli appuntamenti per il profilo.  

All'interno di ogni record dell'oggetto Appuntamento, alcuni esempi di dati che potresti voler includere sono:

• ID appuntamento 
• Data della nomina
• Persona incaricata (ad esempio, un medico specifico, un istruttore, ecc.)
• Luogo dell'appuntamento
• Tipo di appuntamento 

I profili possono avere più record di oggetti se hanno più appuntamenti, e puoi utilizzare questi dati di oggetti per creare segmenti e inviare messaggi personalizzati e Flusso. 

Abbonamento 

Se sei un'azienda in cui i clienti possono registrarsi per un abbonamento, puoi utilizzare un oggetto Subscription per negoziare dati di abbonamento per il profilo.  

All'interno di ogni record dell'oggetto Subscription, alcuni esempi di dati che potresti voler includere sono:

• ID abbonamento 
• Prodotto in abbonamento
• Prezzo di abbonamento
• Stato dell'abbonamento 
• Prossima data di fatturazione

I profili possono avere più record di oggetti se hanno più abbonamenti, e puoi utilizzare questi dati di oggetti per creare segmenti e inviare messaggi personalizzati e Flusso. 

Prenotazione

Se sei un'azienda in cui i clienti possono prenotare, puoi utilizzare un oggetto Prenotazione per negoziare dati di prenotazione per il profilo.  

All'interno di ogni record dell'oggetto Prenotazione, alcuni esempi di dati che potresti voler includere sono:

• ID prenotazione
• Data della prenotazione
• Posizione della prenotazione
• Occasione di prenotazione 
• Conteggio degli ospiti della prenotazione 

I profili possono avere più record di oggetti se hanno più prenotazioni, e puoi utilizzare questi dati di oggetti per creare segmenti e inviare messaggi personalizzati e Flusso. 

Animale domestico

Se sei un'azienda che serve i proprietari di animali domestici, puoi utilizzare l'oggetto Pet per vendere dati sul profilo degli animali domestici.  

All'interno di ogni record dell'oggetto Pet, alcuni esempi di dati che potresti voler includere sono:

• Microchip identificativo dell'animale domestico
• Nome dell'animale domestico 
• Tipo di animale domestico (ad esempio, cane o gatto)
• Razza di animale domestico
• Compleanno dell'animale domestico 

I profili possono avere più record di oggetti se hanno più animali domestici, e puoi utilizzare questi dati di oggetti per creare segmenti e inviare messaggi personalizzati e Flusso. 

Limiti dell'account 

Gli oggetti personalizzati hanno 3 serie di limiti di account: 

• Limite di oggetti
  Numero totale di oggetti che un account può avere.
• Limiti delle proprietà degli oggetti 
  Il numero di proprietà che un account può avere per ogni oggetto.
  
• Limiti di record di oggetti
  Il numero di record di oggetti consentiti per un account.

Il numero di oggetti e di record di oggetti disponibili si basa sul numero totale di profili attivi di tutti i tuoi account. I limiti dei record sono condivisi tra tutti gli account, mentre i limiti degli oggetti si applicano a ciascun account separatamente. 

Ad esempio, se hai una famiglia di conti con 5 conti figli in cui ogni conto ha 100.000 profili attivi, il tuo profilo attivo totale è pari a 500.000. Come mostra il grafico sottostante, gli account con oltre 400.000 profili hanno un moltiplicatore di record dell'oggetto pari a 10. Di conseguenza, questi account possono negoziare un massimo di 5 milioni di record (500.000 x 10). Ciò significa che puoi avere un account con 3 milioni di record, a patto che gli altri 4 account abbiano meno di 2 milioni di record di oggetti messi insieme. Per quanto riguarda il numero di oggetti per account, dato che il numero di profili combinati è superiore a 400.000, ogni account può avere fino a 5 oggetti.

Inoltre, tutti gli account hanno i seguenti limiti: 

• Massimo 500 record per profilo per oggetto.
• Ogni oggetto personalizzato non deve superare gli 8 KB.
• Ogni record di oggetto personalizzato non deve superare i 2 KB.

Crea un oggetto 

Per iniziare a creare un oggetto in Klaviyo, vai su Contenuti > Oggetti. 

Segui i passaggi per creare e sincronizzare un'origine dati per il tuo oggetto personalizzato. Una volta completati questi passaggi, seleziona il pulsante Crea oggetto personalizzato per creare l'oggetto. 

Da qui puoi creare un oggetto da zero o selezionare un modello di oggetto consigliato. Per creare un oggetto da zero, seleziona il pulsante Costruisci il tuo oggetto.

La prima parte del flusso di lavoro per la creazione di un oggetto richiede l'impostazione delle seguenti informazioni per il tuo oggetto:

• Nome
  Un nome per identificare il tuo oggetto
• Descrizione (opzionale)
  Una descrizione dei dati che l'oggetto rappresenta
• sorgente dati
  L'origine dei dati da cui ottenere i dati dell'oggetto. Almeno un record deve essere inviato a Klaviyo utilizzando l'API dell' oggetto personalizzato affinché appaia come opzione nel menu a tendina. 

Imposta l'ID dell'oggetto

Una volta impostato un nome per il tuo oggetto e scelta l'origine dei dati, il passo successivo consiste nell'impostare un ID dell'oggetto e nel mappare le proprietà dell'oggetto desiderate. Durante questa fase, potrai vedere l'anteprima dei dati associati all'origine dati che sono stati inviati a Klaviyo attraverso l'API dell' oggetto personalizzato.

L'impostazione dell'ID dell'oggetto è necessaria per distinguere i record dell'oggetto l'uno dall'altro. Dovrai specificare una proprietà dell'origine dati da utilizzare per l'ID univoco dell'oggetto. 

L'ID dell'oggetto deve essere una proprietà unica dell'origine dati che può essere utilizzata per identificare istanze specifiche di un record di oggetto. Ad esempio, per un oggetto carta regalo, puoi utilizzare come ID dell'oggetto un codice sconto univoco. Questo dato è unico per ogni istanza della sorgente dati e sarà presente per ogni record di oggetto. 

Ogni volta che Klaviyo riceve dati dalla tua fonte dati con lo stesso ID oggetto, il record dell'oggetto associato sarà aggiornare, aggiornare. Per questo motivo, è importante che l'ID dell'oggetto sia univoco in modo che il record appropriato sia aggiornare, aggiornamento.

Invia i dati dell'oggetto

Quando si aggiorna un record di un oggetto esistente, l'intero oggetto viene sostituito. Pertanto, è fondamentale inviare l'intero oggetto ogni volta, anche se si desidera aggiornare solo 1 record. 

Ad esempio, supponiamo che tu voglia aggiornare, aggiornare solo 1 dei 5 record di un oggetto. Se invii aggiornare, aggiornamento dati con l'ID e solo il record che vuoi aggiornare, gli altri 4 record saranno impostati come nulli. Se uno dei nuovi campi nulli era utilizzato nella relazione con il profilo (ad esempio un identificatore del profilo come un indirizzo e-mail), l'oggetto non sarà più collegato a quel profilo.

Proprietà dell'oggetto mappa 

Grazie alla mappatura delle proprietà degli oggetti, puoi selezionare quali informazioni della fonte di dati saranno disponibili all'interno di un oggetto in Klaviyo.

Tuttavia, per questo motivo, consigliamo di inviare i dati degli oggetti attraverso l'API di ingestione degli oggetti in formati standardizzati. Se il valore di una proprietà specifica non è noto, puoi impostare un valore nullo.

Per mappare le proprietà degli oggetti:

1. Nella colonna Proprietà sorgente dati seleziona la proprietà sorgente dati che vuoi includere nel tuo oggetto. 
2. Nella colonna Proprietà mappata , inserisci il nome che vuoi dare alla proprietà dell'origine dati nell'oggetto. 
3. Nella colonna Tipo di dati, seleziona il tipo di dati appropriato della tua proprietà di origine dati.
4. Nella colonna Richiesto, seleziona la casella di controllo se desideri che questa proprietà sia obbligatoria nell'oggetto.
5. Seleziona il pulsante Aggiungi mappatura se hai bisogno di mappare altre proprietà dell'oggetto. 

Dati annidati nella mappatura

Per impostazione predefinita, l'interfaccia del gestore di oggetti assiste 1 livello di annidamento. Per accedere a dati più approfonditi, devi inserire manualmente il percorso che preferisci.

A titolo di esempio, guarda l'origine dei dati qui sotto. 

{
   "tipo": "dati-sorgente-ricordo",
   "attributi": {
   "record": {
    "child_id": "d64b8458",
    "bambino": { 
     "nome": {
      “first”: “Theodore”,
      “last”: “Customer”
     }
    }
    "data_nascita": "2022-04-12",
    "e-mail": "jon.customer@klaviyo.com",
    "numeri_di_telefono": [
     "+11234567899",
     "+13456789123"
    ]
   }
  }
 }
]

Per accedere ai dati relativi al nome di un bambino, puoi inserire il seguente percorso, poiché altrimenti i dati sono troppo annidati per potervi accedere con l'interfaccia.

Se hai un array nei dati di origine, puoi trovare le proprietà da mappare in base alla posizione. Ad esempio, puoi estrarre il primo numero di telefono dall'array phone_numbers includendo [0] alla fine del percorso. 

Aggiungi una relazione 

Dopo aver impostato l'ID dell'oggetto e aver mappato le proprietà dell'oggetto, il passo successivo è quello di aggiungere una relazione all'oggetto. 

Le relazioni collegano il tuo oggetto al profilo pertinente. Definisci le seguenti informazioni per impostare una relazione: 

• Nome della relazione
  Imposta un nome per la tua relazione. Ad esempio, se hai un oggetto animale domestico, puoi impostare il nome della relazione come "Proprietario dell'animale domestico". 
• Fonte dati
  Seleziona le proprietà della fonte dati che desideri associare a un profilo. 
• identificativo del profilo
  Imposta l'identificativo del profilo (ad es. e-mail, numero di telefono, ecc.). Questo deve essere incluso nell'origine dati affinché un oggetto sia associato a un profilo. Usa il pulsante Collega un'altra proprietà per aggiungere altre coppie di proprietà e identificatore.

Conferma le mappature e crea l'oggetto

Una volta terminata la mappatura delle proprietà dell'oggetto e l'impostazione della relazione, conferma le mappature nella finestra di conferma e seleziona il pulsante Crea oggetto. Nota che le mappature esistenti non possono essere modificate una volta creato l'oggetto e i dati inizieranno a essere sincronizzati immediatamente. 

Vedrai il tuo oggetto elencato nella pagina Oggetti di Klaviyo, insieme alle seguenti informazioni: 

• Nome dell'oggetto
• Data di creazione
• Ultimo aggiornamento, data di aggiornamento
• Stato 

Oggetti sulle pagine del profilo

Gli oggetti rilevanti appariranno anche nella pagina del profilo, in modo che tu possa visualizzare i record degli oggetti relativi a un profilo. Per visualizzare i record degli oggetti, vai alla scheda Oggetti della pagina del profilo. Puoi passare da un oggetto all'altro utilizzando il menu a tendina sopra le schede degli oggetti. 

Per visualizzare un record completo di un oggetto, seleziona il menu con i 3 punti e clicca su Visualizza. Verrà visualizzato un pannello laterale che contiene l'intero record dell'oggetto. 

aggiornare, aggiornare un oggetto 

Se vuoi iniziare a inviare nuovi dati per un oggetto, aggiungi le proprietà aggiuntive dell'oggetto alla tua sorgente dati, quindi modifica la mappatura dell'oggetto per includere questa nuova proprietà. Tutti gli oggetti creati in precedenza restituiranno un null per questa proprietà in quanto quel dato non è disponibile, ma in seguito gli oggetti verranno creati e aggiornati con questa proprietà.

Se si inviano nuove proprietà dell'oggetto che non sono ancora state mappate su un oggetto, è possibile aggiornare, aggiornare l'oggetto personalizzato per includerlo. Tutti i record degli oggetti personalizzati vengono quindi rielaborati per includere questi dati.

Aggiornare, aggiornare un oggetto:

1. Clicca su Content > Objects nella barra laterale di Klaviyo.
2. Seleziona il nome dell'oggetto che vuoi modificare. 
3. Clicca su Avanti nell'angolo in alto a destra.
4. Nella sezione Proprietà dell'oggetto mappa , clicca su Aggiungi mappatura.

   Questa opzione è disponibile solo se l'oggetto ha proprietà aggiuntive che possono essere aggiunte.

5. Nella colonna Proprietà sorgente dati seleziona la proprietà sorgente dati che vuoi includere nel tuo oggetto. 
6. Nella colonna Proprietà mappata , inserisci il nome che vuoi dare alla proprietà dell'origine dati nell'oggetto. 
7. Nella colonna Tipo di dati, seleziona il tipo di dati appropriato della tua proprietà di origine dati.

   Le proprietà appena mappate non possono essere contrassegnate come necessarie.

   
8. Clicca su Avanti nell'angolo in alto a destra. 
9. Clicca su Avanti nell'angolo in alto a destra. Non dovrai modificare le tue relazioni.
10. Clicca su Pubblica modifiche.

Una volta completato questo processo, tutti i record della tua fonte di dati saranno rielaborati e i record degli oggetti personalizzati esistenti saranno aggiornati di conseguenza. 

Elimina un oggetto 

Per eliminare un oggetto: 

1. Clicca su Content > Objects nella barra laterale di Klaviyo.
2. Nel menu a destra dell'oggetto, clicca su Elimina. 
   
3. Clicca nuovamente su Elimina per confermare la rimozione dell'oggetto. 
4. L'oggetto e tutti i record di oggetti personalizzati associati vengono eliminati. 

Se crei un nuovo oggetto personalizzato utilizzando l'origine dati di un oggetto precedente, verranno generati nuovi record di oggetti personalizzati utilizzando i dati già sincronizzati. Sebbene utilizzi gli stessi dati, è considerato un nuovo oggetto con nuovi record, quindi tutti i segmenti, i Flussi, i modelli e le campagne devono essere aggiornati per utilizzare questo nuovo oggetto.

Risorse aggiuntive 

Come utilizzare gli oggetti personalizzati nel modello

Come utilizzare gli oggetti personalizzati nel segmento

Come utilizzare gli oggetti personalizzati in Flusso

Panoramica dell'API degli oggetti personalizzati