Problemen oplossen bij het importeren van lijsten

Wat je leert

Kom te weten hoe je fouten kunt oplossen die optreden bij het uploaden van een CSV met contactpersonen naar een nieuwe of bestaande lijst in Klaviyo. Reviews uploaden? Ga naar ons artikel over hoe je reviews importeert.

Voordat je van start gaat

Wil je zeker weten dat je bestand wordt geïmporteerd? Controleer de onderstaande lijst met vereisten voordat je je lijst importeert.

• CSV-bestand (geen ander formaat)
• Bestandsgrootte is 50 MB of kleiner
• De eerste rij bevat voor elke kolom een unieke, niet-lege koptekst
• Elke rij heeft een geldige unieke identificatie, zoals een e-mailadres, telefoonnummer of externe ID
• Er zijn geen dubbele e-mailadressen of telefoonnummers

Ons Supportteam kan namens jou geen CSV's importeren in Klaviyo. Als je hulp nodig hebt bij een import, bekijk dan de sectie probleemoplossing hieronder voor tips om problemen met lijstimport succesvol op te lossen.

Inhoudsopgave

• Importvertraging
• Probleemoplossing bij importeren
• Alle kolommen geïmporteerd als één veld
• Foutmeldingen voor ongeldige indeling
• Onjuiste datum- of tijdstempelopmaak
• Foutmeldingen voor dubbele of ontbrekende unieke identificatiecode
• Ontbrekende waarde in een vereist veld
• Problemen met de opmaak van telefoonnummers

Importvertraging

Als je een groot bestand met een aanzienlijke hoeveelheid gegevens importeert, kan het importproces enkele uren duren voordat het is voltooid. Helaas is er geen manier om dit proces te versnellen zodra het is begonnen. Een manier om het importproces alvast sneller te laten verlopen, is om vóór het importeren alle dubbele e-mailadressen uit je CSV te verwijderen. We raden je sterk aan om het importeren van een nieuwe lijst minimaal 1 dag te plannen vóór het moment waarop je van plan bent om de contacten op de lijst te e-mailen.

Nadat een import is gestart, zie je eerst een statusbalk. Als je wegklikt, open je de lijst en selecteer je het tabblad Importen om de voortgang en resultaten te bekijken. We sturen je een e-mail zodra een lijstimport is voltooid.

Probleemoplossing bij importeren

Als het uploaden van je bestand mislukt of sommige rijen worden overgeslagen, check dan de veelvoorkomende fouten hieronder. Zo vind en corrigeer je overgeslagen rijen nadat een import is afgerond:

1. Open de lijst en selecteer het tabblad Importen.
2. Voor een import die is gemarkeerd als Voltooid met fouten, klik je op Foutenbestand downloaden als de knop beschikbaar is.
3. Gebruik de kolom Errors in de gedownloade CSV om de betreffende rijen te identificeren en te corrigeren. Verwijder de kolommen Fouten en Waarschuwingen uit het gecorrigeerde bestand, zodat ze niet worden geïmporteerd als profieleigenschappen.
4. Klik op Nieuw bestand uploaden en upload je gecorrigeerde CSV. Koppel de kolommen, controleer de toestemmingsinstellingen en klik op Importeren om de import te starten.

Als Foutbestand downloaden niet beschikbaar is, controleer dan je oorspronkelijke CSV aan de hand van de onderstaande probleemoplossingsrichtlijnen en corrigeer die voordat je deze opnieuw uploadt.

Alle kolommen geïmporteerd als één veld

Als je een versie van Excel gebruikt die Engels niet als standaardtaal gebruikt, kan je software puntkomma's gebruiken in plaats van komma's als scheidingsteken in je bestand. Als dit het geval is, kan je bestand er bij het importeren zo uitzien:

Ga hiervoor naar de instelling Getalnotatie of Lijstscheidingsteken (of getalscheidingsteken) op je computer. Deze instelling staat waarschijnlijk onder Taal en regio en kan zich bevinden in de sectie Geavanceerde instellingen. Vervang de puntkomma door een komma en sla op. Wanneer je nu bestanden exporteert als CSV, gebruiken ze de komma-indeling. Let op: de exacte locatie van deze instelling kan per besturingssysteem verschillen.

Controleer ook of je CSV overeenkomt met de opmaakvereisten van Klaviyo. Als je dat nog niet hebt gedaan, ga dan naar onze documentatie over het opmaken van je gegevens. Elke rij heeft een geldige unieke id nodig; een e-mailadres is niet vereist als er een andere geaccepteerde id wordt opgegeven.

Problemen oplossen met foutmeldingen over een ongeldig formaat

Wanneer je een lijst in Klaviyo importeert, kun je op de pagina veldtoewijzing alle eigenschappen koppelen aan het bijbehorende gegevenstype in Klaviyo. Zo heeft E-mail altijd het gegevenstype Tekst; maar als je een aangepaste eigenschap voor Verjaardag uploadt, wil je het gegevenstype instellen op Datum.

Bekijk hieronder de gegevenstypen, indelingen voor toestemmingseigenschappen en voorbeelden.

• Tekst
  Elke tekst, of combinatie van tekst en cijfers. Als je niet zeker weet in welke indeling je gegevens staan, kies dan deze optie.
  • Voorbeelden:
    email@example.com
    Hallo, wereld
    $ 5,00
