Så importerar du historiska händelsedata manuellt

Du kommer att lära dig

Lär dig hur du manuellt importerar historiska händelsedata till Klaviyo. Även om vi rekommenderar att du använder Klaviyo-byggda integrationer med plattformar som Shopify, Magento och BigCommerce samt vårt API för anpassade integrationer, går det också att lägga till dessa data manuellt. Ett vanligt exempel på detta är att lägga till historiska köpdata från en tidigare e-handelsplattform som Klaviyo inte har en förbyggd integration för.

Observera att det finns en gräns på 50 MB för CSV-uppladdningar.

Formatera dina data

Det första steget är att formatera dina data korrekt i en CSV-fil. Nedan är ett exempel på Placed Order-data, tillsammans med en beskrivning av fälten nedan. Varje rad i din CSV-fil ska representera en åtgärd eller aktivitet som någon utförde, som "Köpte produkt" eller "Registrerade sig för webbinariet." Om du har flera åtgärder att spåra ska du ladda upp dem som separata CSV-filer. E-postadressen måste komma först när du laddar upp din CSV.

Här är några exempel-CSV:er för händelser som du kan använda som referens när du formaterar dina data.

Obligatoriska fält

De 2 obligatoriska fälten är en tidsstämpel som anger när händelsen inträffade och en kundegenskap (en e-postadress eller ett unikt ID) som identifierar vem som utförde åtgärden.

• Tidsstämpel: En tidsstämpel som visar dagen och tiden för händelsen. Formatet är ÅÅÅÅ-MM-DD HH:MM:SS. Till exempel skulle 13:30 den 14 november 2012 vara: 2012-11-14 13:30:00.

• Person//Email eller Person//ID: Troligtvis använder du en e-postadress för att identifiera dina kunder. Vissa kunder använder också ett unikt ID. Du kan använda båda om du vill.

Valfria fält

Det finns 2 särskilda fält att lägga märke till.

• $event_id: detta är en unik identifierare för händelsen. I praktiken ska du skicka ett $event_id om du har en unik identifierare för varje händelse (t.ex. ett order-ID). Du bör även ange $event_id om du förväntar dig att vissa händelser inträffar vid samma tidpunkt. Detta kan hända när någon utför en åtgärd som du vill dela upp i flera händelser. Om någon till exempel köper flera varor kan du vilja registrera 1 händelse för varje vara som köps.
  
  I de 2 exempeldataseten nedan finns 1 händelse för lagd beställning, tillsammans med 3 händelser för beställd produkt (1 för varje produkt i den lagda beställningen). Alla dessa händelser har samma tidsstämpel, men de kommer alla att importeras eftersom de var och en har ett unikt $event_id. Om $event_id:na var identiska, eller om de saknades, skulle bara en av händelserna importeras och de andra skulle hoppas över.
  

• $value: Använd det här fältet om händelsen du importerar innehåller ett värde. Om du till exempel importerar data för händelsen Placed Order kommer varje beställning att ha ett värde. Du behöver inte lägga till ett $ eller någon annan valutasymbol före dina värden.

Om du har ytterligare data om personen som gjorde något ska den ligga i en kolumn vars etikett börjar med Person// och sedan den typ av data som kolumnen innehåller. Om du till exempel har företaget eller organisationen som varje person tillhör bör du märka den kolumnen Person//Organization. Det särskilda prefixet talar om för oss att koppla data i den kolumnen till varje person i stället för till aktiviteten. Följande är särskilda kolumner som du kan använda för att hjälpa dig att identifiera personer:

• Person//Förnamn: förnamn
• Person//Efternamn: efternamn
• Person//Telefon: telefonnummer
• Person//Organisation: organisation
• Person//Titel: jobbtitel

Om du har ytterligare data om varje åtgärd kan du lägga till den i extra kolumner med valfria etiketter. Om någon till exempel köper något och du vill inkludera vilken vara de köpte kan du inkludera den informationen i en kolumn med etiketten Köpt vara. Nedan finns några exempel.

• Köpt artikel
• Artikelkategori
• Produkt
• Plats

