Aan de slag
Hoe stel je de Facebook Conversion API (CAPI) in met Product Feed Elite
  1. Home
  2. Kennisbank
  3. Integratie
  4. Hoe stel je de Facebook Conversion API (CAPI) in met Product Feed Elite

Hoe stel je de Facebook Conversion API (CAPI) in met Product Feed Elite

Als je de Facebook Pixel al gebruikt, maar meer betrouwbare conversietracking wilt, vooral voor gebruikers met advertentieblokkers of beperkte cookies, helpt de Conversions API (CAPI) deze hiaten op te vullen.

Genereer een CAPI-toegangstoken in Meta, koppel het aan Product Feed Elite, en uw winkel stuurt gebeurtenissen vanaf zowel de browser als de server.

Het gebruik van zowel de Pixel (browser) als CAPI (server) verbetert de nauwkeurigheid van de tracking en zorgt ervoor dat je advertentiegegevens completer zijn.

Als u uw Facebook-catalogusfeed nog niet hebt ingesteld, begin dan eerst met Hoe stel ik een Facebook Catalogus productfeed in. De Pixel en CAPI-trackinglaag werkt naast die feed om conversies terug te rapporteren aan Meta.

Vereisten

Zorg ervoor dat het volgende aanwezig is voordat u Facebook Conversions API (CAPI) inschakelt.

VereisteWat dit betekent
WooCommerceInstalleer en voer WooCommerce uit met je actieve winkel. Zorg ervoor dat de pagina's winkelwagen, afrekenen en orderbevestiging (bedankt) correct werken.
Product Feed ProInstalleer en activeer de Product Feed Pro-plugin. De functie Facebook Pixel is inbegrepen in Product Feed Pro. Vind de relevante instellingen in Product Feed → Instellingen → Algemeen.
Product Feed EliteInstalleer, activeer en licentieer Product Feed Elite. Elite maakt de Conversions API (CAPI) en rijkere server-side tracking mogelijk bovenop de Facebook Pixel die door Product Feed Pro wordt geleverd.
Facebook Pixel IDHaal een Pixel ID op uit Meta Events Manager en voer deze in uw instellingen in om uw website-tracking te koppelen aan uw Meta-account.
CAPI-toegangstokenGenereer een CAPI-toegangstoken in Meta Events Manager voor dezelfde Pixel (of dataset) die u in WooCommerce gebruikt. Zie hoe u uw Conversions API-toegangstoken maakt hieronder.

Je moet eerst de Facebook Pixel inschakelen voordat je de Conversions API gebruikt.

De Conversions API werkt samen met de Pixel, niet als vervanging. De Pixel stuurt gebeurtenissen vanuit de browser; CAPI stuurt dezelfde gebeurtenissen vanaf uw server om de nauwkeurigheid van de tracking te verbeteren.

Maak je Conversions API-toegangstoken aan in Meta

De plugin stuurt servergebeurtenissen naar Meta met behulp van een toegangstoken dat bij uw Pixel hoort (Meta rolt ook de formulering dataset uit voor dezelfde onderliggende gegevensbron). Genereer de token nadat u weet welk Pixel ID u in Product Feed Pro invoert.

Voordat je begint

  • Log in met een Meta-account dat volledige controle of beheer toegang heeft tot het Bedrijf dat de Pixel bezit.
  • Als Toegangstoken genereren ontbreekt, heeft uw gebruiker waarschijnlijk niet de juiste rol voor het bedrijf of de Pixel. Vraag een Bedrijfsbeheerder om toegang te verlenen of de token voor u te genereren.
  • De numerieke Pixel ID in de Product Feed-instelling moet overeenkomen met de Pixel/dataset die u hebt geselecteerd bij het maken van deze token. Als ze verschillen, zal Meta gebeurtenissen afwijzen of ze toeschrijven aan de verkeerde bron.

Stappen in Events Manager

  1. Open Meta Events Manager.
  2. Klik in de linkerzijbalk onder Gegevensbronnen (of Datasets) op de Pixel die u op uw WooCommerce-winkel gebruikt.
  3. Open het tabblad Instellingen voor die Pixel (tandwielpictogram of bovenstaande Instellingen, afhankelijk van de lay-out van Meta).
  4. Scroll naar de sectie Conversions API.
  5. Zoek naar Toegangstoken genereren (het kan onder Handmatig instellen, Directe integratie instellen of vergelijkbare bewoordingen staan die Meta gebruikt in het CAPI-installatieproces).
  6. Klik op Toegangstoken genereren. Meta kan u vragen om machtigingen of welke app het token mag gebruiken te bevestigen. Voltooi die prompts.
  7. Wanneer Meta de token-string toont, klik op Kopiëren. Bewaar het in een wachtwoordbeheerder; Meta toont het vaak slechts één keer en u kunt het volledige geheim later niet meer ophalen.
  8. Als u de token kwijtraakt, klik opnieuw op Intrekken / Toegangstoken genereren in hetzelfde Conversions API-gebied, plak dan de nieuwe token in Productfeed → Instellingen → Algemeen → Voer uw Facebook Conversion API-token in en sla op.
