# Imports

Borkol leert sneller als het begint bij wat je al hebt. Eén importflow neemt een spreadsheet (CSV, TSV of Excel `.xlsx`) en maakt van de rijen scripts, advertentieresultaten, creatives, swipe-advertenties of klantcitaten. Je start hem vanaf het scherm waar de gegevens thuishoren; er is geen aparte importpagina.

## Waar Importeren staat

| Scherm | Knop | Wat je kunt importeren |
| --- | --- | --- |
| **Marketing** → **Scripts** | **Meer** (onder **Importeren**) | **Scriptgeschiedenis**, **Advertentieresultaten**, **Creatives** |
| **Marketing** → **Merk** → **Je stem** → **Stem van de klant** | **Importeren** | **Klantcitaten** |
| **Marketing** → **Merk** → **Meer** → **Swipe file** | **Importeren** | **Swipe-advertenties** |

Een script zonder resultaten linkt naar de import van advertentieresultaten vanuit de regel "Resultaten verschijnen hier na een import.", en een leeg tabblad **Inzichten** onder Kennis heeft **Advertentieresultaten importeren**.

Elke import gaat naar het merk dat bovenaan het scherm is gekozen.

## Het bestand

- CSV, TSV of `.xlsx`, tot 5 MB en 5.000 rijen. De eerste rij bevat de kolomnamen.
- Komma's, puntkomma's en tabs werken allemaal als scheidingsteken, dus een csv uit een Nederlands of Turks spreadsheetprogramma kun je ongewijzigd importeren. Datums mogen als `2026-10-20`, `20/10/2026`, `20.10.2026` of als datumcel uit een spreadsheet; één duidelijke waarde zoals `13/10/2026` bepaalt dat de hele kolom met de dag begint.
- Van een Excel-bestand wordt het eerste blad gelezen.
- Voor klantcitaten werkt ook een gewoon `.txt`-bestand: één citaat per regel, zonder kolomnamen.

Een bestand zonder rijen onder de kolomnamen wordt geweigerd met "Het bestand heeft geen rijen onder de kolomnamen." Een bestand met meer dan 5.000 rijen wordt geweigerd met "Het bestand heeft meer dan 5.000 rijen. Splits het en importeer de delen." In beide gevallen wordt er niets toegevoegd.

## Hoe kolommen worden herkend

Borkol leest de kolomnamen en koppelt ze aan zijn eigen velden, in het Engels, Nederlands en Turks, zonder op hoofdletters, accenten of tekst tussen haakjes te letten. `Amount spent (USD)` wordt **Uitgegeven**, `Datum` wordt **Datum**, `Yorum` wordt **Citaat**. Het paneel toont dan "We hebben 9 van 9 kolommen herkend" en gaat meteen naar het voorbeeld.

Dit zijn de kolomnamen die Borkol herkent (een selectie; hoofdletters maken niet uit):

