Marketinginstellingen

Marketing → Instellingen (/m/marketing/settings) heeft vijf onderdelen in het linkermenu: Verbindingen, AI-pijplijn, Kosten, Imports en Merken. Elke instelling heeft een standaardwaarde, dus je hoeft ze nooit te openen om te starten. De sleutel, agenttokens en merken worden per actie opgeslagen; AI-pijplijn en de maandlimiet onder Kosten sla je op via de balk onderaan.

/m/marketing/settings opent op Verbindingen. Oude links blijven werken: /m/marketing/settings/agent en ?tab=agent openen Verbindingen met Je eigen agent uitgeklapt.

Verbindingen#

Verbindingen (/m/marketing/settings/integrations) bevat de OpenRouter-sleutel, de koppelingen Meta-advertenties en Meta Ad Library van het merk en, onder Meer, Je eigen agent.

OpenRouter#

Het vak OpenRouter bevat de sleutel. De marketing-AI draait op je eigen sleutel, dus het gebruik wordt op je OpenRouter-account in rekening gebracht. Borkol verkoopt of factureert geen AI-tokens. Maak een sleutel aan op openrouter.ai/keys.

Plak hem onder API-sleutel en klik op Sleutel opslaan. De sleutel wordt versleuteld opgeslagen en daarna nooit meer getoond; alleen Sleutel eindigt op (de laatste vier tekens) is zichtbaar. Borkol controleert de sleutel bij OpenRouter als je hem opslaat en Status toont de uitkomst:

Bij een geverifieerde sleutel toont de pagina ook het Sleutellabel, de Tegoedlimiet, het Verbruikt tegoed en het Resterend tegoed zoals OpenRouter ze meldt, en Laatst gecontroleerd. Heeft de sleutel geen limiet, dan blijven de limiet en het resterende tegoed leeg.

• Opnieuw controleren controleert de opgeslagen sleutel opnieuw, bijvoorbeeld na Niet gecontroleerd.
• Sleutel vervangen slaat een andere sleutel op. Weigert OpenRouter de nieuwe sleutel terwijl de opgeslagen sleutel Geverifieerd is, dan blijft de opgeslagen sleutel staan en toont het veld "OpenRouter heeft deze sleutel geweigerd. Je opgeslagen sleutel is behouden." Een geweigerde sleutel zonder geverifieerde sleutel ervoor wordt opgeslagen als Ongeldig, en de pagina meldt "OpenRouter heeft deze sleutel geweigerd. Controleer hem en sla een nieuwe op."
• Sleutel verwijderen vraagt "De OpenRouter-sleutel verwijderen?" en verwijdert hem. Marketing-AI werkt niet meer totdat je opnieuw een sleutel toevoegt.

Alleen de accounteigenaar kan de sleutel toevoegen, opnieuw controleren, vervangen of verwijderen. Teamleden zien de status en de tegoedcijfers, met "Alleen de accounteigenaar kan de sleutel toevoegen, controleren of verwijderen." in plaats van het sleutelveld en de knoppen.

Meta-advertenties#

Het vak Meta-advertenties koppelt het merk waarop je zit aan zijn Meta-advertentieaccount. Borkol leest dan je eigen advertentieresultaten per advertentie en dag (besteding, impressies, weergaven van 3 seconden, ThruPlays, linkklikken, aankopen en omzet) en de lengte van elke videoadvertentie, zodat Wat wint en de lengte van scènes op echte cijfers rusten. Elk merk heeft een eigen koppeling: wissel van merk om een ander advertentieaccount te koppelen.

1. Plak een systeemgebruikerstoken onder Toegangstoken (hieronder staat hoe je er een maakt) en klik op Controleren. Het token wordt versleuteld opgeslagen en daarna nooit meer getoond; alleen Token eindigt op is zichtbaar. Status toont Geverifieerd, Ongeldig (Meta heeft het token geweigerd, met de melding van Meta zelf in een bericht boven de status) of Niet gecontroleerd (Meta was niet bereikbaar: "Het token is opgeslagen, maar Meta was niet bereikbaar om het te controleren. Probeer zo opnieuw te controleren.").
2. Kies het Advertentieaccount waarvan de resultaten naar dit merk worden gesynchroniseerd. De lijst toont de accounts die het token kan lezen, met account-id en valuta; hij verschijnt na een Geverifieerd-controle. "Dit token kan geen enkel advertentieaccount lezen." betekent dat het advertentieaccount nog niet aan de systeemgebruiker is toegewezen.
3. Klik op Nu synchroniseren onder Laatste synchronisatie, of wacht: Borkol synchroniseert elk gekoppeld merk één keer per dag. De eerste synchronisatie leest de laatste 90 dagen, latere de laatste 3 dagen. Een melding toont Advertentieresultaten lezen…, daarna Advertenties synchroniseren: 12 van 40 met een balk, opnieuw na herladen van Verbindingen en terwijl je door de app gaat, en eindigt met hoeveel advertenties zijn gesynchroniseerd of waarom het mislukte.

