Så här importerar du manuellt en historisk händelse data

Du kommer att lära dig

Lär dig hur du manuellt importerar en historisk händelse data till Klaviyo. Även om vi rekommenderar att du använder Klaviyo-byggda integrationer med plattformar som Shopify, Magento och BigCommerce och vårt API för anpassade integrationer, är det också möjligt att lägga till dessa data manuellt. Ett vanligt exempel på detta är att lägga till historiska köp data 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 visas ett exempel på Orderläggning data, samt en beskrivning av fälten nedan. Varje rad i din CSV-fil ska representera en åtgärd eller aktivitet som någon har utfört, till exempel "Köpte produkt" eller "Anmälde sig till webbseminarium." Om du har flera åtgärder att spåra bör 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 på CSV-filer för händelser som du kan använda när du formaterar dina data.

Obligatoriska fält

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

• Tidsstämpel: En tidsstämpel som visar dag och tid för händelsen. Formatet är YYYY-midmarket+-DD HH:midmarket+:SS. Till exempel, 13:30 den 14 november 2012 skulle vara: 2012-11-14 13:30:00.

  Om två eller flera händelser i din CSV-fil har samma tidsstämpel måste du inkludera ett unikt $event_id, annars importeras bara en av händelserna och resten hoppas över. Se avsnittet om $event_id nedan.

• Person//e-post eller Person//ID: Troligtvis kommer du att använda en e-post för att identifiera din kund. Vissa kundföretag kommer också att använda ett unikt ID. Du kan använda båda om du vill.

Valfria fält

Det finns 2 speciella fält att ta hänsyn till.

• $event_id: Detta är en unik identifierare för evenemanget. I praktiken bör du skicka en $event_id om du har en unik identifierare för varje händelse (t.ex. ett order-ID). Du bör också ange $event_id om du förväntar dig att vissa händelser ska inträffa vid samma tidpunkt. Detta kan hända när någon vidtar en åtgärd som du sedan delar upp i flera händelser. Om någon t.ex. köper flera varor kanske du vill registrera 1 händelse för varje vara som köps.
  
  I de två exempeluppsättningarna på data nedan finns det 1 orderhändelse samt 3 orderhändelser (1 för varje produkt i den lagda ordern). Alla dessa händelser har samma tidsstämpel, men de kommer alla att importeras eftersom de alla har ett unikt $event_id. Om $event_ids är identiska, eller om de saknas, importeras endast en av händelserna och de övriga hoppas över.
  
• $värde: Använd det här fältet om den händelse du importerar innehåller ett värde. Om du t.ex. importerar händelsen Placed Order data, kommer varje order att ha ett värde. Du behöver inte ange $ eller någon annan valutasymbol som prefix till dina värden.

Om du har ytterligare data om den person som gjorde något, ska den läggas i en kolumn vars etikett börjar med Person// och sedan den typ av data som kolumnen innehåller. Om du till exempel har det företag eller den organisation som varje person tillhör, vill du märka den kolumnen Person//Organisation. Det speciella prefixet gör att vi vet att vi ska associera data i den kolumnen med varje person snarare än med aktiviteten. Följande är specialkolumner 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 dem i extra kolumner med de etiketter du vill. Om någon t.ex. köper något och du vill veta vilken vara personen köpte, kan du lägga till data i en kolumn med rubriken Item Purchased. Nedan följer några exempel.

• Föremål som köpts
• Artikelkategori
• Produkt
• Plats

Om du inte har data för en viss kolumn kan du lämna den tom så ignorerar vi den. Om du till exempel inte känner till någons organisation kan du lämna kolumnen för Person//Organisation tom så hoppar vi över att spåra den egenskapen för den raden i din data.

När du är klar med formateringen av 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 > era Importera via CSV.
3. Du uppmanas att ladda upp din CSV-fil och klicka sedan på Nästa.
4. Du kommer att ha möjlighet att namnge evenemanget. Om du försöker koppla den importerade data till en eventmättal som redan finns i ditt Konto, se till att skriva in eventnamnet exakt som det redan står.
5. När du har namngett ditt evenemang kan du förhandsgranska dina data nedan.
6. När du är redo att importera dina data klickar du på Nästa. Din fil kommer att börja bearbetas och du kan navigera bort från sidan. 

Not för e-handelsbutikens laddningsköp data

Om du laddar upp inköp data vill du ladda upp två filer: en för den totala ordern och en andra som innehåller artikel för artikel data.  En kund kan t.ex. beställa flera produkter. I det här fallet skulle det finnas 1 händelse för den lagda ordern och sedan separata händelser för var och en av de beställda produkterna. Så här bör rubrikerna för dessa filer se ut i vanliga fall:

Skapad beställning

Beställd produkt

Vi använder inte $ som prefix till beställningsvärde. Använd bara siffror för att ange priset eller värdet på en order. Om du använder rubriken $value kommer data att fyllas i korrekt i din Klaviyo Konto.

Anledningen till att inkludera två mättal är att det gör det enklare att i efterhand trigga e-post av både en totalorder och av specifika kategorier/artiklar.

För Ordered Product-händelser måste $event_id vara en unik identifierare för varje kombination av ordern 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.

importör felsökning

Nedan följer några vanliga problem och lösningar som du kan hitta när du manuellt importerar historiska händelser data.

Min importera tar lång tid

importera kan ta mellan 5 minuter och 24 timmar beroende på hur stor din lista är. Vi rekommenderar starkt att du påbörjar importeringen av en lista minst 24 timmar innan du behöver den för en viss kampanj för att säkerställa att importeringsprocessen inte försenar din sändning.

Min importör misslyckas hela tiden

Om din importör inte fungerar beror det sannolikt på någon av följande orsaker:

• Är din fil en .csv-fil? Din fil måste vara i .csv-format format. Om du försöker ladda upp en Excel-fil eller en .txt filen kommer importören att misslyckas.
• Har du formaterat din Timestamp-kolumn korrekt? Du bör formatera datum och tid som YYYY-midmarket+-DD HH:midmarket+:SS. Till exempel, 13:30 den 14 november skulle vara: 2012-11-14 13:30:00. Som en andra kontroll öppnar du din CSV-fil i en textredigerare för att säkerställa att eventuella efterföljande 0:or i tidsstämplarna inte tas bort när du sparar eller exporterar CSV-filerna. Om du arbetar med data i ett kalkylblad ska du se till att cellerna med tidsstämpel är inställda på rätt tidsstämpelformat.
  
• Har alla obligatoriska kolumner data ifyllda för varje rad? Du måste ha en kolumn som heter Person//e-post eller Person//ID .Om någon av dessa kolumner har en tom rad kan det leda till att din importera misslyckas.
• Finns det ogiltiga e-postadresser i din Person//e-post-kolumn? Om du har värden inom Person//e-post som inte har ett giltigt e-postadressformat kan detta leda till att din importera misslyckas.
• Är alla dina kolumner korrekt märkta? Finns det några mellanslag? Se till att alla dina kolumnrubriker stämmer överens med vad som beskrivs i den här guiden. Du bör också se till att det inte finns några mellanslag i kolumnnamnen.

Ytterligare resurser

• Godtagbara datum- och tidsstämpelformat för profil- och händelseegenskaper referens
• Formatering av datum för CSV-filer referens
• Migrera till Klaviyo