Hoe handmatig historische gebeurtenisgegevens importeren

Wat je leert

Leer hoe je handmatig historische gebeurtenisgegevens importeert naar Klaviyo. Hoewel we het gebruik van door Klaviyo gebouwde integraties met platforms zoals Shopify, Magento en BigCommerce en onze API voor aangepaste integraties aanbevelen, is het ook mogelijk om deze gegevens handmatig toe te voegen. Een veelvoorkomend voorbeeld hiervan is het toevoegen van historische aankoopgegevens van een vorig e-commerce platform waar Klaviyo geen ingebouwde integraties voor heeft.

Houd er rekening mee dat er een limiet is van 50 MB voor CSV uploads. 

Formatteer je gegevens

De eerste stap is het correct opmaken van je gegevens in een CSV-bestand. Hieronder zie je een voorbeeld van geplaatste bestelgegevens, samen met een beschrijving van de onderstaande velden. Elke rij in je CSV-bestand moet een actie of activiteit vertegenwoordigen die iemand heeft uitgevoerd, zoals "Gekocht product" of "Aangemeld voor webinar." Als je meerdere acties wilt volgen, moet je ze als aparte CSV-bestanden uploaden. Email adres moet eerst komen als je je CSV uploadt.

Hier zijn een paar voorbeeld gebeurtenis-CSV's die je kunt gebruiken bij het formatteren van je gegevens.

Verplichte velden

De 2 verplichte velden zijn een tijdstempel om aan te geven wanneer de gebeurtenis plaatsvond en een klant eigenschap (een e-mail of een unieke ID) om aan te geven wie de actie heeft uitgevoerd.

• Tijdstempel: Een tijdstempel met de dag en tijd van de gebeurtenis. Het formaat is JJJJ-middenbedrijf-DD HH:middenbedrijf:SS. Bijvoorbeeld, 13:30 op 14 november 2012 zou zijn: 2012-11-14 13:30:00.

  Als twee of meer gebeurtenissen in je CSV-bestand dezelfde tijdstempel hebben, moet je een unieke $event_id toevoegen, anders wordt slechts één van de gebeurtenissen geïmporteerd en wordt de rest overgeslagen. Zie de paragraaf over $event_id hieronder.

• Persoon//Email of Persoon//ID: Waarschijnlijk gebruik je een e-mail om je klant te identificeren. Sommige klanten gebruiken ook een uniek ID. Je kunt ze allebei gebruiken als je dat wilt.

Optionele velden

Er zijn 2 speciale velden om op te letten.

• $event_id: Dit is een unieke identificatiecode voor het evenement. In de praktijk moet je een $event_id sturen als je een unieke identificatie hebt voor elke gebeurtenis (bijvoorbeeld een bestel-ID). Je moet ook de $event_id instellen als je verwacht dat bepaalde gebeurtenissen op hetzelfde moment plaatsvinden. Dit kan gebeuren als iemand één actie onderneemt die je opsplitst in meerdere gebeurtenissen. Als iemand bijvoorbeeld meerdere artikelen koopt, wil je misschien 1 gebeurtenis registreren voor elk gekocht artikel.
  
  In de 2 voorbeeldgegevensverzamelingen hieronder is er 1 geplaatste bestelgebeurtenis, samen met 3 bestelde productgebeurtenissen (1 voor elk product in de geplaatste bestelling). Al deze gebeurtenissen hebben dezelfde tijdstempel, maar ze worden allemaal geïmporteerd omdat ze elk een unieke $event_id hebben. Als de $event_ids identiek zijn, of als ze afwezig zijn, dan wordt slechts één van de gebeurtenissen geïmporteerd en worden de andere overgeslagen.
  
• $waarde: Gebruik dit veld als de gebeurtenis die je importeert een waarde bevat. Als je bijvoorbeeld gegevens van geplaatste bestellingen importeert, heeft elke bestelling een waarde. Je hoeft je waarden niet vooraf te laten gaan door een $ of een ander valutasymbool.

Als je aanvullende gegevens hebt over de persoon die iets heeft gedaan, dan moeten die in een kolom komen waarvan het label begint met Persoon// en dan het soort gegevens dat die kolom heeft. Als je bijvoorbeeld het bedrijf of de organisatie hebt waartoe elke persoon behoort, dan zou je die kolom Person//Organization willen labelen. Het speciale voorvoegsel laat ons weten dat we de gegevens in die kolom moeten associëren met elke persoon in plaats van met de activiteit. Hieronder staan speciale kolommen die je kunt gebruiken om mensen te identificeren:

• Persoon//First Name: voornaam
• Persoon//Last Name: achternaam
• Persoon/Telefoon: telefoonnummer
• Persoon//Organization: organisatie
• Persoon//Title: functie

Als je aanvullende gegevens hebt over elke actie, kun je die opnemen in extra kolommen met de labels die je maar wilt. Als iemand bijvoorbeeld iets koopt en je wilt weten welk artikel hij gekocht heeft, dan kun je die gegevens opnemen in een kolom met de titel Item Purchased. Hieronder staan enkele voorbeelden.

