Ad-platforms

Pitchfire koppelt aan tien ad-platforms via hun officiële API: Meta, LinkedIn, TikTok, Snapchat, Google, Microsoft (Bing), Pinterest, Reddit, Amazon en OpenAI (advertenties in ChatGPT). Eén keer per brand connecteren; cijfers stromen elk uur binnen zodra het platform metrics-sync heeft. Meta en OpenAI streamen vandaag al, de rest rolt per platform uit.

Connecties-overzicht

Onder Connecties in de zijbalk vind je twee secties: bovenaan CRM (Flowd), eronder de tien ad-platforms. Status-badges tonen verbonden, verlopen of fout.

2Advertising overzicht

Onder Advertising in de zijbalk staat het cross-platform overzicht: spend, impressions, leads, gemiddelde CTR over de gekozen periode. Daaronder een staaf-vergelijking per platform en een tabel met alle ad-campagnes (ongeacht platform).

OpenAI Ads (ChatGPT)

OpenAI Ads werkt anders dan de andere platformen: je verbindt niet via OAuth maar met een API-key die je zelf aanmaakt in Ads Manager → Settings op ads.openai.com. Plak die key bij Connecties → OpenAI Ads → Verbinden; Pitchfire valideert ze meteen bij OpenAI en bewaart ze versleuteld. De key is gekoppeld aan één ad-account, dus een account kiezen hoeft niet. Campagnes en dagelijkse cijfers (impressies, kliks, spend) synchroniseren daarna elk uur. Let wel: OpenAI Ads is vandaag in bèta en enkel beschikbaar voor geverifieerde Amerikaanse adverteerders.

OpenAI Ads conversies

Naast de campagnecijfers kan Pitchfire je conversies ook server-side terugsturen naar OpenAI. Je stelt dat in onder Connecties → Attributie → OpenAI Ads conversies met twee velden: je pixel-ID en je Conversions-API-sleutel. Die sleutel is een andere dan je Ads-API-key; beide maak je aan op ads.openai.com, de conversie-gegevens in Ads Manager → tabblad Conversions. De sleutel wordt AES-256-GCM versleuteld bewaard.

Wat er verstuurd wordt en wanneer. Exact dezelfde momenten als bij Meta: zet je een lead op gekwalificeerd, dan gaat er een lead_created-event weg; zet je hem op gewonnen, dan een order_created-event met de dealwaarde in centen plus de valuta. E-mail, telefoon, voor- en achternaam gaan enkel als SHA-256-hash mee (genormaliseerd: getrimd en in kleine letters, telefoon als 8 tot 15 cijfers); land, regio, stad en postcode gaan mee als we die kennen. Het event-ID is stabiel per lead en per type, dus dezelfde statuswijziging twee keer doorvoeren telt maar één conversie: OpenAI dedupliceert op pixel + type + ID en houdt de eerste.

Testmodus. Zet je de testmodus aan, dan wordt elk event wel verstuurd en volledig gevalideerd, maar registreert OpenAI niets. Met de knop Verbinding testen stuur je los daarvan één testevent dat bewijst dat je pixel-ID en sleutel aanvaard worden, opnieuw zonder dat er iets geregistreerd wordt. Pitchfire controleert elk event bovendien eerst zelf (verplichte velden, tijdsvenster van 7 dagen), omdat bij OpenAI één slecht event de hele batch doet mislukken.

Meten versus bieden. Conversies meten werkt meteen zodra pixel-ID en sleutel ingevuld zijn, daar is niets extra voor nodig. Wil je OpenAI ook laten bieden op die conversies (conversie-geoptimaliseerde campagnes), dan moet OpenAI dat apart activeren voor je ad-account. Dat vraag je aan bij je OpenAI-partnercontact. Zolang dat niet gebeurd is, geeft een conversie-campagne de melding Conversion bidding is not enabled; Pitchfire toont je dan meteen wat je moet doen. Optimaliseren kan enkel op de standaardevents order_created, lead_created en registration_completed, niet op eigen custom events.

Meta Conversions API

Onder Connecties → Attributie stel je per brand de Meta Conversions API in: pixel/dataset-ID plus CAPI-token (versleuteld bewaard), optioneel een test event code. Pitchfire stuurt dan server-side een Lead-event bij kwalificatie en een Purchase-event (met dealwaarde) bij een gewonnen deal, gededupliceerd met je pixel via event_id. Zo leert Meta van je échte funnel-uitkomsten, niet enkel van klikken.

Shopify

Onder Connecties → E-commerce koppel je per brand een Shopify-shop: vul jouwshop.myshopify.com in en doorloop de OAuth-flow. Orders en omzet synchroniseren elke 3 uur (met een knop voor manuele sync) en op de kaart zie je meteen je ROAS: omzet gedeeld door ad spend.

Budget-bewaking

Elke actieve campagne met een budget wordt elk uur afgetoetst aan de werkelijke ad spend van de gekoppelde ad-campagnes. Bij 80% van het budget krijg je een melding in Slack of Teams, bij 100% opnieuw. Zet je op de campagnepagina Pauzeer advertenties automatisch bij budget aan, dan pauzeert Pitchfire bij 100% de gekoppelde Meta- en OpenAI-campagnes automatisch. Voor andere platformen krijg je de vraag om zelf te pauzeren. Verhoog je het budget, dan staat de bewaking vanzelf weer op scherp.

Flowd CRM verbinden

Klik in Connecties bovenaan op Flowd verbinden. De wizard heeft vier stappen:

1. Genereer een API-sleutel in Flowd (Instellingen → API Keys)
2. Plak die in Pitchfire + vul je Flowd-instance-URL in (bv. crm.gotrust.be)
3. Test de verbinding: een succesvolle ping toont je naam en hoeveel pipelines en users er zijn
4. Kies default pipeline + stage + owner voor nieuwe deals; sla op

Volgende stap

Bekijk hoe leads naar Flowd stromen of automation workflows opzetten.