Overzicht

Gebruik deze handleiding als gebeurtenissen ontbreken, verzoeken mislukken of de gegevens in Ads Manager afwijken van je bedrijfsadministratie. Begin met één afgeronde aankoop, ingediende lead of andere actie. Noteer wat er gebeurde en wanneer, en kies vervolgens de onderstaande vraag die daarbij past.

Een gebeurtenis legt een actie vast, zoals een aankoop. De Pixel verstuurt gebeurtenissen vanuit de browser van een bezoeker; de Conversions API (CAPI) verstuurt ze vanaf je server. Ads Manager verzamelt deze gebeurtenissen in een gegevensbron. Attributie bepaalt aan welke advertentie een actie wordt toegeschreven. Een attributievenster bepaalt hoelang na een advertentie-interactie een actie nog in aanmerking komt voor attributie.

Veelgestelde vragen

1. Waar begin ik?

Bepaal welke actie je wilt meten, wat de bijbehorende gebeurtenis verstuurt en welk advertentieaccount en welke Pixel-ID worden gebruikt. Je configuratie kan gebruikmaken van de Pixel, CAPI, een partnerintegratie of een combinatie daarvan. CAPI heeft een Pixel-ID nodig, ook als je de browser-Pixel niet hebt geïnstalleerd.

Zie voor de eerste configuratie: Conversiemeting en Conversies bijhouden. Je ontwikkelaar kan de handleidingen voor de Pixel, CAPI en ondersteunde gebeurtenissen gebruiken. Houd CAPI-verzoeken en -sleutels op je server.

Als een partner je integratie beheert, gebruik dan de configuratiehandleiding voor meetpartners of de configuratiehandleiding voor mobiele meetpartners. Zie voor een HubSpot-koppeling: ChatGPT-advertenties instellen in HubSpot.

Controleer bij een bestaande configuratie elke stap:

• Is er bij de actie een gebeurtenisverzoek verstuurd?

• Gaf het verzoek een foutmelding of is het geaccepteerd?

• Kun je bevestigen dat de juiste gegevensbron de gebeurtenis heeft ontvangen?

• Is de gebeurtenis in het campagnerapport aan een advertentie toegeschreven?

2. Mijn Pixel is geïnstalleerd. Waarom zie ik geen aankopen of leads?

De Pixel kan laden zonder de benodigde aankoop- of leadgebeurtenis te versturen. Vraag je ontwikkelaar één voltooide actie te controleren:

• Controleer de gebeurtenisnaam, Pixel-ID en de pagina of callback die de gebeurtenis verstuurt. Een paginaweergave is geen afgeronde aankoop.

• Controleer of de Pixel wordt geïnitialiseerd voordat de gebeurtenis wordt verstuurd, ook als een tagmanager de Pixel laadt.

• Controleer de browserconsole en het netwerkverzoek. De melding "geactiveerd" van een tagmanager bevestigt op zichzelf niet dat de gebeurtenis is verstuurd. De debugmodus van de Pixel kan helpen.

• Controleer of toestemmingskeuzes, browserblokkeringen of het beveiligingsbeleid van je site het verzoek hebben tegengehouden.

• Controleer pagina's waarvoor moet worden ingelogd, de betaalomgeving, boekingssites, omleidingen en ingesloten formulieren. Een werkende Pixel op de landingspagina bevestigt niet dat tracking elders ook werkt.

Als er geen verzoek is verstuurd, los dan eerst die stap op. Wachten op de rapportage helpt dan niet. Gebruik de handleiding voor het oplossen van Pixel-problemen voordat je nog een integratie toevoegt.

3. Wat moet ik doen als een gebeurtenis wordt afgewezen, een time-out optreedt of een serverfout wordt geretourneerd?

Bewaar de responscode, de exacte foutmelding, het tijdstip van het verzoek en de gebeurtenis-ID. Vraag je ontwikkelaar de gebeurtenisindeling, Pixel-ID en sleutel te controleren. CAPI-gebeurtenisverzoeken gebruiken een Conversions API-sleutel voor hetzelfde advertentieaccount. Verzoeken voor configuratie, beheer en rapportage gebruiken de afzonderlijke Advertiser API-sleutel. Stuur geen API-sleutels naar het ondersteuningsteam.

Bij CAPI-batches kan één ongeldige gebeurtenis ervoor zorgen dat de hele batch mislukt.