Meta Events Manager-tabblad Instellingen met de knop Toegangstoken genereren in de sectie Conversions API

Als u de knop Toegangstoken genereren niet kunt zien

  • Bevestig dat u Instellingen hebt geopend op de juiste Pixel (niet de Pixel van een ander advertentieaccount).
  • Open het tabblad Overzicht en zoek naar Conversions API instellen of Aan de slag. Sommige accounts begeleiden u eerst bij het maken van een token via dit installatieproces.
  • Zie de handleiding van Meta: Aan de slag met de Conversions API (officiële ontwikkelaarsdocumentatie). Meta kan de interface wijzigen, afhankelijk van de regio of het accounttype, dus raadpleeg hun documentatie als de labels enigszins afwijken.

Nadat u het token hebt gegenereerd

  • Voer de token nooit in Git in, plak deze niet in openbare forums en stuur deze niet onversleuteld per e-mail.
  • Plak het alleen in Productfeed → Instellingen → Algemeen → Voer uw Facebook Conversion API-token in (zie de onderstaande stappen).

Schakel de Facebook Pixel in

  1. Ga naar WP Admin → Productfeed → Instellingen.
  2. Open het tabblad Algemeen.
  3. Bekijk de instellingen voor Facebook Pixel en Conversions API.

Sommige opties, waaronder Facebook Conversie API inschakelen en het CAPI-tokenveld, zijn alleen beschikbaar met Product Feed Elite.

Om de Pixel in te schakelen:

  1. Schakel Facebook Pixel toevoegen in.
  2. Voer uw Facebook Pixel ID in. Gebruik een numeriek ID groter dan nul; anders slaat de plugin de snippet over.
  3. Opslaan uw instellingen.
Productfeedinstellingen Algemeen tabblad met de schakelaar Facebook Pixel toevoegen en het veld Pixel-ID

Schakel de Facebook Pixel in voordat u de Conversions API (CAPI) gebruikt. Als u de Pixel uitschakelt, verzendt de plugin geen CAPI-gebeurtenissen.

Schakel Facebook Conversie API in en voeg uw token toe

  1. Schakel Facebook Conversion API inschakelen in.
  2. Plak uw Conversions API-toegangstoken in het veld Voer uw Facebook Conversie API-token in.
  3. Klik op Wijzigingen opslaan.
Productfeedinstellingen Algemeen tabblad met de schakelaar Facebook Conversions API inschakelen en het veld voor toegangstoken

Eenmaal ingeschakeld, verzendt uw winkel gebeurtenissen naar Meta met behulp van beide:

  • De Facebook Pixel (browser-tracking), en
  • De Conversions API (server-side tracking).

Deze combinatie verbetert de betrouwbaarheid van tracking en helpt Meta conversies nauwkeuriger te meten.

Zie voor meer details de link Lees meer naast de CAPI-instelling.

Hoe Conversions API werkt met de Facebook Pixel

Wanneer een bezoeker interactie heeft met uw winkel, kan Product Feed Elite trackinggebeurtenissen op twee manieren naar Meta verzenden:

  1. Vanuit de browser met de Facebook Pixel
  2. Vanaf uw server met de Conversions API (CAPI).

Beide methoden kunnen dezelfde gebeurtenis aan Meta rapporteren.

TrackingbronWat gebeurt er
Browser (Facebook Pixel)De Pixel wordt geladen op uw website en volgt bezoekersacties zoals PageView, ViewContent, AddToCart en Purchase.
Server (Conversions API)Wanneer u CAPI inschakelt en een geldig toegangstoken toevoegt, verzendt uw server dezelfde gebeurtenis rechtstreeks naar Meta.

Hoe dubbele gebeurtenissen worden vermeden

Wanneer zowel de Pixel als de Conversions API hetzelfde event verzenden, gebruikt Meta een gedeeld event ID om te herkennen dat ze naar dezelfde actie verwijzen. Hierdoor kan Meta het event slechts één keer tellen, zelfs wanneer zowel de browser als de server het rapporteren.

Waarom verbetert dit de tracking?