• Gekocht artikel
• Item Categorie
• Product
• Locatie

Als je geen gegevens hebt voor een bepaalde kolom, laat hem dan leeg en we negeren hem. Als je bijvoorbeeld iemands organisatie niet kent, kun je de kolom voor Persoon//Organization leeg laten en slaan we tracking over voor die rij in je gegevens.

Als je klaar bent met het formatteren van je gegevens, sla ze dan op in een CSV-bestand.

Upload een CSV-bestand met gegevens

Nadat je gegevens goed zijn geformatteerd, ga je naar Klaviyo. 

1. Selecteer in Klaviyo het tabblad Integraties.
2. Selecteer 'Gegevensbeheer' > eer 'Importeren via CSV'.
3. Je wordt gevraagd om je CSV-bestand te uploaden en klikt dan op Volgende.
4. Je krijgt de mogelijkheid om het evenement een naam te geven. Als je de geïmporteerde gegevens probeert te koppelen aan een evenement meetwaarde die al bestaat in je account, zorg er dan voor dat je de naam van het evenement precies zo typt als hij al bestaat.
5. Als je je evenement een naam hebt gegeven, kun je hieronder een voorbeeld van je gegevens bekijken.
6. Als je klaar bent om je gegevens te importeren, klik je op Volgende. Je bestand wordt nu verwerkt en je kunt de pagina verlaten. 

Opmerking voor webshop laden aankoopgegevens

Als je aankoopgegevens uploadt, moet je twee bestanden uploaden: een voor de hele bestelling en een tweede met gegevens per artikel.  Een klant kan bijvoorbeeld een bestelling plaatsen voor meerdere producten. In dit geval zou er 1 gebeurtenis zijn voor de geplaatste bestelling en vervolgens aparte gebeurtenissen voor elk van de bestelde producten. Zo zouden de headers van die bestanden eruit moeten zien:

Bestelling geplaatst

Product besteld

We gebruiken de $ niet als voorvoegsel voor bestelwaarde. Gebruik alleen getallen om de prijs of waarde van een bestelling aan te geven. Door de $value header te gebruiken, worden de gegevens correct ingevuld in je Klaviyo account.

De reden om twee meetwaarden op te nemen is dat het dan makkelijker is om later e-mail te triggeren op basis van zowel een algehele bestelling als op basis van specifieke categorieën/artikelen.

Voor Gebeurtenissen Besteld product moet $event_id een unieke identificatie zijn voor elke combinatie van de bestelling en het bestelde product. Een gemakkelijke manier om een unieke identificatie te maken is door de ID van de bestelling en de ID van het product te combineren, zoals in het voorbeeld hierboven.

Problemen met importeren oplossen

Hieronder staan enkele veelvoorkomende problemen en oplossingen die je kunt tegenkomen bij het handmatig importeren van historische gebeurtenisgegevens.

Mijn importeren duurt lang

importeren kan tussen de 5 minuten en 24 uur duren, afhankelijk van de grootte van je lijst. We raden je ten zeerste aan om ten minste 24 uur voordat je een lijst nodig hebt te beginnen met importeren, zodat het importeerproces je verzending niet vertraagt.

Mijn importeren blijft mislukken

Als je importeren mislukt, komt dat waarschijnlijk door een van de volgende redenen:

• Is je bestand een .csv-bestand? Je bestand moet in .csv zijn formaat. Als je een Excel-bestand of een .txt probeert te uploaden bestand, zal het importeren mislukken.
• Heb je de Timestamp-kolom goed opgemaakt? Je moet de datum en tijd opmaken als JJJJ-middenbedrijf-DD HH:middenbedrijf:SS. Bijvoorbeeld, 13:30 op 14 november zou zijn: 2012-11-14 13:30:00. Als tweede controle open je je CSV in een tekstverwerker om er zeker van te zijn dat achterliggende 0's in je tijdstempels niet worden weggestreept wanneer je je CSV-bestanden opslaat of exporteert. Als je werkt met gegevens in een spreadsheet, zorg er dan voor dat de Timestamp-cellen zijn ingesteld op het juiste tijdstempelformaat.
  
• Zijn er voor alle vereiste kolommen gegevens ingevuld voor elke rij? Je moet een kolom hebben met het label Persoon//Email of Persoon//ID .Als een van deze kolommen een lege rij heeft, kan je importeren mislukken.
• Staan er ongeldige e-mailadressen in de kolom Persoon//Email? Als je waarden hebt binnen de Person//Email die geen geldig e-mailadresformaat hebben, kan dit ervoor zorgen dat het importeren mislukt.
• Zijn al je kolommen correct gelabeld? Zijn er spaties? Zorg ervoor dat al je kolomkoppen overeenkomen met wat er in deze handleiding staat. Je moet er ook voor zorgen dat er geen spaties in je kolomnamen staan.

Extra hulpbronnen

• Aanvaardbare datum- en tijdstempelformaten voor referentie van profiel- en gebeurteniseigenschappen
• Datums opmaken voor CSV-bestanden
• Migreren naar Klaviyo