Laatste synchronisatie toont wanneer de laatste synchronisatie klaar was. Is die mislukt, dan staat erboven een bericht "De laatste synchronisatie is mislukt" met de melding van Meta; de volgende synchronisatie die lukt, haalt het weg. Al gesynchroniseerde resultaten blijven staan als een synchronisatie mislukt.

Gesynchroniseerde resultaten worden opgeslagen zoals een import van advertentieresultaten en koppelen aan een script via de Borkol-advertentiecode in de advertentienaam; advertenties zonder code tellen nog mee voor de lengte. Voor dezelfde advertentie en dag vervangt een gesynchroniseerd resultaat een geïmporteerd resultaat, en een latere import slaat rijen over die al gesynchroniseerd zijn, zodat niets dubbel telt.

• Opnieuw controleren controleert het opgeslagen token opnieuw. Token vervangen slaat een ander token op; weigert Meta dat terwijl het opgeslagen token Geverifieerd is, dan blijft het opgeslagen token behouden ("Meta heeft dit token geweigerd. Je opgeslagen token is behouden.").
• Token verwijderen vraagt "Het Meta-advertentietoken verwijderen?" en verwijdert het. Synchroniseren stopt voor dit merk; al gesynchroniseerde resultaten blijven staan.

Alleen de accounteigenaar kan het token toevoegen, controleren, vervangen of verwijderen en het advertentieaccount kiezen. Teamleden zien de status, het advertentieaccount en Laatste synchronisatie, en kunnen op Nu synchroniseren klikken.

Het toegangstoken aanmaken

Gebruik een systeemgebruikerstoken: het hoort bij je bedrijf, niet bij een persoon, en verloopt niet. Je hebt beheerdersrechten nodig op het Meta-bedrijfsportfolio dat het advertentieaccount bezit.

1. Open business.facebook.com/settings en kies het bedrijfsportfolio dat het advertentieaccount bezit.
2. Maak een app aan op developers.facebook.com/apps: app-type Business, gekoppeld aan dat bedrijfsportfolio. Voeg op het dashboard van de app het product Marketing API toe.
3. Ga in de bedrijfsinstellingen naar Gebruikers → Systeemgebruikers, klik op Toevoegen en maak een systeemgebruiker met de rol Beheerder (Admin).
4. Klik met de systeemgebruiker geselecteerd op Assets toewijzen: wijs het advertentieaccount toe (minstens prestaties bekijken) en de app die je hebt gemaakt.
5. Klik op Token genereren, kies de app, zet de vervaldatum op Nooit en vink de rechten ads_read aan. Kopieer het token: Meta toont het één keer.
6. Plak het in Borkol onder Toegangstoken en klik op Controleren. Je advertentieaccount-id is het getal na act= in het adres van Advertentiebeheer (bijvoorbeeld act=1234567890); kies het account met die id onder Advertentieaccount.

Het token heeft alleen ads_read nodig: Borkol leest resultaten en wijzigt nooit je advertenties.

Meta Ad Library#

Het vak Meta Ad Library koppelt het merk waar je op staat aan de Ad Library van Meta, het openbare archief van advertenties. Borkol leest dan de advertenties van de pagina's en zoektermen op de volglijst van het merk in de swipe file, met een winnaarscore. Elk merk heeft een eigen koppeling.