Uw server kan nog steeds server-side gebeurtenissen verzenden, zelfs wanneer:

  • Browsers beperken cookies
  • Ad blockers voorkomen dat de Pixel wordt geladen
  • Browsers blokkeren tracking-scripts

Daarom kan het gebruik van zowel de Pixel als de Conversions API samen de nauwkeurigheid van de tracking verbeteren en Meta helpen gebeurtenissen beter te matchen met gebruikers en producten.

Gebeurtenissen gedekt (dezelfde gebeurtenissen als de Facebook Pixel)

Product Feed Elite volgt dezelfde gebeurtenistypen als de Facebook Pixel. De plugin activeert deze gebeurtenissen automatisch wanneer bezoekers interactie hebben met pagina's in uw winkel.

Pagina of situatieGebeurtenis verzonden naar Meta
Enkel productViewContent: geactiveerd wanneer een bezoeker een product bekijkt.
WinkelwagenAddToCart: geactiveerd wanneer een product aan de winkelwagen wordt toegevoegd.
AfrekenenInitiateCheckout: geactiveerd wanneer een klant het afrekenproces start.
Bestelling Ontvangen/BedanktPurchase: geactiveerd na een succesvolle bestelling.
ProductcategorieViewCategory: geactiveerd wanneer een bezoeker een productcategorie bekijkt.
ProductzoekresultatenSearch: geactiveerd wanneer een bezoeker zoekt naar producten in uw winkel.

Productfeed versus trackinggebeurtenissen

Uw productfeed en uw trackingevents dienen verschillende doelen.

De productfeed stuurt uw catalogusgegevens naar Meta: producttitels, prijzen, afbeeldingen en ID's.

De Facebook Pixel en Conversions API sturen gedragsgegevens, zoals welke producten bezoekers bekijken, aan hun winkelwagen toevoegen of kopen.

Wanneer de product-ID's in uw feed overeenkomen met de Content-ID's die door events worden verzonden, kan Meta klantacties correct koppelen aan producten in uw catalogus. Dit helpt bij het verbeteren van rapportage, optimalisatie en dynamische advertenties voor producten.

Afhankelijk van uw thema of checkout-instellingen, kunnen sommige gebeurtenissen zich op bepaalde pagina's enigszins anders gedragen. Verifieer belangrijke gebeurtenissen in Meta Events Manager met behulp van Testgebeurtenissen of de live gebeurtenisstroom.

Facebook Pixel en Conversions API verifiëren

Nadat u de Facebook Pixel en Conversions API (CAPI) hebt ingeschakeld, controleert u of beide correct werken.

Gebeurtenissen controleren in Meta Events Manager

Open Meta Events Manager en ga naar Testgebeurtenissen. Bezoek uw winkel en activeer een gebeurtenis, zoals het bekijken van een product of het voltooien van een testaankoop. U zou gebeurtenissen moeten zien die van beide afkomstig zijn:

  • Browser (Facebook Pixel)
  • Server (Conversions API)

Controleer of gebeurtenissen niet worden gedupliceerd

Wanneer zowel de Pixel als CAPI dezelfde gebeurtenis verzenden, herkent Meta automatisch dat ze bij dezelfde actie horen en telt ze slechts één keer.

Controleer serverconnectiviteit

Uw hosting-server moet beveiligde verzoeken naar Meta kunnen verzenden. Als uw server deze verbindingen blokkeert, verschijnen CAPI-gebeurtenissen mogelijk niet, ook al werkt de Pixel nog steeds.

Het verifiëren van beide trackingmethoden zorgt ervoor dat uw winkel volledige en betrouwbare gegevens naar Meta stuurt voor rapportage en optimalisatie van advertenties.

Probleemoplossing

Er worden geen servergebeurtenissen weergegeven
Controleer of Facebook Pixel toevoegen is ingeschakeld, de Pixel-ID geldig is, Facebook Conversion API inschakelen is ingeschakeld en de token is geplakt. Verifieer dat de token bij dezelfde Pixel hoort. Genereer de token opnieuw in Events Manager als deze is ingetrokken of incorrect is gekopieerd.
Kan geen token genereren in Meta
Uw Meta-gebruiker heeft toestemming nodig voor de zakelijke account of Pixel. Gebruik Instellingen op de juiste gegevensbron, of volg Meta’s Conversions API aan de slag-gids als de knop onder een setup-wizard staat.
Alleen browsergebeurtenissen worden weergegeven
Uw server kan mogelijk geen gebeurtenissen naar Meta verzenden. Controleer of een firewall, beveiligingsplugin of hostingprovider uitgaande verbindingen van uw server blokkeert.
Slechte catalogusmatching
Zorg ervoor dat de product-ID's in uw feed overeenkomen met de Content ID's die door de Pixel worden verzonden. Als deze niet overeenkomen, kan Meta gebeurtenissen niet koppelen aan de juiste producten in uw catalogus.
Dubbele gebeurtenissen
Zorg ervoor dat u geen andere Facebook Pixel of trackingplugin uitvoert met dezelfde Pixel-ID. Meerdere integraties kunnen ervoor zorgen dat dezelfde gebeurtenis twee keer wordt verzonden.

