Komma igång med anpassade objekt

Lär dig mer om anpassade objekt, som gör att du kan lagra och koppla flera egenskaper till ett enda ”objekt.”  Med anpassade objekt kan du mappa olika, multirelationella datakoncept till Klaviyo som inte kan lagras med hjälp av profilegenskaper. Du kan sedan använda anpassade objekt i meddelanden, segment med mera.

Hur skiljer sig anpassade objekt från profilegenskaper?

Profilegenskaper är ett bra sätt att lagra enkel information. Om du till exempel har en favoritfärgegenskap kan du lagra varje kunds favoritfärg.

Men vad händer om du vill ha mer data eller flera versioner av den egenskapen? Ett bra exempel är för husdjur. Du kan använda profilegenskaper för att lagra saker som namn, ålder, ras, men de kan bara användas en gång per profil.

Om någon har flera husdjur kan du istället använda anpassade objekt. På så sätt har Fluffy the Great Dane sitt eget digitala ID-kort för namn, ålder, vikt, etc., och Cheeks hamster har samma information, men med (mycket) olika svar. 

Exempel på användningsfall

Nedan visas några exempel som visar hur anpassade objekt är flexibla i de data som du kan lagra i Klaviyo.

Bokning

Om du är ett företag där kunder kan schemalägga möten kan du använda ett objekt för avtalade tider för att lagra mötesdata för profiler. 

Inom varje objektpost för objektet Möte är några exempel på data som du kanske vill inkludera:

• Mötes-ID
• Datum för möte
• Person på besök (till exempel specifik läkare, instruktör etc.)
• Plats för möte
• Typ av möte

Profiler kan ha flera objektposter om de har flera avtalade tider, och du kan använda dessa objektdata för att skapa segment och skicka personliga meddelanden och flöden.

Prenumeration

Om du är ett företag där kunder kan registrera sig för en prenumeration kan du använda ett prenumerationsobjekt för att lagra prenumerationsdata för profiler. 

Inom varje objektpost för prenumerationsobjektet är några exempel på data som du kan vilja inkludera:

• Prenumerations-ID
• Prenumerationsprodukt
• Prenumerationspris
• Prenumerationsstatus
• Nästa faktureringsdatum

Profiler kan ha flera objektposter om de har flera prenumerationer, och du kan använda dessa objektdata för att skapa segment och skicka personliga meddelanden och flöden.

Reservation

Om du är ett företag där kunder kan boka bokningar kan du använda ett Reservationsobjekt för att lagra reservationsdata för profiler. 

Inom varje objektpost för Reservation- objektet kan du bland annat behöva följande data:

• Boknings-ID
• Bokningsdatum
• Bokningsplats
• Bokningstillfälle
• Antal bokningsgäster

Profiler kan ha flera objektposter om de har flera reservationer, och du kan använda dessa objektdata för att skapa segment och skicka personliga meddelanden och flöden.

Husdjur

Om du är ett företag som betjänar djurägare kan du använda ett husdjur- objekt för att lagra data om profilens husdjur. 

Inom varje objektpost för Pet- objektet finns några exempel på data som du kan vilja inkludera:

• Pet-mikrochip-ID
• Djurnamn
• Djurtyp (t.ex. hund eller katt)
• Djurras
• Djurens födelsedag

Profiler kan ha flera objektposter om de har flera husdjur, och du kan använda dessa objektdata för att skapa segment och skicka personliga meddelanden och flöden.

Kontobegränsningar

Anpassade objekt har tre uppsättningar kontogränser:

• Objektgräns
  Totalt antal objekt som ett konto kan ha.
• Objektegenskapsgränser
  Antalet egenskaper ett konto kan ha per objekt.
• Objektpostgränser
  Antalet objektposter som tillåts för ett konto.

Antalet tillgängliga objekt och objektposter baseras på det totala antalet aktiva profiler för alla dina konton. Postgränser delas över alla konton, medan objektgränser gäller för varje konto separat.

Om du till exempel har en kontofamilj med 5 underordnade konton där varje konto har 100 000 aktiva profiler är dina totala aktiva profiler lika med 500 000. Som visas i diagrammet nedan har konton med över 400 000 profiler en objektpostmultiplikator på 10. Därför kan dessa konton lagra sammanlagt högst 5 miljoner poster (500 000 x 10). Det innebär att du kan ha 1 konto med 3 miljoner poster så länge de återstående 4 kontona har färre än 2 miljoner objektposter tillsammans. När det gäller antalet objekt per konto kan varje konto ha upp till fem objekt eftersom det kombinerade profilantalet är över 400 000.

Dessutom har alla konton följande begränsningar:

• Maximalt 500 poster per profil per objekt.
• Varje anpassat objekt får inte vara mer än 8 KB.
• Varje anpassad objektpost får inte vara mer än 2 KB.

Skapa ett objekt

För att komma igång med att skapa ett objekt i Klaviyo, navigera till Innehåll > Objekt. och klicka på Skapa objekt.

Härifrån kan du antingen skapa ett objekt från grunden eller välja en rekommenderad objektmall. För att skapa ett objekt från grunden väljer du knappen Bygg ditt eget.

Den första delen av arbetsflödet för att skapa objekt kräver att du anger följande information för ditt objekt:

• Namn
  Ett namn som identifierar ditt objekt
• Beskrivning (valfritt)
  En beskrivning av de data som ditt objekt representerar
• Datakälla
  Datakällan där dina objektdata finns.

Om du vill skapa en ny datakälla klickar du på rullgardinsmenyn Välj en datakälla och väljer sedan Skapa en ny datakälla.

För att skapa en datakälla måste du ställa in följande information:

• Namn
  Ett unikt namn som identifierar källan till dina objektdata.
• Beskrivning (valfritt)
  En beskrivning av din datakälla.

Ange objekt-ID

När du har angett ett namn för ditt objekt och valt datakälla är nästa steg att ange ett objekt-ID och mappa de objektsegenskaper du vill använda. Under det här steget kan du förhandsgranska data som är kopplade till datakällan som skickades till Klaviyo via API:t för anpassade objekt.

Du måste ange objekt-ID för att kunna skilja objektposter från varandra. Du måste ange en datakällegenskap som ska användas för det unika objekt-ID:t.

Objekt-ID:t ska vara en unik datakällegenskap som kan användas för att identifiera specifika instanser av en objektpost. För ett presentkortsobjekt kan du till exempel använda något i stil med den unika rabattkoden som objekt-ID. Detta är unikt för varje instans av datakällan och kommer att finnas för varje objektpost.

När Klaviyo tar emot data från din datakälla med samma objekt-ID kommer den associerade objektposten att uppdateras. Av denna anledning är det viktigt att objekt-ID:t är unikt så att rätt post uppdateras.

Skicka objektdata

När du uppdaterar en befintlig objektpost ersätts hela posten. Därför är det viktigt att skicka hela objektposten, även om du bara vill uppdatera 1 egenskap.

Vi säger som exempel att du vill uppdatera bara 1 av 5 egenskaper i en post. Om du skickar uppdaterade data med ID:t och bara den 1 egenskap du vill uppdatera kommer de andra 4 egenskaperna att ställas in på null. Om ett av de nyligen null-fälten användes i din profilrelation (till exempel en profilidentifierare som en e-postadress), kommer objektet inte längre att vara relaterat till den profilen.

Mappa objektegenskaper

Genom att mappa objektegenskaper kan du välja vilken information inom datakällan som ska vara tillgänglig inom ett objekt i Klaviyo.

Av den anledningen rekommenderar vi att du skickar objektdata via objektinmatnings-API:t i standardiserade datum- och tidsstämpelformat. Om värdet för en specifik egenskap inte är känt kan du ange ett null-värde för den.

För att mappa objektegenskaper:

1. I kolumnen Datakällegenskap väljer du den datakällegenskap som du vill inkludera i ditt objekt.
2. I kolumnen Mappad egenskap anger du det namn som du vill att datakällegenskapen ska ha i objektet.
3. I kolumnen Datatyp väljer du lämplig datatyp för egenskapen för din datakälla.
4. I kolumnen Obligatoriskt markerar du kryssrutan om du vill att denna egenskap ska vara obligatorisk i objektet.
5. Välj knappen Lägg till mappning om du behöver mappa ytterligare objektegenskaper.

Kapslade data i mappning

Som standard har gränssnittet för objekthanteraren stöd för 1 kapslingsnivå. För att få tillgång till djupare data måste du manuellt ange den sökväg du väljer.

Som ett exempel kan du titta på datakällan nedan.

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"
        ]
      }
    }      
  }
}

Om du vill komma åt data om ett barns förnamn kan du ange följande sökväg, eftersom data annars är inbäddade för långt för att komma åt med gränssnittet.

Om du har en array i dina källdata kan du hitta egenskaper att mappa efter position. Du kan till exempel dra det första telefonnumret inom phone_numbers- arrayen genom att inkludera [0] i slutet av din sökväg.

Lägg till relation

När du har ställt in ett objekt-ID och mappat dina objektegenskaper är nästa steg att lägga till en relation till ditt objekt.

Relationer kopplar ditt objekt till relevanta profiler. Definiera följande information för att skapa en relation:

• Relationsnamn
  Ange ett namn för din relation. Om du till exempel har ett husdjursobjekt kanske du vill att relationsnamnet ska vara något i stil med ”Husdjursägare”.
• Källdata
  Välj de datakällegenskaper som du vill koppla till en profil.
• Profilidentifierare
  Ställ in profilidentifieraren (dvs. e-postadress, telefonnummer osv.). Det här måste ingå i datakällan för att ett objekt ska kunna kopplas till en profil. Använd knappen Länka en annan egenskap för att lägga till ytterligare par med egenskap och identifierare.

Bekräfta mappningar och skapa objekt

När du är klar med mappningen av objektegenskaperna och inställningen av relationen bekräftar du mappningarna i bekräftelsemeddelandet och väljer knappen Skapa objekt. Observera att befintliga mappningar inte kan redigeras när objektet har skapats, och att data kommer att börja synkroniseras omedelbart.

Du kommer att se ditt objekt listat på sidan Objekt i Klaviyo, tillsammans med följande information:

• Objektets namn
• Datum för skapande
• Datum för senaste uppdatering
• Status

Statustillstånd för anpassade objekt

Det finns tre statuslägen när du publicerar anpassade objekt:

• Utkast
  Objektet kan fortfarande redigeras och är inte publicerat eller aktivt.
• Publicering
  Objektet skapar anpassade objektposter från de data du har skickat till din datakälla.  Om du har skickat några tusentals poster från din datakälla kommer ditt objekt att publiceras direkt. Om du har skickat några miljoner poster kan det ta timmar att publicera. När detta är klart ändras statusen till Aktiv.
• Aktiv
  Objektet är publicerat och aktivt. Alla anpassade objektposter har skapats enligt de data som skickats från din datakälla. Eventuella nya data som skickas in för detta objekt kommer att generera ytterligare anpassade objektposter som är länkade till dina profiler.

Objekt på profilsidor

Relevanta objekt visas också på en profilsida så att du kan se de objektposter som är relaterade till en profil. Om du vill visa objektposterna navigerar du till fliken Objekt på en profilsida. Du kan växla mellan objekt med rullgardinsmenyn ovanför objektkorten.

Om du vill visa en fullständig objektpost väljer du menyn med tre punkter och klickar på Visa. En sidopanel visas som innehåller hela objektposten.

Uppdatera ett objekt

Om du vill börja skicka nya data för ett objekt lägger du till de ytterligare objektegenskaperna i din datakälla och redigerar sedan din objektmappning för att inkludera denna nya egenskap. Alla tidigare skapade objekt returnerar null för denna egenskap eftersom dessa data inte är tillgängliga, men i fortsättningen kommer objekt att skapas och uppdateras med denna egenskap.

Om du skickar nya objektegenskaper som ännu inte har mappats till ett objekt kan du uppdatera ditt anpassade objekt så att det inkluderas. Alla anpassade objektposter bearbetas sedan om för att inkludera dessa data.

För att uppdatera ett objekt:

1. Klicka på Innehåll > Objekt i Klaviyo-sidofältet.
2. Välj namnet på det objekt som du vill redigera.
3. Klicka på Nästa uppe till höger.
4. I avsnittet Mappa objektegenskaper klickar du på Lägg till mappning.

1. I kolumnen Datakällegenskap väljer du den datakällegenskap som du vill inkludera i ditt objekt.
2. I kolumnen Mappad egenskap anger du det namn som du vill att datakällegenskapen ska ha i objektet.
3. I kolumnen Datatyp väljer du lämplig datatyp för din datakällegenskap.

1. Klicka på Nästa uppe till höger.
2. Klicka på Nästa uppe till höger. Du behöver inte göra ändringar i dina relationer.
3. Klicka på Publicera ändringar.

När du har slutfört denna process kommer alla poster från din datakälla att behandlas på nytt och befintliga anpassade objektposter kommer att uppdateras i enlighet med detta.

Ta bort ett objekt

Så här tar du bort ett objekt:

1. Klicka på Innehåll > Objekt i Klaviyo-sidofältet.
2. Klicka på Ta bort i menyn till höger om objektet.
   

3. Klicka på Ta bort igen för att bekräfta borttagningen av objektet.
4. Objektet och alla associerade anpassade objektposter raderas.

Om du skapar ett nytt anpassat objekt med ett tidigare objekts datakälla genereras nya anpassade objektposter med de data som du redan har synkroniserat. Även om den använder samma data betraktas den som ett nytt objekt med nya poster, så alla segment, flöden, mallar och kampanjer måste uppdateras för att detta nya objekt ska kunna användas.

Ytterligare resurser