Primi passi con gli oggetti personalizzati

Scopri di più sugli oggetti personalizzati, che ti consentono di memorizzare e associare più proprietà a un singolo "oggetto".  Gli oggetti personalizzati ti consentono di mappare diversi concetti di dati multi-relazionali in Klaviyo che non possono essere memorizzati utilizzando le proprietà del profilo. Potrai quindi utilizzare oggetti personalizzati nei tuoi messaggi, segmenti e altro ancora. 

Quali sono le differenze tra gli oggetti personalizzati e le proprietà del profilo? 

Le proprietà del profilo sono un ottimo modo per archiviare informazioni semplici. Ad esempio, se hai una proprietà del colore preferito, puoi memorizzare il colore preferito di ciascun cliente. 

E se invece volessi avere bisogno di più dati o di più versioni di quella proprietà? Un ottimo esempio è per gli animali domestici. Puoi utilizzare le proprietà del profilo per memorizzare elementi come nome, età, razza, ma queste possono essere utilizzate una sola volta per profilo.

Se qualcuno ha più animali domestici, puoi invece utilizzare oggetti personalizzati. In questo modo, Fluffy the Great Dane ha la sua carta d'identità digitale per nome, età, peso, ecc. E Cheeks the hamster ha le stesse informazioni, ma con risposte (molto) diverse.  

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à dell'oggetto 
  Il numero di proprietà che un account può avere per 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 una fonte dei 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 (facoltativo)
  Una descrizione dei dati che il tuo oggetto rappresenta
• Fonte dei dati 
  L'origine dati da cui ottenere i dati degli oggetti. Almeno un record deve essere inviato a Klaviyo utilizzando l'oggetto personalizzato API affinché appaia come opzione nel menu a discesa. 

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 oggetto dovrebbe essere una proprietà univoca della fonte dati che può essere usata per identificare istanze specifiche di un record oggetto. Per esempio, con un oggetto "carta regalo", puoi usare qualcosa come il codice sconto unico come ID oggetto. Questo è unico per ogni istanza dell'origine dati e sarà presente per ogni record 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 aggiorni un record di oggetto esistente, l'intero record viene sostituito. Pertanto, è fondamentale inviare l'intero record dell'oggetto, anche se vuoi aggiornare solo una proprietà.

Ad esempio, supponiamo che tu voglia aggiornare solo 1 proprietà su 5 in un record. Se invii dati aggiornati con l'ID e solo la proprietà 1 che desideri aggiornare, le altre 4 proprietà saranno impostate su null. Se uno dei nuovi campi nulli è stato utilizzato nella relazione del tuo profilo (ad esempio un identificatore del profilo come un indirizzo e-mail), l'oggetto non sarà più correlato 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.

Comunque, per questo motivo, ti consigliamo di mandare i dati degli oggetti tramite l'API di acquisizione oggetti in formati standardizzati di data e ora. Se non sai il valore di una proprietà, puoi mettere 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. 

{ "type": "record-fonte-dati", "attributes": { "record": { "child": { "id_figlio": "d64b8458", "name": {
          "first": "Theodore",
          "last": "Customer"
        }, "birth_date": "12-04-2022", "email": "jon.customer@klaviyo.com",
        "phone_numbers": [ "+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 per animali domestici, potresti voler impostare il nome della relazione come "Proprietario dell'animale domestico". 
• Dati di origine
  Seleziona le proprietà della fonte dei dati che desideri associare a un profilo. 
• Identificatore 
  del profilo Imposta l'identificatore del profilo (ad esempio, e-mail, numero di telefono, ecc.) Per poter associare un oggetto a un profilo, è necessario includerlo nella fonte dei dati. Utilizza il pulsante Collega un'altra proprietà per aggiungere ulteriori coppie di proprietà e identificatori.

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

Stati di stato degli oggetti personalizzati

 Esistono tre stati di stato quando si pubblicano oggetti personalizzati: 

• Bozza
  L'oggetto è ancora modificabile e non è pubblicato o attivo. 
• Pubblicazione
  L'oggetto sta creando record di oggetti personalizzati a partire dai dati che hai inviato alla tua fonte di dati.  Se hai inviato alcune migliaia di record dalla tua fonte di dati, il tuo oggetto verrà pubblicato istantaneamente. Se hai inviato alcuni milioni di record, la pubblicazione potrebbe richiedere ore. Una volta completato, lo stato viene modificato in Attivo.
• Attivo
  L'oggetto è pubblicato e attivo. Tutti i record degli oggetti personalizzati sono stati creati in base ai dati inviati dalla tua fonte dei dati. Tutti i nuovi dati inviati per questo oggetto genereranno ulteriori record di oggetti personalizzati collegati ai tuoi profili.

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