• Nummer
  Alle nummers. Gebruik geen valutasymbolen in numerieke velden.
  • Voorbeelden:
    2
    5,0031
    130,0
• Booleaans
  True- of false-waarden.
  • Voorbeelden:
    waar
    onwaar
• Datum
  Bekijk onze gids met geaccepteerde datum- en tijdnotaties voor profiel- en gebeurteniseigenschappen voor meer informatie over geaccepteerde datumnotaties.
  • Voorbeeld:
    2014-09-01 13:34:08
• Lijst
  Gegevens moeten worden opgemaakt als een JSON-array.
  • Voorbeelden:
    ["appels","bananen","sinaasappels"]
    ["appels"]
• Toestemmingseigenschappen
  Wijs elke toestemmingskolom toe aan de eigenschap voor het kanaal en het toestemmingstype, zoals Toestemming voor e-mailmarketing, Toestemming voor sms-marketing of Toestemming voor transactionele sms. Deze eigenschappen gebruiken het gegevenstype Tekst. Voer "aanmelden", "Nooit aangemeld" of "afmelden" in als waarde.

Bekijk voor meer informatie over wat de verschillende gegevenstypen inhouden en welke je moet selecteren bij het importeren van je lijst onze handleiding over gegevenstypen begrijpen.

Wil je meer weten over foutmeldingen met "Ongeldige indeling voor [gegevenstype]" (bijv. "Ongeldige lijstindeling"), ga dan naar onze gids voor probleemoplossing voor foutmeldingen met ongeldige indelingen.

Onjuiste datum- of tijdstempelopmaak

Je gebruikt mogelijk de verkeerde indeling voor datums of tijdstempels. Als je een van beide hebt opgenomen en niet zeker weet wat de geaccepteerde indelingen van Klaviyo zijn, ga dan naar onze gids over acceptabele datum- en tijdstempelindelingen voor profiel- en gebeurteniseigenschappen.

Bij een foutmelding over een ongeldig toestemmingstijdstempel controleer je of het tijdstempel weerspiegelt wanneer toestemming is gegeven, en op of na 1 januari 1990 valt. Controleer ook de tijdzone: een tijdstempel zonder offset wordt gelezen als UTC, waardoor een lokale tijd in de toekomst kan lijken te liggen.

Problemen oplossen met foutmeldingen over dubbele of ontbrekende unieke identificatiecode

Dubbele identificatiecodes

Fouten met dubbele identificatie betekenen dat meerdere rijen dezelfde profielidentificatie gebruiken, zoals een e-mailadres of telefoonnummer. Klaviyo kan dubbele rijen overslaan, en je moet er niet op vertrouwen dat de eerste rij in je bestand wordt geïmporteerd. Voeg de gegevens van elk contact samen in 1 rij voordat je opnieuw importeert.

Klik op Foutbestand downloaden (indien beschikbaar) om rijen te bekijken die zijn overgeslagen vanwege dubbele identifiers. Controleer de gegevens die je wilt behouden voordat je opnieuw uploadt, omdat geïmporteerde waarden een bestaand profiel kunnen bijwerken.

Ontbrekende unieke identificatiegegevens

Een foutmelding over een ontbrekende unieke identifier betekent dat een overgeslagen rij geen e-mailadres, telefoonnummer of andere geaccepteerde unieke identifier bevatte.

Klik op Foutbestand downloaden, als dit beschikbaar is, om rijen te bekijken die zijn overgeslagen vanwege ontbrekende id's. Voeg een geldige identificatie toe voor elk contact en zorg ervoor dat de kolom is gekoppeld aan de bijbehorende Klaviyo-eigenschap voordat je opnieuw uploadt.

Ontbrekende waarde in een vereist veld

Controleer de velden die vereist zijn voor de informatie die je importeert. Een rij met e-mailtoestemming heeft bijvoorbeeld een e-mailadres nodig, en een rij met sms-toestemming heeft een telefoonnummer nodig. Vul de ontbrekende waarde in of verwijder toestemmingsinformatie die niet van toepassing is op die contactpersoon, voordat je opnieuw uploadt.

Ongeldig e-mailadres of niet-herkende tekens

Als je deze foutmelding ontvangt, controleer je in je bestand of er e-mailadressen met ongeldige tekens staan. Ongeldige tekens zijn onder meer ( ) , : ; [ ], maar ook spaties.

Profielen overzetten tussen accounts

Bij het overzetten van profielen van het ene account naar het andere, zijn er enkele eigenschappen die niet naar een ander account kunnen worden geüpload.

Profiel aangemaakt op kan bijvoorbeeld niet worden overgezet, omdat dit is ingesteld op de datum waarop een profiel in het account wordt aangemaakt. Een andere set voorbeelden zijn Eerst actief en Laatst actief, aangezien deze automatisch worden ingesteld op basis van profielactiviteit in het account.

Problemen met de opmaak van telefoonnummers

Telefoonnummers moeten een landcode bevatten of een aparte kolom die het land aangeeft, en moeten een geaccepteerd telefoonnummerformaat volgen. Ontdek hoe je telefoonnummers op de juiste manier formatteert en uploadt.

Extra hulpbronnen