Komma igång med anpassade objekt

read
Last updated at:

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

Hur skiljer sig anpassade objekt från profilegenskaper? 

profilegenskaper är ett bra sätt att lagra enkel information. Om du t.ex. har en egenskap för favoritfärg kan du lagra varje kunds favoritfärg. 

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

Om någon har flera husdjur kan du i stället använda anpassade objekt. På så sätt har grand danois-tiken Fluffy sitt eget digitala ID-kort med namn, ålder, vikt etc. och hamstern Cheeks har samma information, men med (mycket) olika svar.  

Exempel på användningsfall

Nedan följer några exempel som visar hur anpassade objekt är flexibla i data du kan butik i Klaviyo. 

Bokning

Om du är ett företag där kund kan boka möten, kan du använda ett Appointment-objekt för att boka tid data för profil.  

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

  • ID för utnämning 
  • Datum för utnämning
  • Avtalad person (t.ex. viss läkare, instruktör etc.)
  • Plats för utnämning
  • Typ av utnämning 

profil kan ha flera objektposter om de har flera möten, och du kan använda detta objekt data för att skapa segment och skicka personliga meddelanden och flöde. 

Prenumeration 

Om du är ett företag där kund kan Registrera dig för en prenumeration kan du använda ett Subscription-objekt för att butiksprenumeration data för profil.  

Inom varje objektpost för Subscription-objektet finns några exempel på data som du kanske vill inkludera:

  • Abonnemangs-ID 
  • Prenumerationsprodukt
  • Teckningspris
  • Status för prenumeration 
  • Nästa faktureringsdatum

profil kan ha flera objektposter om de har flera prenumerationer, och du kan använda detta objekt data för att skapa segment och skicka personliga meddelanden och flöden. 

Bokning

Om du är ett företag där kund kan boka bokningar kan du använda ett Reservation-objekt för att butik boka data för profil.  

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

  • Boknings-ID
  • Datum för bokning
  • Plats för bokning
  • Bokningstillfälle 
  • Reservation antal gäster 

profil kan ha flera objektposter om de har flera bokningar, och du kan använda detta objekt data för att skapa segment och skicka personliga meddelanden och flöde. 

Husdjur

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

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

  • ID för mikrochip för husdjur
  • Namn på husdjur 
  • Typ av husdjur (t.ex. hund eller katt)
  • Husdjursras
  • Husdjurets födelsedag 

profil kan ha flera objektposter om de har flera husdjur, och du kan använda detta objekt data för att skapa segment och skicka personliga meddelanden och flöde. 

Kontots gränser 

Anpassade objekt har 3 uppsättningar Konto-gränser: 

  • Gräns för objekt
    Det totala antalet objekt som ett Konto kan ha.
  • Gränser för objektets egenskaper
    Det antal egenskaper som ett Konto kan ha per objekt.
     
  • Begränsningar för objektsposter
    Det antal objektposter som tillåts för ett Konto.

Antalet tillgängliga objekt och objektposter baseras på det totala antalet aktiv profil på alla dina Konto. Postgränserna är gemensamma för alla konton, medan objektgränserna gäller för varje konto separat. 

Om du t.ex. har en Kontofamilj med 5 barnkonton där varje konto har 100 000 aktiv profil, är din totala aktiva profil 500 000. Som framgår av diagrammet nedan har Konto med över 400.000 profiler en multiplikator på 10 för objektsposter. Detta innebär att dessa Konton tillsammans kan lagra maximalt 5 miljoner poster (500.000 x 10). Detta innebär att du kan ha 1 Konto med 3 miljoner poster så länge som de återstående 4 Kontona har färre än 2 miljoner objektposter tillsammans. När det gäller antalet objekt per Konto, eftersom det kombinerade profilantalet är över 400.000, kan varje Konto ha upp till 5 objekt.

Om du har ett Advanced Klaviyo Data Platform abonnemang kommer objektpostmultiplikatorn att baseras på det totala antalet profiler på ditt Konto. Om du bara har ett e-postabonnemang kommer multiplikatorn att baseras på gränsen för aktiv profil för ditt Konto. 

Profiler Avancerat KDP-abonnemang Antal objekt Antal objektsegenskaper Multiplikator för objektpost
Gratis abonnemang ingen 0 0 N/A
250 - 400,000 ingen 1 15 10x
Betalade 5 30 10x
Över 400.000 ingen 10x
Betalade 10x

Dessutom har alla Konto följande begränsningar: 

  • Maximalt 500 poster per profil per objekt.
  • Varje anpassat objekt får inte vara större än 8 KB.
  • Varje post med anpassade objekt får inte vara större än 2 KB.

Skapa ett objekt 