| Wat | Veld | Kolomnamen |
| --- | --- | --- |
| **Advertentieresultaten** | **Advertentienaam** (verplicht) | Ad name, Ad, Ad code, Creative name, Advertentienaam, Reklam adı |
| | **Datum** | Day, Date, Reporting starts, Datum, Dag, Tarih |
| | **Uitgegeven** (verplicht) | Amount spent, Spend, Cost, Uitgegeven bedrag, Harcanan tutar |
| | **Videolengte** | Video length, Length, Duration, Video duration, Videolengte, Lengte, Video süresi |
| | **Vertoningen** | Impressions, Impr, Vertoningen, Gösterimler |
| | **Weergaven van 3 seconden** | 3-second video plays, 3s video views, Video plays at 3s |
| | **ThruPlays** | ThruPlays, Video completions, Completed views |
| | **Klikken** | Clicks, Link clicks, Klikken, Tıklamalar |
| | **Aankopen** | Purchases, Conversions, Orders, Aankopen, Satın almalar |
| | **Omzet** | Purchase conversion value, Revenue, Conversion value, Omzet, Gelir |
| | **Valuta**, **Kanaal** | Currency, Valuta; Channel, Platform |
| **Scriptgeschiedenis** | **Titel**, **Invalshoek** | Title, Name, Script name; Angle, Concept |
| | **Hook** tot **Hook 5** | Hook, Hook 1, Opening line; Hook2 tot Hook5 |
| | **Script**, **Call to action** | Body, Script, Voiceover; CTA, Call to action |
| | **Advertentietekst** tot **Advertentietekst 3** | Ad copy, Primary text, Caption |
| | **Soort hook**, **Formaat**, **Bewustzijn**, **Klanttype** | Hook type; Format; Awareness; Customer type, Persona, Audience |
| | **Advertentiecode**, **ID**, **Status**, **Datum** | Ad code, Code, Ad name; ID, External ID; Status; Date, Created |
| **Creatives** | **Advertentiecode** (verplicht), **Link** (verplicht) | Ad code, Ad name; URL, Link, Creative URL, Video URL |
| | **Editor**, **Lanceerdatum**, **Notities** | Editor, Made by, Creator; Launched, Launch date, Start date; Notes |
| **Swipe-advertenties** | **Titel**, **Link**, **Transcript** | Title, Name, Headline; URL, Link, Ad link; Transcript, Copy, Primary text |
| | **Notities**, **Tags**, **Project** | Notes, Comments; Tags, Labels, Category; Project, Campaign |
| **Klantcitaten** | **Citaat** (verplicht), **Thema** | Text, Review, Comment, Quote, Feedback; Theme, Topic, Category |
| | **Klanttype**, **Bron** | Customer type, Persona, Segment; Source, Reference, Review ID |

Een swipe-advertentie heeft minstens een titel, een link of een transcript nodig. Een rij scriptgeschiedenis heeft minstens een hook of een script nodig.

## De koppelstap

Als een kolom meer dan één ding kan betekenen (bijvoorbeeld `Comment theme`, dat zowel "comment" als "theme" bevat), of als een verplicht veld geen kolom heeft, opent het paneel de koppeltabel voor je: **Kolom in je bestand**, **Voorbeeld** en **Importeren als**. Onduidelijke kolommen krijgen **Controleer**. Kies voor elke kolom een veld, of **Negeren**. Zolang een verplicht veld geen kolom heeft, zegt het paneel "Kies onder Meer een kolom voor {fields} voordat je importeert." en blijft de importknop uit.

Als alles is herkend, blijft de tabel ingeklapt onder **Meer**. Open hem om een kolom te controleren of te wijzigen.

Kies je zelf kolommen, dan onthoudt Borkol die keuze voor bestanden met dezelfde kolomnamen, zodat de export van volgende week zichzelf koppelt. Opgeslagen keuzes gelden per bedrijf en staan in **Instellingen** → **Imports** onder **Opgeslagen kolomkoppelingen**, waar **Koppeling vergeten** er een verwijdert.

## Voorbeeld en importeren

Het voorbeeld toont hoeveel rijen klaar zijn ("2 rijen klaar") en hoeveel er worden overgeslagen, met de eerste rijen zoals ze worden geïmporteerd. Ontbrekende gegevens zijn een hint, nooit een blokkade: bijvoorbeeld "Geen kolom met vertoningen of weergaven van 3 seconden: hook rates blijven leeg." of "Rijen zonder datum worden op vandaag geboekt."

Klik op **2 rijen importeren**. **Import klaar** toont hoeveel rijen zijn **Toegevoegd**, **Bijgewerkt** en **Overgeslagen**, en **Alle imports bekijken** opent de geschiedenis.

### Overgeslagen rijen

Een rij met een probleem wordt overgeslagen, en de andere rijen komen toch binnen. **2 overgeslagen rijen** onder het voorbeeld toont ze elk met rijnummer, veld en reden, bijvoorbeeld "Rij 14, Uitgegeven: geen getal". Veelvoorkomende redenen: **leeg** (een verplichte cel), **geen getal**, **geen datum**, **onder nul**, **geen weblink**, **te lang**.