CAPI vereist het oorspronkelijke tijdstip van de actie als Unix-tijdstempel in milliseconden. De gebeurtenis mag niet ouder zijn dan 7 dagen en niet meer dan 10 minuten in de toekomst liggen. Deze tijdslimiet voor het indienen staat los van het attributievenster. Wijzig het tijdstip van een oude gebeurtenis niet om deze alsnog geaccepteerd te krijgen.

Bij een time-out of serverfout kan het onduidelijk zijn of de gebeurtenis is aangekomen. Controleer het oorspronkelijke verzoek en eventuele ontvangstregistraties. Als je dezelfde actie opnieuw verstuurt, behoud dan de oorspronkelijke gebeurtenis-ID en tijdstempel. Met een nieuwe ID kan de actie als een andere actie worden gezien.

Onderzoek een afwijzing of een aanhoudende verzoekfout zo snel mogelijk. De geschatte rapportagetijd van 24–48 uur geldt niet voor deze fouten. Zie voor de vereisten voor verzoeken: Conversions API.

4. Ik zie dat de gebeurtenis is geaccepteerd. Waarom staat deze niet in het rapport?

Acceptatie betekent niet dat een gebeurtenis aan een advertentie is toegeschreven. Controleer wat de respons bevestigt en of het verzoek de juiste gegevensbron gebruikte. Als validate_only in CAPI is ingesteld op true, worden de gebeurtenissen gecontroleerd zonder ze op te slaan.

Voor een nieuwe gebeurtenis kan je ontwikkelaar de recente gebeurtenissen controleren, waar beschikbaar. Dit toont een recente steekproef, geen volledige geschiedenis of attributieresultaat.

Als je de ontvangst niet kunt controleren, neem dan contact op met het ondersteuningsteam en stuur de oorspronkelijke respons en een voorbeeldgebeurtenis mee. Vertel ons welke controles je hebt uitgevoerd; je hoeft niet eerst de oorzaak te achterhalen.

Als de ontvangst is bevestigd, ga dan verder met vraag 5. Verstuur de gebeurtenis niet opnieuw met nieuwe ID's alleen omdat het campagnerapport nog niet is veranderd.

Het kan ongeveer 24–48 uur duren voordat toegeschreven conversies verschijnen. Recente totalen kunnen tijdens de verwerking veranderen. Dit garandeert niet dat elke geaccepteerde gebeurtenis verschijnt en bevestigt ook niet dat deze is ontvangen. Zie: Resultaten meten.

5. Gebeurtenissen worden ontvangen. Waarom toont de campagne nog steeds nul conversies?

Controleer het volgende voordat je de integratie wijzigt:

• Is de beoogde gegevensbron aan het juiste account gekoppeld?

• Komt de verstuurde gebeurtenis overeen met de conversie-instelling van de campagne? Controleer bij aangepaste gebeurtenissen het aangepaste type en de exacte gebeurtenisnaam. Alleen een overeenkomend weergavelabel is niet genoeg.

• Was de juiste conversie al aan de campagne gekoppeld voordat de activiteit die je controleert plaatsvond?

• Volgde de actie op een advertentieklik of -weergave die volgens de attributie-instellingen in aanmerking komt?

• Bekijk je de juiste campagne, gebeurteniskolom, datums en tijdbasis van de rapportage?

Matchinggegevens helpen een gebeurtenis aan een advertentie te koppelen, maar garanderen geen attributie. Behoud de echte OpenAI-klikreferentie, oppref, tijdens het hele bezoek en neem deze op in servergebeurtenissen wanneer die beschikbaar is. Verzin nooit een referentie en gebruik nooit die van een andere bezoeker.

Controleer browser- en servergebeurtenissen afzonderlijk. Een referentie of klantveld dat beschikbaar is voor de Pixel kan ontbreken in de servergebeurtenis.

Het geselecteerde doel van een voor conversies geoptimaliseerde campagne kan na het aanmaken niet meer worden gewijzigd. Maak een nieuwe campagne aan om een ander doel te gebruiken. Aangepaste gebeurtenissen kunnen niet als optimalisatiedoel worden gebruikt. Zie: Voor conversies geoptimaliseerde campagnes.