För att komma igång med att skapa ett objekt i Klaviyo, navigera till Content > Objects

Följ stegen för att skapa och synkronisera en datakälla för ditt anpassade objekt. När du har slutfört dessa steg klickar du på knappen Create custom object för att skapa objektet. 

Härifrån kan du antingen skapa ett objekt från början eller välja en rekommenderad objektgalleria. Om du vill skapa ett objekt från början väljer du knappen Bygg ditt eget.

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

  • Ditt namn
    Ett namn för att identifiera ditt objekt
  • Beskrivning (valfri)
    En beskrivning av de data som ditt objekt representerar
  • Datakälla
    Den datakälla som objektdata ska hämtas från. Minst 1 post måste skickas till Klaviyo med hjälp av API:et för anpassade objekt för att det ska visas som ett alternativ i rullgardinsmenyn. 

namn objekt.jpg

Ange objektets ID

När du har angett ett namn för ditt objekt och valt källan data är nästa steg att ange ett objekt-ID och mappa önskade objektsegenskaper. I det här steget kan du förhandsgranska data som är kopplad till källan data som skickades till Klaviyo via det anpassade objektet API.

Det är nödvändigt att ställa in objekt-ID för att skilja objektposter från varandra. Du måste ange en data -kildegenskap som ska användas för det unika objekt-ID:t. 

Objekt-ID ska vara en unik datakällaegenskap som kan användas för att identifiera specifika instanser av en objektrekord. Till exempel, med ett presentkortsobjekt kan du använda något som 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 data -källa med samma objekt-ID, kommer den tillhörande objektposten att uppdateras. Av denna anledning är det viktigt att objekt-ID är unikt så att rätt post uppdateras.

Skicka objekt data

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.

Om du till exempel vill uppdatera bara 1 av 5 egenskaper i en post. Om du skickar uppdaterade data med ID och bara den egenskap du vill uppdatera, kommer de andra 4 egenskaperna att sättas till null. Om ett av de nya nollfälten användes i din profilrelation (t.ex. en profilidentifierare som en e-postadress), kommer objektet inte längre att vara relaterat till den profilen.

När du skickar telefonnummer måste de vara i E.164-format. När du skickar datum måste de vara i ett av våra godkända tidsstämplingsformat

Egenskaper för kartobjekt 

Genom att mappa objektsegenskaper kan du välja vilken information i källan data som ska vara tillgänglig i ett objekt i Klaviyo.

Endast de data som visas i den specifika förekomsten av källan data som förhandsgranskas är tillgängliga i rullgardinsmenyn. Du kan bläddra igenom instanser av källan data med hjälp av knappen New data sample.

Av denna anledning rekommenderar vi dock att objektdata skickas via API:et för objektinläsning i standardiserade datum- och tidsstämpelformat. Om värdet för en specifik egenskap inte är känt kan du ange ett nullvärde för den.

Sidofält + SiteMain.jpg

För att mappa objektets egenskaper:

  1. I kolumnen för datakällans egenskaper väljer du den data -källans egenskaper som du vill inkludera i ditt objekt. 
  2. I kolumnen Mappad egenskap anger du det namn som du vill att data -källans egenskap ska ha i objektet. 
  3. I kolumnen datatyp väljer du lämplig data typ för din data källfastighet.
  4. I kolumnen Required markerar du kryssrutan om du vill att den här egenskapen ska vara obligatorisk i objektet.
  5. Välj knappen Add mapping (Lägg till mappning ) om du behöver mappa ytterligare objektsegenskaper. 

Om en objektegenskap är inställd på Required måste den finnas i källan data och får inte ha ett null-värde inställt. Om den egenskap som krävs inte finns, skapas inte objektposten.

Nästlade data i mappning

Som standard stöder objekthanteringsgränssnittet 1 nivå av nestning. 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å källan data nedan. 

{
 " typ": "data-source-record",
 " attribut": {
 " record": {
 " child": {
 " child_id": "d64b8458",
 " name": {
          "first": "Theodore",
          "last": "Customer"
        },
 " birth_date": "2022-04-12",
 " email": "jon.customer@klaviyo.com",
        "telefon_nummer": [
 " +11234567899",
 " +13456789123"
 ]
 }
   }      
  }
}
För att komma åt data om ett barns förnamn kan du ange följande sökväg, eftersom data annars ligger för långt bort för att kunna nås via gränssnittet.
Om du har en array i din källa data kan du hitta egenskaper för att mappa efter position. Du kan t.ex. hämta det första telefonnumret i arrayen phone_numbers genom att inkludera [0] i slutet av sökvägen. 

Lägg till relation 