## Opnieuw importeren

Imports kun je veilig herhalen. Upload elke week de resultaten van die week: rijen die Borkol al heeft worden bijgewerkt, niet dubbel toegevoegd.

| Wat | Een rij is dezelfde bij |
| --- | --- |
| **Advertentieresultaten** | Dezelfde advertentiecode en dezelfde dag |
| **Scriptgeschiedenis** | Hetzelfde **ID**, anders dezelfde **Advertentiecode** |
| **Creatives** | Hetzelfde script en dezelfde link |
| **Swipe-advertenties** | Dezelfde link |
| **Klantcitaten** | Dezelfde citaattekst |

Een geïmporteerd script verandert nooit een script dat Borkol schreef: een rij waarvan de advertentiecode bij een script uit Borkol hoort, wordt overgeslagen met "code van een script uit Borkol, niet gewijzigd". Een script dat iemand goedkeurde, afwees of in de gouden set zette, blijft ook zoals het is: die rij wordt overgeslagen met "beoordeeld of gouden script, niet gewijzigd".

Een rij met advertentieresultaten voor een advertentie en dag die de [koppeling Meta-advertenties](/nl/docs/marketing/settings#meta-advertenties) al heeft gesynchroniseerd, wordt overgeslagen met "al gesynchroniseerd vanuit Meta-advertenties": de gesynchroniseerde cijfers komen rechtstreeks van Meta, zodat niets dubbel telt.

Een swipe-advertentierij waarvan de link hoort bij een advertentie uit de [Meta Ad Library](/nl/docs/marketing/brand-context#concurrenten-volgen) wordt overgeslagen met "hoort bij een advertentie uit de Meta Ad Library": die advertenties worden bij elke synchronisatie bijgewerkt en een import verandert ze nooit.

## Wat elke import doet

- **Advertentieresultaten** worden gekoppeld aan hun script via de advertentiecode in de advertentienaam, en staan daarna bij het script onder **Resultaten** en voeden [inzichten](/nl/docs/marketing/learning). Een resultaat zonder bekende code in de advertentienaam wordt bewaard en koppelt zodra het script bestaat (bijvoorbeeld nadat je je scriptgeschiedenis importeert).
- **Scriptgeschiedenis** voegt eerdere scripts toe met **Geïmporteerd** als bron. Een rij zonder advertentiecode krijgt een nieuwe Borkol-code. De kolom **Status** koppelt woorden als `live`, `winner` of `actief` aan **Goedgekeurd** en `paused`, `gepauzeerd` of `loser` aan **Afgekeurd**; al het andere wordt als **Goedgekeurd** geïmporteerd.
- **Creatives** koppelen je afgemaakte advertenties (een videolink per advertentiecode) aan hun script; ze staan bij het script onder **Creatives**. Een rij waarvan de advertentiecode bij geen enkel script hoort, wordt overgeslagen met "geen script met deze code".
- **Swipe-advertenties** en **Klantcitaten** komen in de [Swipe file en Stem van de klant](/nl/docs/marketing/brand-context). Een project of klanttype dat het merk niet heeft, blijft leeg, met een hint.

Alles wat je importeert wordt als gegevens behandeld. In een briefing staat het als citaat, nooit als instructie.

## Instellingen → Imports

**Marketing** → **Instellingen** → **Imports** (`/m/marketing/settings/imports`) toont elk bestand dat in het gekozen merk is geïmporteerd: **Bestand**, **Wat**, **Rijen**, **Toegevoegd**, **Bijgewerkt**, **Overgeslagen**, **Status** (**Geïmporteerd**, **Niet geïmporteerd** of **Mislukt**), **Door** en **Wanneer**. Filter op **Wat** en **Status**. Daaronder staan de **Opgeslagen kolomkoppelingen**.

Importeren vraagt bewerktoegang tot marketing. Geüploade bestanden worden privé bij de import bewaard en zijn nooit openbaar.