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 puoi archiviare in Klaviyo.

Appuntamento

Se sei un'azienda in cui i clienti possono programmare appuntamenti, puoi utilizzare un oggetto Appuntamento per memorizzare i dati degli appuntamenti per i profili. 

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

• ID appuntamento
• Data dell'appuntamento
• Persona da nominare (ad es., medico specifico, istruttore, ecc.)
• Posizione dell'appuntamento
• Tipo di appuntamento

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

Abbonamento

Se sei un'azienda in cui i clienti possono iscriversi, puoi utilizzare un oggetto Abbonamento per archiviare i dati relativi agli abbonamenti per i profili. 

All'interno di ogni record di oggetto per l'oggetto Abbonamento, alcuni esempi di dati che potresti voler includere sono:

• ID dell'abbonamento
• Prodotto in abbonamento
• Prezzo abbonamento
• Stato dell'abbonamento
• Data della prossima fatturazione

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

Prenotazione

Se sei un'azienda in cui i clienti possono prenotare le prenotazioni, puoi utilizzare un oggetto Prenotazione per archiviare i dati delle prenotazioni per i profili. 

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

• ID prenotazione
• Data della prenotazione
• Posizione della prenotazione
• Occasione della prenotazione
• Numero di ospiti della prenotazione

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

Animale domestico

Se lavori al servizio dei proprietari di animali domestici, puoi utilizzare un oggetto Pet per archiviare i dati sugli animali domestici dei profili. 

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

• ID del microchip per animali domestici
• Nome dell'animale
• Tipo di animale domestico (ad es. cane o gatto)
• Razza animale
• Compleanno dell'animale domestico

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

Limiti dell'account

Gli oggetti personalizzati hanno 3 set di limiti dell'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 dei record dell'oggetto
  Il numero di record di oggetti consentiti per un account.

Il numero di oggetti e record di oggetti disponibili si basa sul numero totale di profili attivi in 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 un gruppo di account con 5 account secondari e ogni account ha 100.000 profili attivi, il totale dei tuoi profili attivi sarà pari a 500.000. Come mostrato nel grafico qui sotto, gli account con oltre 400.000 profili hanno un moltiplicatore di record di oggetti di 10. Di conseguenza, questi account possono archiviare un massimo combinato di 5 milioni di record (500.000 x 10). Ciò significa che potresti avere un account con 3 milioni di record, purché i restanti 4 account abbiano meno di 2 milioni di record di oggetti messi insieme. Per quanto riguarda il numero di oggetti per account, poiché il conteggio combinato dei profili è 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 e 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 Contenuto > Oggetti. e clicca su Crea 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 Crea il tuo.

La prima parte del flusso di lavoro di creazione degli oggetti richiede di impostare le 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
  La fonte dei dati in cui si trovano i tuoi dati.

Per creare una nuova origine dati, fai clic sul menu a discesa Seleziona una fonte dati e poi seleziona Crea una nuova fonte dati.

La creazione di un'origine dati richiede l'impostazione delle seguenti informazioni:

• Nome
  Un nome univoco per identificare la fonte dei dati del tuo oggetto.
• Descrizione (facoltativo)
  Una descrizione della tua fonte dei dati.

Imposta l'ID dell'oggetto

Dopo aver impostato un nome per l’oggetto e scelto l’origine dati, il passaggio successivo consiste nell’impostare un ID oggetto e mappare le proprietà dell’oggetto desiderate. Durante questo passaggio, potrai visualizzare in anteprima i dati associati all’origine dati che sono stati inviati a Klaviyo tramite la API degli oggetti personalizzati.

L'impostazione dell'ID dell'oggetto è necessaria per distinguere i record dell'oggetto tra loro. Devi specificare una proprietà della fonte dei dati da utilizzare per l'ID dell'oggetto univoco.

L'ID dell'oggetto deve essere una proprietà di origine dati univoca che può essere utilizzata per identificare istanze specifiche di un record dell'oggetto. Ad esempio, con un oggetto carta regalo puoi utilizzare qualcosa come il codice sconto univoco come ID dell'oggetto. Si tratta di un valore univoco per ogni istanza dell'origine dati e sarà presente per ogni record di oggetto.

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

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.

Mappa le proprietà dell'oggetto

Mappando le proprietà dell'oggetto, puoi selezionare quali informazioni all'interno della fonte dei dati saranno disponibili all'interno di un oggetto in Klaviyo.

Tuttavia, per questo motivo, ti consigliamo di inviare i dati dell'oggetto tramite l'API di acquisizione degli oggetti in formati di data e timestamp standardizzati. Se il valore di una proprietà specifica non è noto, puoi impostare un valore null.

Per mappare le proprietà dell'oggetto:

1. Nella colonna della proprietà Origine dati seleziona la proprietà dell'origine dati che desideri includere nel tuo oggetto.
2. Nella colonna Proprietà mappata , inserisci il nome che desideri che la proprietà dell'origine dati abbia nell'oggetto.
3. Nella colonna Data type, seleziona il tipo di dati appropriato della proprietà della fonte dati.
4. Nella colonna Obbligatorio, seleziona la casella di controllo se desideri che questa proprietà sia obbligatoria nell'oggetto.
5. Seleziona il pulsante Aggiungi mappatura se devi mappare ulteriori proprietà dell'oggetto.

Dati nidificati nella mappatura

Per impostazione predefinita, l'interfaccia di gestione degli oggetti supporta un livello di nidificazione. Per accedere a dati più dettagliati, devi inserire manualmente il percorso da te scelto.

Ad esempio, puoi dare un'occhiata alla fonte dei dati qui sotto.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "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é i dati sono altrimenti nidificati troppo lontano per essere accessibili con l'interfaccia.

Se hai una matrice nei dati sorgente, puoi trovare le proprietà da mappare per posizione. Ad esempio, potresti estrarre il primo numero di telefono all'interno della matrice phone_numbers includendo [0] alla fine del tuo percorso.

Aggiungi una relazione

Dopo aver impostato un ID oggetto e aver mappato le proprietà dell'oggetto, il passaggio successivo consiste nell'aggiungere una relazione al tuo oggetto.

Le relazioni collegano il tuo oggetto ai profili pertinenti. 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 es. e-mail, numero di telefono, ecc.). È necessario includerlo nell'origine dati affinché un oggetto sia associato a un profilo. Usa 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 modale di conferma e seleziona il pulsante Crea oggetto. Tieni presente che le mappature esistenti non possono essere modificate una volta creato l'oggetto e i dati inizieranno a sincronizzarsi immediatamente.

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

• Nome dell'oggetto
• Data di creazione
• Data dell'ultimo aggiornamento
• Stato

Stati degli oggetti personalizzati

Quando si pubblicano oggetti personalizzati, sono presenti tre stati di stato:

• 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 nelle pagine del profilo

Gli oggetti pertinenti appariranno anche nella pagina di un 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 nella pagina di un profilo. Puoi passare da un oggetto all'altro utilizzando il menu a discesa sopra le schede oggetto.

Per visualizzare un record completo dell'oggetto, seleziona il menu a 3 punti e fai clic su Visualizza. Apparirà un pannello laterale che contiene il record completo dell'oggetto.

Aggiorna un oggetto

Se desideri iniziare a inviare nuovi dati per un oggetto, aggiungi le proprietà aggiuntive dell'oggetto alla tua origine dati, quindi modifica la mappatura dell'oggetto per includere questa nuova proprietà. Tutti gli oggetti creati in precedenza restituiranno un valore nullo per questa proprietà poiché i dati non sono disponibili, ma in futuro gli oggetti verranno creati e aggiornati con questa proprietà.

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

Per aggiornare un oggetto:

1. Clicca su Contenuto > Oggetti nella barra laterale di Klaviyo.
2. Seleziona il nome dell'oggetto che desideri modificare.
3. Clicca su Avanti nell'angolo in alto a destra.
4. Nella sezione Mappa proprietà oggetto fare clic su Aggiungi mappatura.

1. Nella colonna della proprietà Origine dati seleziona la proprietà dell'origine dati che desideri includere nel tuo oggetto.
2. Nella colonna Proprietà mappata , inserisci il nome che desideri che la proprietà dell'origine dati abbia nell'oggetto.
3. Nella colonna Tipo di dati, seleziona il tipo di dati appropriato della proprietà dell’origine dati.

1. Clicca su Avanti nell'angolo in alto a destra.
2. Clicca su Avanti nell'angolo in alto a destra. Non dovrai apportare modifiche alle tue relazioni.
3. Fai clic su Pubblica modifiche.

Una volta completata la procedura, tutti i record della tua fonte dei dati saranno rielaborati e i record degli oggetti personalizzati esistenti saranno aggiornati di conseguenza.

Eliminare un oggetto

Per eliminare un oggetto:

1. Clicca su Contenuto > Oggetti nella barra laterale di Klaviyo.
2. Nel menu a destra dell'oggetto, fai clic su Elimina.
   

3. Fai nuovamente clic su Elimina per confermare la rimozione dell'oggetto.
4. L'oggetto e tutti i record degli oggetti personalizzati associati vengono eliminati.

Se crei un nuovo oggetto personalizzato utilizzando la fonte dei dati di un oggetto precedente, i nuovi record degli oggetti personalizzati saranno generati utilizzando i dati che hai già sincronizzato. 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