Vanliga frågor om anpassade objekt

Du kommer att lära dig

Läs om vanliga frågor om anpassade objekt i Klaviyo. Om du inte ser din fråga i resursen nedan kan du höra av dig i vårt Community-forum.

Allmänna frågor om objekt

Behöver jag en utvecklare för att skapa ett objekt?

Du behöver en utvecklare för att skicka anpassade data via API:er. Du kan skapa datakällan och konfigurera objektet i Klaviyo.

Kan jag skapa anpassade objekt med Klaviyo-formulär eller CSV-uppladdningar?

Klaviyo-formulär och CSV-uppladdningar skickar inte poster för anpassade objekt. Använd API:t för att skicka dina anpassade data och mappa dem sedan till ett objekt i Klaviyo.

När ska jag använda ett anpassat objekt jämfört med en profilegenskap eller ett event?

Du bör använda anpassade objekt när du har en många-till-en-relation mellan kategorin som ditt anpassade objekt representerar och dina profiler. Om du till exempel vill behålla information om din kunds husdjur, och din kund kan ha fler än ett husdjur, fungerar det mycket bättre att representera dem som ett anpassat objekt än som profilegenskaper eller händelser.

När du använder spårning av objekt som en medlemskapsstatus, där en profil bara kan ha en status åt gången, passar en profilegenskap bättre. Men om du även vill lagra andra uppgifter om en profils medlemskap kan ett objekt fungera bättre.

När du spårar något mer övergripande, som hur många gånger en mottagare har öppnat ett e-postmeddelande, rekommenderar vi att du använder händelser.

Kan jag uppdatera mitt anpassade objekt efter att det har skapats?

Ja, du kan lägga till egenskaper som inte är obligatoriska upp till gränsen för objektets egenskaper i ditt Konto. Läs mer om att uppdatera ett anpassat objekt.

När ska jag skicka en händelse i stället för att uppdatera det anpassade objektets egenskaper?

Händelser är avsedda att utlösa flöden snabbt, så att du kan skicka meddelanden som är aktuella och relevanta. När statusen för ett objekt ändras och du vill utlösa ett meddelande som resultat av detta ska du uppdatera objektet med den nya informationen och skicka oss en händelse för att utlösa flödet.

Du kan anpassa mallar med objektinformationen i det händelseutlösta flödet. Det finns två sätt att göra detta:

1. Inkludera de egenskaper du behöver i händelsedatan och referera sedan till dem i din mall. Till exempel: om händelsen innehåller egenskapen pet_name använder du {{ event.pet_name }}. Det här fungerar bra när det är viktigt att det sker i rätt tid.
2. Inkludera objektets ID i händelsedata och hämta sedan objektet i mallen. För ett objekt med namnet Pet med egenskapen Name och en händelseegenskap med namnet pet_id använder du {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Ersätt de här namnen med dina egna namn för objekt, egenskaper och händelsefält. Det kan ta tid innan objektuppdateringar blir tillgängliga, så ett flödesmeddelande kan skickas innan objektet har de senaste värdena.

Frågor om att skicka objektdata

Hur börjar jag skicka mina data för anpassade objekt?

1. Skapa en ny datakälla med vårt API.
2. Definiera din datastruktur med hjälp av JSON-exemplet i Skapa datakällposter i bulk.
3. Skicka dina poster från datakällan till Klaviyo via API.
4. Skapa ditt anpassade objekt med hjälp av den datakällan. Välj ett unikt objekt-ID och mappa de egenskaper du vill använda.
5. Skapa relationen mellan ditt anpassade objekt och dina profiler genom att mappa profilidentifierarna i dina data, till exempel e-post eller telefonnummer.
6. Granska dina mappningar, klicka på Skapa objekt och klicka sedan på Skapa objekt igen för att bekräfta.

Hur skapas och används datakällor?

När du skapar en datakälla via API:t returnerar Klaviyo en unik identifierare som en del av svaret på din API-begäran. Det gör att Klaviyo kan identifiera datakällor, särskilt i fall där ett Konto har flera datakällor (t.ex. en för varje anpassad integration, datalager eller anpassad tredjepartsintegration som varumärket förlitar sig på i sin verksamhet).

Med denna unika identifierare kan din utvecklare sedan skapa dataposteringar för datakällor via Klaviyos API.

Hur ska jag formatera mina data?

Din utvecklare måste skicka JSON-formaterade data till Klaviyo. För en egenskap med flera textvärden skickar du en matris med strängar och mappar den som Lista (text). Du kan filtrera dessa värden i segment och flöden. Se referensen för segmentvillkor för mer information om filtrering.

Datatyper som stöds i anpassade objekt: datatyper

• Text
• Siffra (heltal)
• Siffra (decimal)
• Tidsstämpel: Datum och tider lagras i UTC. Ett värde utan tidszon, till exempel 2025-04-03, behandlas som 2025-04-03 00:00:00 UTC. Ett värde med en offset, till exempel 2025-04-03T00:00:00+03:00, konverteras till 2025-04-02 21:00:00 UTC.
• Boolesk
• Lista (text)

List (Text) har stöd för arrayer med strängar, till exempel ["dog", "cat"]. Det har inte stöd för arrayer med tal, kapslade listor eller objekt. Ett exempel på payload för API:et för datapost för datakälla finns i Skapa dataposter för datakälla i bulk.

Vilka är datagränserna för anpassade objekt?

Varje mappad egenskap för anpassade objekt kan innehålla upp till 2 KB, och varje mappad post för anpassade objekt kan innehålla upp till 8 KB.

Kan jag mappa med nästlad data?

Vi rekommenderar att du definierar ditt JSON-objekt utan att kapsla in de egenskaper du vill använda för ditt anpassade objekt. För kapslade data väljer du en egenskap i listrutan Datakällegenskap eller anger dess JSON-sökväg manuellt. För en lista med textvärden mappar du själva listan som Lista (text). Om du vill mappa ett enskilt objekt från en matris använder du dess position, till exempel [0] för det 1:a objektet eller [1] för det 2:a.

Kan jag koppla flera identifierare till en profil?

Ja, om du vill använda 2 eller fler profilidentifierare (t.ex. e-post och telefonnummer) för att koppla dina anpassade objektposter till en profil ska du se till att du inkluderar båda dessa egenskaper i varje synkronisering, även om värdet för en av dem är null. 

Frågor om att använda objekt med flöden

Om mitt objekt inte utlöste ett flöde och jag inte har ett objekt-ID från en händelse, kan jag fortfarande anpassa mina meddelanden?

Ja, du kan använda objektfilter för att hitta rätt objekt när du personaliserar dina meddelanden.

Kan jag förhandsgranska flödesmeddelanden när ett objekt utlöser ett flöde?

Ja. Du kan förhandsgranska meddelanden som använder {{ object }} -data i ett datumutlöst flöde baserat på ett anpassat objekt innan du publicerar flödet.

Så här förhandsgranskar du ett e-postmeddelande:

1. Öppna ett e-postmeddelande i ett datumutlöst flöde baserat på ett anpassat objekt och klicka sedan på Förhandsgranska i e-postredigeraren.
2. Välj en profil som är kopplad till en post för objektet och granska sedan det personliga meddelandet.

Förhandsgranskningen använder ett exempelobjekt som är kopplat till den valda profilen. Om inget finns tillgängligt använder den en exempelpost av samma objekttyp. Kontrollera de visade värdena: förhandsgranskningen bekräftar inte vilken post som kommer att utlösa flödet. Om inga poster är tillgängliga finns det inga objektsdata att förhandsgranska.

Kan jag uppdatera mina objekt med flödesåtgärder som webhookar och Klaviyo-kod?

Just nu rekommenderar vi att du först uppdaterar din ursprungliga datakälla och sedan skickar tillbaka det reviderade objektet till Klaviyo i det tillåtna formatet. Om dessa två system hamnar ur synk riskerar du att skicka tillbaka en inaktuell post till Klaviyo från ditt system och därmed återställa den till det ursprungliga värdet.