Komma igång med anpassade objekt

Du kommer att lära dig

Lär dig mer om anpassade objekt, inklusive hur du ställer in ett objekt och hur du kan använda objekt i Klaviyo.

Innan du börjar

Du måste ha tillgång till anpassade objekt för att kunna använda den här funktionen. 

Vad är anpassade objekt?

Anpassade objekt är en typ av data struktur i Klaviyo som gör att du kan mappa olika, multi-relationella data koncept till Klaviyo som inte kan butik med hjälp av profilegenskaper. Säg till exempel att du vill gå in på data och läsa om kunddjur på Klaviyo. Varje husdjur har ett antal attribut (t.ex. namn, ålder, ras...). etc.) vilket gör det utmanande att lagra denna information med profilegenskaper när en profil har flera husdjur. 

Du kan sedan använda detta objekt data in flöde, mall, and segment across Klaviyo för att bättre anpassa din marknadsföring. 

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.
• Object property limits 
  Antalet 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.

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 data -källa för ditt anpassade objekt. När du har slutfört dessa steg väljer du 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
  Källan data som objektet data 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. 

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 objektet. Därför är det viktigt att skicka hela objektet varje gång, även om du bara vill uppdatera 1 post. 

Säg till exempel att du bara vill uppdatera 1 av 5 poster i ett objekt. Om du skickar uppdatera data med ID och bara den 1 post som du vill uppdatera, kommer de andra 4 posterna 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.

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.

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.

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. 

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": {
      "barn": {
        "child_id": "d64b8458",
        "namn": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "telefonnummer": [
              "+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 kan du ange att relationsnamnet ska vara något i stil med "Husdjursägare".
• Källa data
  Välj de data källegenskaper som du vill associera med en profil. 
• profil identifierare
  Ställ in profilidentifieraren (t.ex. e-post, telefonnummer etc.). Denna måste finnas med i källan data 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. 

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 men inte publicerat eller aktivt. 
• 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 timmar att publicera. När det är klart ändras statusen till Aktiv.
• Active
  Objektet är publicerat och live. Alla anpassade objektposter har skapats i enlighet med 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 dina profiler.

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 

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 

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