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?

Ja, den här funktionen bygger på att API används för att skicka datakällor och i slutändan skapa objekt.

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

Klaviyo kräver för närvarande att Konton skapar nya anpassade objekt genom att skicka data till oss via API.

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 spårar saker som en medlemskapsstatus, där en profil bara kan ha en status åt gången, passar profilegenskaper bättre. Om du däremot även vill lagra andra detaljer 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 alltid lägga till ytterligare, icke-obligatoriska egenskaper i ditt anpassade objekt. 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. Använd etiketten {{ event }} för att lägga till relevanta egenskaper i händelsens metadata som du kan använda i din mall. Det här fungerar bra när det är viktigt att vara i rätt tid.
2. Inkludera objektets ID i händelsens metadata. Då kan du hämta objektet i mallen med {% customobject id={{ event.pet_id }} as pet %}. Det kan dock ta lite tid innan objektet uppdateras med de senaste egenskaperna, så det är möjligt att flödet hann trigga ett utskick innan objektet uppdaterades.

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 (se exempel på JSON).
3. Skicka dina poster från datakällan till Klaviyo via API.
4. Skapa ditt anpassade objekt.
5. Skapa relationen mellan ditt anpassade objekt och dina profiler.

Hur skapas och används datakällor?

När du har skapat en ny datakälla 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. 1 för varje anpassad integration, datalager eller anpassad tredjepartsintegration som varumärket förlitar sig på för 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 behöver skicka JSON-formaterade data till Klaviyo. Vi rekommenderar att du skickar dina data som text med en kommaseparerad lista. Du kan använda segmentering och flödesfilters operator ”innehåller” för att filtrera efter värdena i den här kommaseparerade strängen. Se referensen för segmentvillkor för mer information om filtrering. 

Datatyper som stöds i anpassade objekt: datatyper

• Text
• Heltal
• Decimal
• Datum – alla datum och tider konverteras till UTC i vårt system. Om du till exempel laddar upp ”2025-04-03” konverteras det till ”2025-04-03 00:00:00”. För kunder med tidszoner tre timmar före skulle datum och tid vara ”2025-04-02 21:00:00”.
• Boolesk

Listans datatyp stöds för närvarande inte. Ett exempel på payload för API:et för datakällposten finns i Skapa datakällposter i bulk.

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

Du kan ladda upp högst 2 KB per egenskap och 8 KB per total post.

Kan jag mappa med nästlad data?

Vi rekommenderar att du definierar ditt JSON-objekt utan att nästla de egenskaper du vill använda för ditt anpassade objekt. Om dina källdata är djupt nästlade eller använder en lista behöver du manuellt ange JSON-sökvägen i objekthanteraren. För listor kan du bara mappa en egenskap till en position i den listan (t.ex. det första eller andra värdet).

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?

För närvarande är det inte möjligt att använda förhandsgranskningsfunktionen i appen för att visa ett meddelande när du använder etiketten {{ object }}.

Så testar du ett flödesmeddelande:

1. Skapa ett datumutlöst flöde och ställ in det som live.
2. Skapa en profil med ett objekt som har ett datum som utlöses om minst 24 timmar.

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.