Om du inte har data för en viss kolumn, lämna den tom så ignorerar vi den. Om du till exempel inte vet någons organisation kan du lämna kolumnen för Person//Organisation tom så hoppar vi över spårning av den egenskapen för den raden i dina data.

När du är klar med att formatera dina data sparar du dem i en CSV-fil.

Ladda upp en CSV-fil med data

När dina data är korrekt formaterade går du till Klaviyo.

1. På Klaviyo väljer du fliken Integrationer.
2. Välj Hantera data > Importera via CSV.
3. Du uppmanas att ladda upp din CSV-fil och klicka sedan på Nästa.
4. Du får möjlighet att namnge händelsen. Om du försöker mappa de importerade uppgifterna till ett händelsemättal som redan finns i ditt konto ska du se till att skriva händelsenamnet exakt så som det redan visas.

5. När du har gett händelsen ett namn kan du förhandsgranska dina data nedan.
6. När du är redo att importera dina data klickar du på Nästa. Din fil börjar bearbetas och du kan navigera bort från sidan.

Obs! För e-handelsbutiker som läser in köpdata

Om du laddar upp köpinformation behöver du ladda upp två filer: en för hela beställningen och en andra som innehåller data per artikel.  En kund kan till exempel lägga en beställning med flera produkter. I det här fallet skulle det finnas 1 händelse för Placed Order och sedan separata händelser för varje Ordered Product. Så här brukar rubrikerna i de filerna se ut:

Skapade Beställning

Beställd Produkt

Vi använder inte $ som prefix för ordervärden. Använd bara siffror för att ange priset eller värdet på en order. Om du använder rubriken $value fylls data i korrekt i ditt Klaviyo-konto.

Anledningen till att inkludera två mättal är att det gör det enklare att senare trigga e-post baserat både på en övergripande beställning och på specifika kategorier/varor.

För Ordered Product-händelser behöver $event_id vara en unik identifierare för varje kombination av beställningen och den beställda produkten. Ett enkelt sätt att skapa en unik identifierare är att kombinera order-ID och produkt-ID som i exemplet ovan.

Felsökning av import

Nedan är några vanliga problem och lösningar som du kan stöta på när du importerar historisk händelsedata manuellt.

Min import tar lång tid

Importer kan ta mellan 5 minuter och 24 timmar beroende på hur stor din lista är. Vi rekommenderar starkt att du påbörjar importen av valfri lista minst 24 timmar innan du behöver den för en viss kampanj, så att importprocessen inte fördröjer ditt utskick.

Min import misslyckas hela tiden

Om din import misslyckas beror det troligen på något av följande skäl:

• Är din fil en .csv-fil? Din fil måste vara i .csv format. Om du försöker ladda upp en Excel-fil eller en .txt fil misslyckas importen.
• Har du formaterat din tidsstämpelkolumn korrekt? Du bör formatera datum och tid som ÅÅÅÅ-MM-DD TT:MM:SS. Till exempel skulle 13:30 den 14 november vara: 2012-11-14 13:30:00. Som en extra kontroll kan du öppna din CSV i en textredigerare för att se till att eventuella efterföljande nollor i dina tidsstämplar inte tas bort när du sparar eller exporterar dina CSV-filer. Om du arbetar med data i ett kalkylblad ska du se till att cellerna för tidsstämpeln är inställda på rätt tidsstämpelformat.
  

• Har alla obligatoriska kolumner data ifyllda för varje rad? Du måste ha en kolumn med etiketten Person//Email eller Person//ID. Om någon av dessa kolumner har en tom rad kan det göra att din import misslyckas.
• Har din Person//Email -kolumn ogiltiga e-postadresser i sig? Om du har värden i Person//Email som inte har ett giltigt e-postadressformat kan detta göra att din import misslyckas.
• Är alla dina kolumner korrekt märkta? Finns det några mellanslag? Se till att alla dina kolumnrubriker matchar det som beskrivs i den här guiden. Du ska också se till att det inte finns några mellanslag i dina kolumnnamn.

Ytterligare resurser