Panoramica
Gli Oggetti personalizzati sono oggetti Klaviyo che possono accettare qualsiasi schema e che possono includere un riferimento a chiave straniera a qualsiasi oggetto del profilo Klaviyo. Mentre gli altri tipi di record (profili, eventi, campagne, ecc.) hanno schemi fissi (ad esempio, un profilo ha nome, cognome, e-mail, località, accetta il marketing, ecc.), e mentre alcuni, come i profili, possono accettare campi personalizzati (colore preferito, tipo di animale domestico), c'è una quantità limitata di flessibilità per accettare strutture di dati alternative. Gli Oggetti personalizzati sono un'alternativa flessibile.
Avvertimento
Si tratta di una funzione avanzata riservata ai clienti che hanno accesso a uno sviluppatore o al supporto di uno sviluppatore. Per abilitare questa funzione deve contattare il nostro team di successo clienti.
Cos'è uno schema?
Uno schema è la struttura che definisce una tabella del database. Può pensare a uno schema come alle intestazioni delle colonne di un foglio di calcolo Excel: le dice come si chiama ogni campo e che tipo di dati conterrà, come date, stringhe (testo), numeri, booleani (vero/falso), ecc.
Ad esempio, il seguente è un profilo standard memorizzato in Klaviyo.
Se guardiamo come vengono archiviati i dati in Klaviyo, possiamo vedere la struttura (o schema) in formato JSON.
{
"created": "2018-07-10 13:28:25",
"updated": "2018-07-10 13:28:26",
"object": "person",
"id": "Lwxf3r",
"$email": "klaviyogreen@gmail.com",
"$first_name": "John",
"$last_name": "Smith",
}Cosa le permettono di fare gli oggetti personalizzati?
Gli oggetti personalizzati le consentono di definire uno schema per un nuovo oggetto del database. Questo oggetto può avere una relazione di chiave esterna (cioè può puntare a) qualsiasi altro oggetto profilo esistente in Klaviyo.
Questo è utile quando ha profili con più record correlati che condividono tutti lo stesso schema. Ad esempio, se il suo modello di business utilizza le carte regalo, un singolo cliente può avere zero, uno o centinaia di carte regalo associate al suo profilo.
Altri esempi sono i seguenti:
- Le risposte ai sondaggi (quando un cliente compila lo stesso sondaggio più volte
- Partecipazione all'evento
- Conversazioni con i suoi clienti
- Recensioni dei prodotti
Come può utilizzare i dati degli oggetti personalizzati in Klaviyo?
I dati degli oggetti personalizzati possono essere utilizzati per costruire segmenti all'interno di Klaviyo e per passare i dati in un'e-mail.
Segmentazione con i dati degli oggetti personalizzati
La segmentazione funziona attualmente solo sui campi data (prima / dopo / su / tra le date) e sui campi numero (più di, meno di, uguale a, tra).
Supponiamo che lei abbia creato un oggetto personalizzato che memorizza le informazioni sulle carte regalo per i suoi clienti. Utilizzando i dati dei suoi oggetti personalizzati, può costruire un segmento che include tutti i profili con una o più carte regalo di valore inferiore a 50 dollari o superiore.
Se sta passando informazioni sulla data, potrebbe costruire un segmento che includa tutti i profili che hanno partecipato ad un evento tra il 1 marzo 2018 e il 31 marzo 2018.
Passare i dati dell'oggetto personalizzato in un'e-mail
Qualsiasi campo di un oggetto personalizzato può essere inserito nel corpo di un'e-mail. Per esempio, può utilizzare un tag template per inserire una variabile che mostri il codice della carta regalo, il valore attuale della carta regalo e la data di scadenza.
Il tag può eseguire un loop su tutti i record relativi a un profilo e visualizzare i valori di tutti i record. Se un cliente possiede otto carte regalo diverse, può mostrare tutti i loro codici in un blocco di testo, con il valore attuale accanto.
Il tag può sommare o eseguire altre operazioni di base (min, max) sui dati numerici dei record di oggetti personalizzati. Ad esempio, può sommare il valore di tutte le otto carte regalo e visualizzarlo nell'oggetto dell'e-mail. Per maggiori informazioni, faccia riferimento alla nostra guida ai tag dei modelli e alla sintassi delle variabili.
Come si configura?
Dopo aver contattato il nostro team di assistenza clienti, il suo primo passo è quello di mappare la sua fonte di dati esistente nello schema per creare un oggetto personalizzato Klaviyo.
Di seguito è riportato un esempio dei dati di un singolo oggetto personalizzato all'interno di Klaviyo.
"config": {
"602": {
"campi_desiderati": [
"custrecord_gc_shopify_gc_internal_id",
"custrecord_gc_remaining_balance",
"custrecord_gc_initial_balance",
"custrecord_gc_disabled",
"custrecord_gc_gift_card_type",
"custrecord_gc_sales_order",
"custrecord_gc_customer",
"custrecord_gc_retrieve_balance",
"numero della carta regalo"
],
"mappatura_campi_desiderati": {
"custrecord_gc_gift_card_number": "code",
"custrecord_gc_gift_card_type": "type",
"custrecord_gc_remaining_balance": "value",
"custrecord_gc_sales_order": "shopify_order_number"
},
"campo_email: "custrecord_gc_customer",
"emails_separate": 1,
"campi_da_visualizzare": [
"custrecord_gc_sales_order",
"creato_esterno",
"custrecord_gc_gift_card_type",
"custrecord_gc_initial_balance",
"custrecord_gc_remaining_balance"
],
"index_on": [
"custrecord_gc_gift_card_type",
[
"klaviyo_customer_id",
"numero carta_regalo",
"custrecord_gc_remaining_balance"
]
],
"mappatura": "gift_card",
"parser": {
"custrecord_gc_sales_order": [
"Sales Order #",
"after"
]
}
}
}Possiamo utilizzare questo esempio di dati per analizzare il framework dello schema di oggetti personalizzato di Klaviyo.
"config": {
"602": {
"campi_desiderati": [],
"campi_desiderati_mappatura": {},
"email_field": "custrecord_gc_customer",
"emails_separate": 1,
"campi_da_visualizzare": [],
"index_on": [
"custrecord_gc_gift_card_type",
[
"klaviyo_customer_id",
"numero carta_regalo",
"custrecord_gc_remaining_balance"
]
],
"mappatura": "gift_card,
"parser": {
"custrecord_gc_sales_order": [
"Sales Order #",
"after"
]
}
}
}| Chiave | Valore |
| 602 | L'ID dell'oggetto dalla fonte dati. La sua fonte di dati dovrebbe avere un identificatore unico per ogni oggetto. |
| campi_desiderati | Quali campi deve recuperare Klaviyo dall'oggetto sorgente? Dobbiamo definire ogni campo a cui vogliamo accedere in Klaviyo. |
| mappatura_campi_desiderati | Quali sono le etichette leggibili dall'uomo che vuole applicare a questi campi? Il campo di origine avrà un nome come "custrecord_gc_remaining_balance" nel sistema di origine, che può essere condensato nel valore "" nella mappatura dei campi (che viene poi utilizzata nel tag template). |
| campo_email | Quale campo è il riferimento alla chiave straniera dell'oggetto profilo, che utilizza l'email come lookup? (Questo sarà configurato da un ingegnere). Funziona in combinazione con emails_separate. |
| emails_separate | Il valore dell'e-mail esiste su questo oggetto nel sistema di origine? Funziona insieme a email_field. |
| campi_da_visualizzare | Quali campi vuole vedere nel blocco del profilo per gli oggetti personalizzati? I clienti vogliono poter controllare che i profili giusti siano inclusi nei segmenti, e questo permette loro di determinare quali campi visualizzare. Alcuni campi contengono dati sensibili che non desidera visualizzare, come il saldo residuo di una carta regalo del suo cliente. |
| indice_on | Quali campi dobbiamo utilizzare come indici per questi dati? Quali campi utilizzeremo per interrogare e recuperare i dati frequentemente? L'indicizzazione di un campo rende più veloce il recupero dei dati, quindi se intende utilizzare un campo per la segmentazione o per inserire dati in un'e-mail, è utile aggiungere un indice su di esso. Questo può anche essere riconfigurato dopo l'integrazione iniziale, quindi non è un problema se deve aggiungere ulteriori campi indice in seguito. |
| mappatura | Simile a desired_fields_mapping, ci permette di assegnare un nome facile da usare per questo oggetto in Klaviyo, da utilizzare nelle interfacce di segmentazione e nei tag dei modelli. |
| parser | Questo ci permette di tagliare i caratteri dai campi specificati, in modo da poter utilizzare i dati al loro interno in modi diversi. In questo esempio, il numero dell'ordine di vendita Shopify è stato memorizzato nella fonte di dati come "Ordine di vendita # 100000". Questo significava che non potevamo fare un riferimento incrociato con il nostro campo numero dell'ordine di vendita Shopify esistente, che memorizzava solo il valore 100000. Pertanto, dobbiamo eliminare l'ordine di vendita "#". |
Una volta definito il suo schema per adattarlo al framework di oggetti personalizzati di Klaviyo, collaborerà con gli ingegneri di Klaviyo per implementare un metodo per inviare i suoi dati a Klaviyo.
Nota
Attualmente non disponiamo di un'API pubblica per gli oggetti personalizzati. Per inviare dati di oggetti personalizzati a Klaviyo, dovrà contattarci e collaborare con il nostro team di ingegneri.