Documentatie

OpenAI Ads oppref-attributie uitgelegd

oppref is de klik-ID die OpenAI aan een landings-URL toevoegt. De Measurement Pixel bewaart hem, zodat latere events nog aan die klik gekoppeld kunnen worden. Geef de originele waarde ongewijzigd door.

Laatst bijgewerkt: 2026-09-22. Geschreven door PixelBridge team.

Wat is oppref?

oppref is een ondoorzichtige klik-ID die OpenAI aan de landings-URL toevoegt. De Measurement Pixel leest hem, zodat latere conversie-events aan die klik gekoppeld kunnen worden. Je maakt de waarde niet zelf, en je herschrijft hem niet.

Het contract staat in de documentatie van OpenAI over de Measurement Pixel en de Conversions API.

Wanneer oppref wordt toegevoegd

OpenAI zet oppref op de klik naar je site. WordPress, een formulierplugin of PixelBridge doen dat niet. Kwam het bezoek niet uit een OpenAI-adklik, dan staat de parameter er niet. Verzin geen vervanger.

Hoe oppref op de landingspagina komt

De ID arriveert als queryparameter op de eerste URL die de bezoeker opent. De Measurement Pixel moet op die pagina draaien, of op een latere pagina die de waarde nog heeft, voordat iets de querystring stript.

Een redirect die queryparameters laat vallen, een plugin die de URL opnieuw opbouwt, of een canonical redirect vóór de pixel, kan oppref verwijderen voordat hij is gelezen.

Als meet-consent het toestaat, bewaart de pixel de ID in de first-party cookie __oppref. OpenAI documenteert een verlooptijd van 30 dagen vanaf het moment dat de pixel de cookie schrijft. Elke nieuwe niet-lege oppref in de URL, ook dezelfde waarde opnieuw, zet die verlooptijd terug op 30 dagen. De opgeslagen cookie lezen op een later bezoek zonder parameter verlengt hem niet.

Browsers kunnen de cookie eerder wissen. Consent uit op de pixel verwijdert __oppref en __obref. De levensduur van de cookie is niet het attributievenster in Ads Manager.

Hoe de Measurement Pixel oppref gebruikt

Je hangt oppref niet zelf aan een gewone browser-measure-call. De pixel pakt hem van de URL en neemt hem mee in latere events zolang de cookie geldig is. Daarom moet de pixel op de landing laden, niet alleen op een bedankpagina waar de querystring al weg is.

oppref en de Conversions API

De Conversions API vangt oppref niet voor je. Stuur je een server event, zet dan de originele string op het event als oppref. De veldbeschrijving van OpenAI zegt: geef die string ongewijzigd door.

Heb je de waarde niet meer, laat het veld dan weg. Een lege of bewerkte waarde is geen klik-ID. Zie OpenAI Ads Conversions API.

Implementatie in WordPress

Drie regels:

Laat de landingspagina de Measurement Pixel laden voordat een redirect of URL-opschoning de querystring verwijdert.
Gebruik één Pixel ID per omgeving, zodat een staging-klik niet in productie belandt.
Stuurt een PHP-hook het Conversions API-event, lees dan de bewaarde oppref en geef hem ongewijzigd door.

PixelBridge is gemaakt om oppref te zien en beschikbaar te houden voor latere events als consent meting toestaat. De plugin maakt de parameter niet aan. Installatie: OpenAI Ads Pixel voor WordPress.

Redirects en oppref

Interne links laten de querystring meestal vallen. Dat is prima nadat de pixel de cookie heeft gezet. Het is niet prima op de eerste hop.

Bewaar de volledige querystring op elke redirect tussen de ad-URL en de pagina waar de pixel draait. HTTPS, www, taal en trailing slash zijn de plekken waar de waarde vaak verdwijnt. Een 301 die het pad houdt maar ?oppref= laat vallen, geeft je een pageview zonder klik-ID.

Queryparameters opschonen

Sommige sites halen onbekende queryparameters weg voor schonere URL's. Doe dat pas nadat de Measurement Pixel oppref op dat request heeft gelezen. De URL in de browser opschonen nadat de cookie is gezet, wist de cookie niet.

Normaliseer de waarde niet. Zet hem niet in een andere parameternaam en verwacht dat de pixel hem volgt. De pixel zoekt oppref.

Vereist meting toestemming, zet de consentstatus van de pixel dan uit vóór de initialisatie, en zet hem pas aan na toestemming. Zolang consent uit staat, stuurt de pixel geen meet-events. Consent uit verwijdert de attributiecookies.

Kopieer oppref niet naar een eigen langdurige opslag om een weigering te omzeilen. Zie cookie consent. Dit is geen juridisch advies.

Problemen oplossen

Open een landings-URL die echt oppref bevat.
Controleer dat de pixel op die eerste pagina laadde, na consent als consent nodig is.
Ga naar een tweede pagina zonder de queryparameter.
Rond één testconversie af.
Controleer dat het event nog de originele ID heeft, in de debug-output van de pixel of in de serverpayload.

Heeft de tweede pagina geen ID, dan is de cookie nooit geschreven of geblokkeerd. Had de landingspagina de parameter nooit, dan was het geen OpenAI-adklik, of een eerdere redirect heeft hem verwijderd.

Wat er gebeurt als oppref ontbreekt

Stuur de conversie toch als het een echte actie is en consent het toestaat. Laat oppref weg. Click matching voor dat bezoek heeft deze ID dan niet. Verzin hem niet uit een eerdere bezoeker of uit een gehashte e-mail.

View-through, als het account dat heeft, gebruikt geen apart eventveld en hangt er niet van af dat jij oppref toevoegt.

oppref versus obref

	oppref	obref
Doel	Klik-ID voor attributie	Browserreferentie voor die site
Herkomst	Queryparameter op de landings-URL	De Measurement Pixel
In de browser	Gelezen van de URL en opgeslagen in `__oppref`	Opgeslagen in `__obref` en hergebruikt zolang hij geldig is
Op de server	`oppref` op het event	`user.obref` op het event
Aanpassen?	Nee. Geef de originele string door.	Nee. Geef hem ongewijzigd door.
Hashen?	Nee.	Nee. De documentatie van OpenAI zegt dat je hem niet hasht.

__oppref heeft een gedocumenteerde cookie-verlooptijd van 30 dagen, die opnieuw start als een nieuwe parameter wordt gepakt. __obref heeft een gedocumenteerde verlooptijd van 365 dagen vanaf aanmaak, en lezen verlengt die niet. Beide cookies verdwijnen als meet-consent uit wordt gezet.