När du har angett ett objekt-ID och mappat dina objektsegenskaper är nästa steg att lägga till en relation till ditt objekt. 

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

  • Relationens namn
    Ange ett namn för din relation. Om du t.ex. har ett husdjursobjekt kanske du vill ange att relationsnamnet ska vara något i stil med" Husdjursägare".
  • Källdata
    Välj de egenskaper för datakällan som du vill associera med en profil. 
  • profilidentifierare
    Ange profilidentifierare (t.ex. e-post, telefonnummer etc.). Detta måste ingå i datakällan för att ett objekt ska kunna associeras med en profil. Använd knappen Link another property för att lägga till ytterligare par av egenskaper och identifierare.

Bekräfta mappningar och skapa objekt

När du är klar med att mappa objektets egenskaper och ange relationen bekräftar du mappningarna i bekräftelsefönstret och klickar på knappen Skapa objekt. Observera att befintliga mappningar inte kan redigeras när objektet har skapats och att data börjar synkroniseras omedelbart. 

bekräfta kartläggning.jpg

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

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

Anpassade statusstatusar för objekt

 Det finns tre statusstatusar när du publicerar anpassade objekt: 

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

Objekt på profilsidor

Relevanta objekt visas också på en profilsida så att du kan se de objektposter som hör till en profil. För att visa objektposterna, navigera till fliken Objects på en profilsida. Du kan växla mellan objekten med hjälp av rullgardinsmenyn ovanför objektkorten. 

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

uppdatera ett objekt 

Alla ändringar som du gör i ett anpassat objekt kommer att resultera i en ändring av det anpassade Aktiv-objektet.

Om du vill börja skicka nya data för ett objekt lägger du till de ytterligare objektsegenskaperna i källan data och redigerar sedan objektmappningen så att den nya egenskapen inkluderas. Alla tidigare skapade objekt kommer att returnera en null för denna egenskap eftersom den data inte är tillgänglig, men framöver kommer objekt att skapas och uppdateras med denna egenskap.

Om du skickar nya objektsegenskaper som ännu inte har mappats till ett objekt kan du uppdatera ditt anpassade objekt så att det inkluderar dem. Alla poster för anpassade objekt omarbetas sedan för att inkludera detta data.

För att uppdatera ett objekt:

  1. Klicka på Content > Objects i sidofältet på Klaviyo.
  2. Välj namnet på det objekt som du vill redigera. 
  3. Klicka på Nästa i det övre högra hörnet.
  4. Klicka  på Lägg till mappning i avsnittet Egenskaper för kartobjekt.

    Detta alternativ är endast tillgängligt om ditt objekt har ytterligare egenskaper som kan läggas till.

  5. I kolumnen för datakällans egenskaper väljer du den data -källans egenskaper som du vill inkludera i ditt objekt. 
  6. I kolumnen Mappad egenskap anger du det namn som du vill att data -källans egenskap ska ha i objektet. 
  7. I kolumnen datatyp väljer du lämplig data typ för din data källfastighet.

    Nyligen kartlagda fastigheter kan inte markeras som nödvändiga.

  8. Klicka på Nästa i det övre högra hörnet. 
  9. Klicka på Nästa i det övre högra hörnet. Du behöver inte göra några förändringar i dina relationer.
  10. Klicka på Publicera ändringar.

När du har slutfört denna process kommer alla poster från din källa data att bearbetas på nytt och befintliga poster för anpassade objekt kommer att uppdateras i enlighet med detta. 

Ta bort ett objekt 

När du har tagit bort ett objekt kan det inte hämtas eller återställas. Alla segment, flöden, köpcentrum eller kampanjer som använde dessa anpassade objekt kommer inte längre att fungera som avsett.

För att radera ett objekt: 

  1. Klicka på Content > Objects i sidofältet på Klaviyo.
  2. Klicka på Ta bort i menyn till höger om ditt objekt. 
  3. Klicka på Delete igen för att bekräfta borttagningen av objektet. 
  4. Objektet och alla tillhörande poster för anpassade objekt raderas. 

Om du skapar ett nytt anpassat objekt med hjälp av ett tidigare objekts data -källa, kommer nya poster för anpassade objekt att genereras med hjälp av data som du redan har synkroniserat. Även om det använder samma data, betraktas det som ett nytt objekt med nya poster, så alla segment, flöde, mall och kampanjer måste uppdateras för att använda detta nya objekt.

Ytterligare resurser 

Så här använder du anpassade objekt i mall

Så här använder du anpassade objekt i segment

Hur man använder anpassade objekt i Flöde

Översikt över API för anpassade objekt

x
Var denna artikel till hjälp?
0 av 0 tyckte detta var till hjälp