Controleer na het corrigeren van een configuratieverschil nieuwe activiteit die in aanmerking komt. Ga er niet van uit dat de wijziging eerdere rapporten corrigeert. Zie voor matchingregels: Conversiemeting.

6. Waarom komen de gegevens in Ads Manager, onze analysetool en ons CRM niet overeen?

Vergelijk dezelfde acties en rapportageregels. Je CRM telt mogelijk elke aankoop; een advertentierapport telt aankopen die aan dat platform zijn toegeschreven. Verschillende platforms kunnen dezelfde aankoop op verschillende manieren toeschrijven.

In Ads Manager combineert Conversies doorklikconversies en in aanmerking komende weergaveconversies wanneer het rapportagevenster voor weergaveconversies 1 dag is. Bij een weergavevenster van 0 dagen worden alleen doorklikconversies geteld. Gebruik dezelfde instelling wanneer je rapporten vergelijkt.

Stel dat iemand op een advertentie klikt, later rechtstreeks terugkomt en iets koopt. De ene tool kan het bezoek als "Direct" aanduiden, terwijl een andere de aankoop aan de eerdere advertentie toeschrijft. Dat verschil alleen betekent niet dat de aankoop dubbel is geteld.

Als de labels voor de verkeersbron verschillen, controleer dan de landings-URL en trackingparameters die bij dat bezoek zijn gebruikt. De huidige campagne-instellingen kunnen afwijken van de eerder gebruikte instellingen.

Vergelijk:

• Account, campagne, gebeurtenistype, filters en rapportageniveau.

• Datumbereik, tijdzone en of de datums verwijzen naar de advertentie-interactie of de conversie zelf.

• Instellingen voor doorklik- en weergaveconversies en de exact geselecteerde statistiek of kolom.

• Recente verwerkingsvertragingen, afhandeling van duplicaten, toestemming en beschikbare matchinggegevens.

• Gemodelleerde conversies, waar beschikbaar, die kunnen afwijken van rechtstreeks geregistreerde transacties.

• Bij waarden: valuta, eenheden en of de vergelijking de hele bestelling of afzonderlijke artikelen betreft.

Bij omzet: belastingen, verzendkosten, kortingen en toeslagen. Controleer of de browser- en serverversie dezelfde bestelwaarde versturen. Omzet uit aangemaakte bestellingen en ROAS van aangemaakte bestellingen tellen alleen toegeschreven order_created-gebeurtenissen mee.

Geïmporteerde GA4-activiteit omvat gebeurtenissen uit alle verkeersbronnen van de geselecteerde property. Die totalen zijn geen aan campagnes toegeschreven conversies. Zie: Google Analytics 4 koppelen aan OpenAI Ads Manager.

Noteer bij API-vergelijkingen het endpoint en stel de rapportageopties expliciet in. Een weggelaten instelling komt mogelijk niet overeen met Ads Manager. Rapporten kunnen ook verschillende gebeurtenissen bevatten: sommige omvatten campagnedoelen, maar geen andere bijgehouden acties. Als een gebeurtenis in één rapport ontbreekt, bewijst dat niet dat deze nooit is ontvangen.

Gebruik dezelfde instellingen voor een CSV-vergelijking en bewaar de onbewerkte exports. Zie Resultaten meten voor weergaven in Ads Manager en Rapportage voor API-opties.

7. Wordt een aankoop dubbel geteld als ik de Pixel en CAPI gebruik?

Gebruik dezelfde Pixel-ID, gebeurtenisnaam en gebeurtenis-ID in de browser- en serverversie om te voorkomen dat dezelfde actie dubbel wordt geteld. Het veld voor de gebeurtenis-ID heet id in CAPI en event_id in de Pixel. Gebruik aan beide kanten ook dezelfde aangepaste gebeurtenisnaam.

Behoud dezelfde ID als je een actie opnieuw verstuurt; gebruik een nieuwe ID voor elke andere actie. Controleer op dubbele tags, herhaald laden van pagina's of herhaalde callbacks, en partnerintegraties die de gebeurtenis mogelijk al versturen.

Verstuur geen duplicaat om de waarde of matchinggegevens van de oorspronkelijke gebeurtenis te wijzigen. Controleer de gedocumenteerde werking voordat je een correctie probeert uit te voeren. Zie: Deduplicatie van browser- en servergebeurtenissen.

8. We gebruiken Shopify. Hebben we nog een integratie nodig?