1. Plak een user token onder Access token (hoe je die krijgt staat hieronder) en klik op Controleren. De token wordt versleuteld opgeslagen en nooit meer getoond; alleen Token eindigt op is zichtbaar. Status toont Geverifieerd, Ongeldig (Meta weigerde de token, met Meta's melding boven de status) of Niet gecontroleerd.
2. Onder Status toont Verloopt wanneer de token stopt met werken. Vanaf 7 dagen ervoor staat boven de status "De token verloopt binnenkort" met de datum; daarna "De token is verlopen". Sla daarvoor een nieuwe token op onder Token vervangen.
3. Klik op Nu synchroniseren onder Laatste synchronisatie, of wacht: Borkol controleert de volglijst één keer per dag. Een melding toont Ad Library controleren: 2 van 5 (volgitems) met een balk, opnieuw na herladen van Verbindingen of de Swipe file en terwijl je door de app gaat, en eindigt met hoeveel items zijn gecontroleerd, hoeveel Meta weigerde of waarom het mislukte. Zonder volgitem zegt Nu synchroniseren "Voeg eerst een pagina of zoekterm toe onder Swipe file, Volgen."

Laatste synchronisatie toont wanneer de laatste controle klaar was; mislukte die, dan staat erboven "De laatste synchronisatie is mislukt" met Meta's melding. Advertenties die al in de swipe file staan blijven als een synchronisatie mislukt of de token wordt verwijderd. Opnieuw controleren, Token vervangen en Token verwijderen werken zoals bij Meta-advertenties. Alleen de accounteigenaar kan de token toevoegen, controleren, vervangen of verwijderen; teamleden zien de status en kunnen op Nu synchroniseren klikken.

De access token krijgen

De Ad Library API werkt met een user token van een Meta-ontwikkelaarsapp waarvan de eigenaar zijn identiteit bij Meta heeft bevestigd.

1. Bevestig je identiteit bij Meta op facebook.com/ID (dat kan een paar dagen duren).
2. Open facebook.com/ads/library/api, lees de voorwaarden en accepteer ze.
3. Maak een app op developers.facebook.com/apps (elk type; een Business-app werkt), of gebruik die van Meta-advertenties.
4. Open de Graph API Explorer, kies je app onder Meta App, kies User Token en klik op Generate Access Token. Er is geen extra permissie nodig. Deze token werkt ongeveer een uur.
5. Plak hem in de Access Token Debugger, klik op Debug en onderaan op Extend Access Token. Kopieer de nieuwe token: die werkt ongeveer 60 dagen.
6. Plak hem in Borkol onder Access token en klik op Controleren. Verloopt toont de datum; herhaal stap 4 tot 6 voor die tijd.

Je eigen agent#

Meer · Je eigen agent, onder het vak OpenRouter, bevat de tokens waarmee een agent die je al draait, zoals Hermes of een andere MCP-client, verbindt met Borkol Marketing. Token aanmaken toont het token één keer, met de drie installatieblokken (Agentconfiguratie (Hermes), Skill, Planning) al ingevuld; Installatie-instructies onder de lijst toont later dezelfde blokken met een plaatshouder. Meer in het aanmaakvenster beperkt een token tot sommige rechten of één merk. Het rijmenu heeft Intrekken. Het klapt vanzelf uit als het merk op je agent draait of er een token actief is. Alleen de accounteigenaar kan tokens aanmaken en intrekken; teamleden zien de lijst zonder Token aanmaken. Zie Je eigen agent.

AI-pijplijn#

AI-pijplijn (/m/marketing/settings/pipeline) bepaalt hoe runs werken voor één merk ("Deze instellingen gelden voor {brand}."). Met meer dan één merk kies je het merk met de merkkiezer naast die regel; wissel je met niet-opgeslagen wijzigingen, dan wordt eerst gevraagd of je die wilt negeren. De andere instellingensecties houden het gekozen merk in de adresbalk (?brand=). Elk veld heeft een standaardwaarde, dus je hoeft deze pagina nooit te openen om te starten. Wijzig je een veld, dan toont de balk onderaan Opslaan en Wijzigingen negeren. Een run houdt de instellingen waarmee hij startte; wijzigingen gelden voor de volgende run.

Vooraan, onder Scripts, staan de twee velden die de meeste mensen wijzigen:

Daaronder stelt het vak Videotool de AI-videotool in waarvoor scènes worden geschreven: Naam (optioneel), Cliplengte (standaard 8 seconden, 2 tot 20; geen scène is langer), Beeldverhouding (standaard 9:16 staand, 1:1 vierkant of 16:9 liggend) en Promptstijl (komt aan het eind van elke videoprompt, tot 300 tekens).

Meer opent de rest, standaard dicht (hij klapt vanzelf open als een verborgen veld een fout heeft). Per run:

Stappen, ook onder Meer, bepaalt het model achter elke stap. De lijst bevat suggesties; je kunt elk OpenRouter-model-id typen, zoals meta-llama/llama-3.3-70b-instruct. Hetzelfde model kun je ook wisselen vanaf een stapkaart op de pagina van een run; zie Het model van een stap wisselen.

Gebruikt Controle hetzelfde model als Scripts, dan staat er "Controle gebruikt hetzelfde model als Scripts. Een ander model vangt meestal meer." Dat houdt opslaan niet tegen.

Ook onder Meer: Wie de stappen uitvoert en Instructies en privacy.

Wie de stappen uitvoert heeft één veld, Stappen draaien op: Borkol (de standaard) voert elke stap uit op je OpenRouter-sleutel; Je agent geeft de stappen aan een agent die je zelf draait, via MCP ("Runs die al gestart zijn houden hun instelling."). Een merk op Je agent heeft geen OpenRouter-sleutel nodig en wordt nooit gepauzeerd op de kostenlimiet. Zie Je eigen agent.

Instructies en privacy bevat:

• Minimale uitgaven voor een inzicht (standaard 50), in de valuta van je advertentieaccount: een tag heeft zoveel uitgaven over zijn advertenties nodig voordat Borkol er een conclusie uit trekt. Zie Hoe inzichten ontstaan.

• Transcriptiemodel (standaard openai/whisper-large-v3-turbo): schrijft het transcript van video- en audiobestanden die je aan swipe-advertenties toevoegt, op je OpenRouter-sleutel. De lijst bevat modellen met een provider zonder dataopslag; openai/whisper-large-v3 en mistralai/voxtral-mini-transcribe zijn de alternatieven.

• Doel-ROAS (standaard leeg): een advertentie op of boven dit rendement op advertentie-uitgaven telt als winnaar. Leeg vergelijkt elke advertentie met de mediaan van het merk.

• Extra instructies per stap, tot 2.000 tekens, die voor dit merk aan die stap worden toegevoegd. Laat ze leeg voor het standaard playbook. De uitvoer van de stap wordt nog steeds getoetst aan zijn vaste vorm.

• Geen dataopslag (ZDR) (standaard aan): prompts gaan alleen naar providers die geen data bewaren. Alleen de accounteigenaar kan dit uitzetten, na het bevestigen van "Geen dataopslag (ZDR) uitzetten?": prompts, inclusief je merkcontext, kunnen dan naar providers gaan die ze bewaren. Teamleden zien "Alleen de accounteigenaar kan dit uitzetten." Elke run legt vast met welke instelling hij draaide, te zien als Geen dataopslag (ZDR) op de pagina van de run. Niet elk model heeft een aanbieder zonder dataopslag. Een stap op zo'n model faalt met "Dit model heeft op OpenRouter geen aanbieder met Geen dataopslag (ZDR)": kies dan een ander model voor die stap.

De AI-pijplijn wijzigen vraagt bewerktoegang tot marketing.

Kosten#

Kosten (/m/marketing/settings/costs) toont wat de runs van het merk kosten tegen kale OpenRouter-prijzen: de uitgaven van deze maand, kosten per script, runs (met hoeveel er met zero data retention uit draaiden), het resterende OpenRouter-tegoed, kosten per dag en elke run met zijn tokens en kosten. Er staat ook de Maandlimiet van het merk (standaard $25), die je opslaat via de balk onderaan; verhogen vraagt de goedkeurrechten. Zie Kosten.

Imports#

Imports (/m/marketing/settings/imports) toont elk bestand dat in het gekozen merk is geïmporteerd, met wat het was, het aantal rijen, hoeveel er zijn toegevoegd, bijgewerkt en overgeslagen, de status, wie het importeerde en wanneer. Opgeslagen kolomkoppelingen daaronder bevat de kolomkeuzes die Borkol onthoudt voor bestanden met dezelfde kolomnamen; Koppeling vergeten verwijdert er een. Een import start je vanuit Scripts of Merk, niet hier. Zie Imports.

Merken#

Merken toont je merken met hun score Inrichting. Elk merk heeft een eigen profiel, klanttypes, citaten, swipe file, documenten, kennis en projecten.

• Merk toevoegen vraagt om een Naam (maximaal 120 tekens) en opent daarna het Overzicht van het nieuwe merk, met het vak en de instelbalk klaar. Zie Een merk instellen.
• Het rijmenu heeft Merk hernoemen, Standaard maken en Merk verwijderen.
• Precies één merk is de Standaard. Dat merk opent als je geen merk kiest. Standaard maken verplaatst het label naar een ander merk.
• Het laatste merk kan niet worden verwijderd.
• Het standaardmerk kan niet worden verwijderd zolang er andere merken zijn. Verwijderen toont dan Maak eerst een ander merk de standaard.

Merk verwijderen vraagt eerst "Dit merk verwijderen?". Het profiel, de klanttypes, stemfragmenten, swipe-advertenties, documenten, kennis en projecten worden meeverwijderd en dit kan niet ongedaan worden gemaakt.