Veelgestelde vragen

Vervangt CAPI de Facebook Pixel?
Nee. In deze implementatie is CAPI ontworpen om met de Pixel te werken, niet om deze te vervangen. De plugin controleert eerst of Facebook Pixel toevoegen is ingeschakeld en verzendt dan pas CAPI-verzoeken. Houd beide ingeschakeld zodat Meta browser- en server-signalen ontvangt, en vervolgens dedupliceert met behulp van de gedeelde event_id.
Wat gebeurt er als mijn CAPI-token verloopt of wordt ingetrokken?
Servergebeurtenissen worden niet meer geaccepteerd door Meta totdat u een geldige token toevoegt. Browser Pixel-gebeurtenissen kunnen nog steeds verschijnen, dus u ziet mogelijk een lagere serverdekking in Testgebeurtenissen. Om dit op te lossen, genereert u een nieuwe token in Meta Events Manager, werkt u Voer uw Facebook Conversion API-token in bij Product Feed-instellingen, slaat u op en test u opnieuw.
Is de Facebook Pixel gratis, of heb ik Product Feed Elite nodig?
De Facebook Pixel is inbegrepen in de gratis Product Feed Pro plugin. U heeft geen Elite nodig om de Pixel alleen te gebruiken. Product Feed Elite voegt de Conversions API (CAPI) laag toe: server-side gebeurtenisverzending, deduplicatie en het tokenveld, bovenop de Pixel. Als u alleen browsergebaseerde tracking nodig heeft, is Product Feed Pro voldoende; als u server-side tracking erbij wilt, heeft u Elite nodig.
Welke klantgegevens stuurt CAPI naar Meta?
Wanneer uw server een CAPI-gebeurtenis afvuurt, stuurt de plugin het volgende naar Meta:
  • Paginahostnaam: de URL van de pagina waar de gebeurtenis plaatsvond
  • IP-adres en browser-/apparaat-string (user agent): gebruikt door Meta om gebeurtenissen aan gebruikers te koppelen
  • Meta click ID en browser ID (van Meta’s eigen _fbc en _fbp cookies, indien aanwezig in de browser van de bezoeker): verbeteren de kwaliteit van gebeurteniskoppeling en attributie
  • Postcode en land van facturering: inbegrepen voor ingelogde gebruikers of bij Aankoopgebeurtenissen; SHA-256 gehasht voor verzending, zodat de ruwe waarden uw server nooit verlaten
  • Geanonimiseerde bezoekers-ID: de WordPress-account-ID van de bezoeker voor ingelogde gebruikers, of de WooCommerce-ordernummer voor gast aankopen; SHA-256 gehasht voor verzending
Meta gebruikt deze gegevens om server-side gebeurtenissen te koppelen aan gebruikersprofielen voor attributie en rapportage. Er worden geen wachtwoorden, betalingsgegevens of andere gevoelige persoonlijke gegevens opgenomen. Zie de documentatie van Meta over Conversions API-gegevens voor volledige details.
Kan ik meerdere Pixel-ID's of meerdere datasets gebruiken?
Nee. De plugin ondersteunt een enkele Pixel ID die globaal is ingevoerd in Product Feed → Instellingen → Algemeen. Alle gebeurtenissen, zowel browser (Pixel) als server (CAPI), worden naar die ene Pixel verzonden. Als u tracking over meerdere pixels of datasets wilt beheren, zou u dat op Meta-niveau moeten beheren of een aparte integratie moeten gebruiken.

Meer hulp nodig?

Product Feed Elite-gebruikers: open een ondersteuningsticket en ons team zal ernaar kijken.

Product Feed Pro-gebruikers: plaats een nieuw onderwerp op het WordPress.org-forum.

Was dit artikel nuttig?

Gerelateerde artikelen

Voltooi uw aankoop
AdTribes WooCommerce Productfeed

De beste WooCommerce productfeedplugin

  • AdTribes Pty Ltd
    ABN: 40 675 636 816
Product
Bronnen & Info
Partnerwebsites
Rymera