Controleer je Shopify-koppeling voordat je nog een integratie toevoegt. Controleer welk advertentieaccount en welke Pixel zijn gekoppeld en welke gebeurtenissen de app voor je winkel verstuurt.

Als je ook aangepaste tags, code in de betaalomgeving of een verzendfunctie op de server gebruikt, controleer dan of die dezelfde gebeurtenissen versturen. Shopify-configuraties kunnen verschillende combinaties van browser- en servertracking gebruiken. Zie: ChatGPT-advertenties instellen voor Shopify.

9. Hoe moeten we omgaan met toestemming en testen?

Verstuur alleen gegevens die je mag delen en respecteer de toestemmingskeuzes van bezoekers. Je ontwikkelaar moet de richtlijnen van de integratie voor toestemming en ondersteunde matchinggegevens volgen, inclusief eventuele vereisten voor normalisatie en hashing. Verwijder geen toestemmingscontroles om meer conversies te rapporteren of een score te verbeteren.

Toestemming voor metingen en opt_out dienen verschillende doelen. De optie opt_out gaat over personalisatie; deze houdt niet alle meetverzoeken tegen. Vraag je ontwikkelaar de afhandeling van toestemming in zowel browser- als serverintegraties te controleren.

Noteer het tijdstip, de naam en de ID van één testactie. Controleer of deze is verstuurd, gevalideerd en ontvangen. Een geslaagde implementatietest toont niet aan dat een advertentie in aanmerking komt voor attributie.

De optie validate_only van CAPI controleert gebeurtenissen zonder ze op te slaan. De debugmodus van de Pixel registreert activiteit, maar sluit testgebeurtenissen niet uit van de rapportage. Markeer tests in je administratie en verzin geen aankopen of wijzig geen gebeurtenistijden om een resultaat af te dwingen.

10. Betekent een lage of niet-beschikbare gebeurteniskwaliteitsscore dat tracking niet werkt?

Niet op zichzelf. Gebeurteniskwaliteit beoordeelt de informatie die van een gegevensbron is ontvangen. Dit vertelt je niet hoeveel conversies aan advertenties zijn toegeschreven. Een lage of niet-beschikbare score alleen is niet genoeg om vast te stellen of tracking werkt.

Controleer of recente echte acties correct worden vastgelegd en onderzoek daarna de waarschuwing. Verstuur geen extra gebeurtenissen of verzonnen ID's om de score te verhogen. Zie voor controles en verversingstijden: Gebeurteniskwaliteit begrijpen en verbeteren.

11. Welke informatie moet ik meesturen als ik contact opneem met het ondersteuningsteam?

Vertel ons wat je verwachtte, wat er gebeurde, wanneer het begon en wat je hebt gecontroleerd. Stuur de informatie uit deze lijst mee waarover je beschikt:

• Advertentieaccount-ID, Pixel-ID of gegevensbron, en de ID's van de betrokken campagnes en advertenties.

• Het type integratie en de exacte gebeurtenisnaam, inclusief eventuele aangepaste gebeurtenisnamen.

• Een of twee bestaande gebeurtenis-ID's als voorbeeld, met de tijdstempels van de acties en de tijdzone.

• Bij verzoekfouten of onzekere ontvangst: de responscode, exacte foutmelding, het tijdstip van het verzoek, een eventueel geretourneerde verzoek-ID of CF-Ray, en een payload of logfragment waaruit gevoelige gegevens zijn verwijderd.

• Bij rapportageverschillen: het datumbereik, de tijdbasis van de rapportage, attributie-instellingen, geselecteerde kolommen, een CSV-export en een vergelijking met dezelfde afbakening.

• Relevante schermafbeeldingen en recente configuratiewijzigingen, waaronder een afzonderlijke betaalomgeving of partnerintegratie.

Vertel ons of je hebt bevestigd dat de gebeurtenis is verstuurd, geaccepteerd of ontvangen, of dat je alleen het rapport hebt gecontroleerd. Je kunt ook om hulp vragen als je deze controles niet kunt uitvoeren.

Verwijder API-sleutels, autorisatieheaders, wachtwoorden, cookies en onnodige klantgegevens uit bijlagen. Meld fouten of een integratie die eerder werkte en plotseling stopt zo snel mogelijk. Wacht niet tot de rapportagetermijn is verstreken.