Översikt
Custom Objects är Klaviyo objekt som kan acceptera vilket schema som helst och som kan innehålla en utländsk nyckelreferens till vilket Klaviyo profilobjekt som helst. Medan våra andra posttyper (profil, evenemang, kampanjer etc.) har fasta scheman (t.ex. har en profil förnamn, efternamn, e-post, plats, accepterar marknadsföring etc.), och medan vissa, som profil, kan acceptera anpassade fält (favoritfärg, husdjurstyp), finns det en begränsad flexibilitet för att acceptera alternativa data strukturer. Custom Objects är ett flexibelt alternativ.
Varning
Detta är en avancerad funktion som är reserverad för kunder som har tillgång till en utvecklare eller utvecklare support. För att aktivera dessa funktioner måste du nå ut till vårt kundframgångsteam.
Vad är ett schema?
Ett schema är den struktur som definierar en databastabell. Du kan tänka på ett schema som kolumnrubrikerna i ett Excel-kalkylblad: det berättar vad varje fält heter och vilken typ av data det kommer att innehålla, t.ex. datum, sträng (text), numerisk, boolesk (sant/falskt) osv.
Följande är till exempel en standardprofilbutik på Klaviyo.
Om vi tittar på hur data är butik i Klaviyo kan vi se strukturen (eller schemat) i JSON-format.
{
"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",
}Vad kan du göra med anpassade objekt?
Med anpassade objekt kan du definiera ett schema för ett nytt databasobjekt. Detta objekt kan ha en främmande nyckelrelation (det vill säga, det kan peka på) alla andra befintliga profilobjekt inom Klaviyo.
Detta är användbart när du har en profil med flera relaterade poster som alla har samma schema. Om din affärsmodell t.ex. använder presentkort kan en enskild kund ha noll, ett eller hundratals presentkort kopplade till sin profil.
Andra exempel är följande:
- Enkätsvar (där en kund fyller i samma enkät flera gånger)
- Närvaro vid evenemang
- Samtal med dina kunder
- Produktrecensioner
Hur kan du använda anpassade objektdata i Klaviyo?
Custom object data kan användas för att bygga segment inom Klaviyo och för att skicka data till en e-post.
segment med Custom Object-data
Segmentering fungerar för närvarande endast på datumfält (före / efter / på / mellan datum) och nummerfält (mer än, mindre än, lika med, mellan).
Låt oss säga att du har skapat ett anpassat objekt som butik presentkortsinformation för din kund. Med hjälp av data från dina anpassade objekt kan du bygga en segment som inkluderar alla profiler med ett eller flera presentkort värda mindre än $50 eller mer.
Om du skickar datuminformation kan du skapa en segment som innehåller alla profiler som deltog i ett evenemang mellan den 1 mars 2018 och den 31 mars 2018.
Skicka data från Custom Object till en e-post
Alla fält i ett anpassat objekt kan dras in i brödtexten i en e-post. Du kan t.ex. använda en malltagg för att infoga en variabel som visar presentkortskoden, presentkortets aktuella värde och utgångsdatum.
Etiketten kan loopa över alla poster som är relaterade till en profil och visa värden från dem alla. Om en kund har åtta olika presentkort kan du visa alla koder i en text block, med det aktuella värdet bredvid.
Etikett kan summera eller utföra andra grundläggande operationer (min, max) på numeriska data från anpassade objektposter. Du kan till exempel lägga ihop värdet på alla åtta presentkorten och visa det i ämnesraden på din e-post. Mer information finns i vår guide till malltagg och variabel syntax.
Hur ställer jag in det?
När du har kontaktat vårt kund support-team är ditt första steg att mappa din befintliga datakälla till schemaramverket för att skapa ett Klaviyo Custom-objekt.
Nedan visas ett exempel på data från ett enda anpassat objekt i Klaviyo.
"config": {
" 602": {
" desired_fields": [
" custrecord_gc_shopify_gc_internal_id",
" custrecord_gc_remaining_balance",
" custrecord_gc_initial_balance",
" custrecord_gc_disabled",
"custrecord_gc_giftcard_type",
" custrecord_gc_sales_order",
" custrecord_gc_customer",
" custrecord_gc_retrieve_balance",
" custrecord_gc_giftcard_number
],
" desired_fields_mapping": {
"custrecord_gc_gift_card_number": "code",
"custrecord_gc_gift_card_type": "type",
"custrecord_gc_remaining_balance": "value",
"custrecord_gc_sales_order": "shopify_order_number"
},
" email_field": "custrecord_gc_customer",
" emails_separate": 1,
" fields_to_display": [
" custrecord_gc_sales_order",
" created_external",
" custrecord_gc_gift_card_type",
" custrecord_gc_initial_balance",
" custrecord_gc_remaining_balance"
],
" index_on": [
"custrecord_gc_gift_card_type",
[
" klaviyo_customer_id",
" custrecord_gc_gift_card_number",
" custrecord_gc_remaining_balance"
]
],
" mapping": "gift_card",
" parsers": {
"custrecord_gc_sales_order": [
"Sales Order #",
"after"
]
}
}
}Vi kan använda detta exempel data för att bryta ned Klaviyo s ramverk för anpassade objektscheman.
"config": {
" 602": {
" desired_fields": [],
" desired_fields_mapping": {},
" email_field": "custrecord_gc_customer",
" emails_separate": 1,
" fields_to_display": [],
" index_on": [
" custrecord_gc_gift_card_type",
[
" klaviyo_customer_id",
" custrecord_gc_gift_card_number",
custrecord_gc_remaining_balance"
]
],
" mapping": "gift_card",
" parsers": {
"custrecord_gc_sales_order": [
"Sales Order #",
"after"
]
}
}
}| Nyckel | Värde |
| 602 | Objektets ID från datakällan. Din datakälla bör ha en unik identifierare för varje objekt. |
| önskade_fält | Vilka fält ska Klaviyo hämta från källobjektet? Vi måste definiera varje fält som vi vill ha tillgång till i Klaviyo. |
| önskade_fält_mappning | Vilka är de mänskliga läsbara etiketter som du vill använda på dessa fält? Källfältet kommer att heta något i stil med "custrecord_gc_remaining_balance" i Källsystemet, vilket kan kondenseras till "värde" i fältmappningen (som senare används i malltagg). |
| e-post_fält | Vilket fält är foreign-key-referensen till profilobjektet, som använder e-post som uppslagsord? (Detta kommer att konfigureras av en ingenjör). Fungerar tillsammans med emails_separate. |
| e-postmeddelanden_separera | Finns e-postvärdet på detta objekt i Källsystemet? Fungerar tillsammans med email_field. |
| fält_att_visa | Vilka fält vill du se i profilen block för anpassade objekt? kund vill kunna kontrollera att rätt profil inkluderas i segmentet, och detta gör att de kan avgöra vilka fält som ska visas. Vissa fält innehåller känsliga data som du inte vill visa, till exempel det återstående saldot på ett av din kunds presentkort. |
| index_on | Vilka fält ska vi använda som index för dessa data? Vilka fält kommer vi att använda för att fråga efter och hämta data ofta? Indexering av ett fält gör det snabbare att hämta data, så om du ska använda ett fält för segmentering eller för att hämta data i en e-post, är det bra att lägga till ett index på det. Detta kan också omkonfigureras efter den första integrationen, så det är inget problem om du behöver lägga till ytterligare indexfält senare. |
| Mappning | I likhet med desired_fields_mapping kan vi här tilldela ett användarvänligt namn för detta objekt i Klaviyo för att använda vid segmentering av gränssnitt och i malltagg. |
| analysatorer | Detta gör att vi kan trimma tecken från angivna fält, så att vi kan använda data i dem på olika sätt. I det här exemplet var Shopify Sales Order Number butik i datakällan som "Sales Order # 100000". Detta innebar att vi inte kunde korsreferera det med vårt befintliga fält Shopify Sales Order number, som bara innehåller värdet 100000. Därför måste vi ta bort "Försäljningsorder #". |
När du har definierat ditt schema så att det matchar Klaviyo:s ramverk för anpassade objekt kommer du att arbeta med Klaviyo:s ingenjörer för att implementera en metod för att skicka din data till Klaviyo.
Anteckning
Vi har för närvarande inte något publikt API för anpassade objekt. För att skicka anpassade objekt data till Klaviyo måste du kontakta oss och arbeta med vårt tekniska team.