> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/openai-ads.md).
# OpenAI Ads
Configureer de OpenAI Pixel en Conversions API met event ID-deduplicatie.
Stel eerst de OpenAI Pixel in in de webcontainer. Stuur daarna overeenkomende gebeurtenissen via de OpenAI Conversions API.
Beide tags sturen dezelfde conversie. Geef beide tags dezelfde gebeurtenisnaam en gebeurtenis-ID. OpenAI kan de gebeurtenissen dan dedupliceren en één conversie tellen.
Deze hybride configuratie vangt browser- en servergebeurtenissen op. Ze vermindert ook verlies door advertentieblokkers en browser-cookiebeperkingen.
### Wat je gaat configureren
Je maakt:
* Een OpenAI Pixel-tag in de GTM-webcontainer.
* Een OpenAI Conversions API-tag in de GTM-servercontainer.
* Eén gedeelde `event_id` voor elke overeenkomende browser- en servergebeurtenis.
Gebruik deze pagina voor de volledige implementatie. Zie [OpenAI-referenties](/documentation/documentation-nl/integraties-marketingtools/openai-ads/waar-je-de-openai-pixel-id-en-api-sleutel-vindt.md), [deduplicatie van gebeurtenis-ID's](/documentation/documentation-nl/integraties-marketingtools/openai-ads/chatgpt-ads-event-id-deduplicatie.md), en [campagne-URL-tracking](/documentation/documentation-nl/integraties-marketingtools/openai-ads/utm-parameters-and-dynamische-tracking-voor-chatgpt-ads.md).
### Voordat je begint
Zorg dat je het volgende hebt:
* [ ] Een GTM-webcontainer met GA4-gebeurtenistags.
* [ ] Een GTM-servercontainer die de GA4-gebeurtenissen ontvangt.
* [ ] De **OpenAI Pixel-ID** en **API-sleutel** van OpenAI Ads Manager. Zie [Waar je de OpenAI Pixel-ID en API-sleutel kunt vinden](/documentation/documentation-nl/integraties-marketingtools/openai-ads/waar-je-de-openai-pixel-id-en-api-sleutel-vindt.md).
* [ ] Een **Unieke gebeurtenis-ID** variabele in de webcontainer.
{% hint style="info" %}
Bevestig dat het OpenAI Ads Manager-account van de klant actief is. Het levert de Pixel-ID, de conversieconfiguratie en de API-sleutel.
{% endhint %}
### Deel 1: Client-side tracking instellen
#### Stap 1: Voeg de OpenAI Pixel-sjabloon toe
1. Open je GTM-webcontainer en ga naar **Sjablonen**.
2. Onder **Tagsjablonen**, klik op **Galerij doorzoeken**.
3. Zoek naar de **OpenAI Pixel** tagsjabloon en voeg deze toe.
#### Stap 2: Maak een Pixel-ID-variabele
1. Ga naar **Variabelen** en maak een **Constante** variabele.
2. Stel de waarde in op de OpenAI Pixel-ID.
3. Sla deze op als je Pixel-ID-variabele.
#### Stap 3: Maak client-side gebeurtenistags
1. Maak een nieuwe **OpenAI Pixel** tag.
2. Selecteer je Pixel-ID-variabele.
3. Kies **Overnemen van DataLayer** om de GA4-gebeurtenisnaam opnieuw te gebruiken.
4. Kies **Overschrijven** alleen wanneer OpenAI een andere gebeurtenisnaam vereist.
5. Laat **Automatische gebeurtenisparameters** toewijzing ingeschakeld.
6. Onder **Server-side trackinginstellingen**, stel **Gebeurtenis-ID** in op je Unieke-gebeurtenis-ID-variabele.
7. Gebruik dezelfde trigger als de overeenkomende GA4-gebeurtenistag.
Herhaal dit voor elke gebeurtenis die je wilt volgen. Voeg `page_view` toe met dezelfde trigger als de GA4-paginaweergavetag.
#### Stap 4: Geef de gebeurtenis-ID door aan GA4
Voeg dezelfde variabele voor Unieke gebeurtenis-ID toe aan elke overeenkomende GA4-gebeurtenistag:
1. Open de GA4-gebeurtenistag.
2. Voeg een gebeurtenisparameter toe met de naam `event_id`.
3. Stel de waarde in op de variabele voor Unieke gebeurtenis-ID.
4. Sla de tag op.
De servercontainer kan nu de gebeurtenis-ID uit de GA4-gebeurtenis lezen.
### Deel 2: Server-side tracking instellen
#### Stap 5: Voeg de Conversions API-sjabloon toe
1. Open je GTM-servercontainer en ga naar **Sjablonen**.
2. Onder **Tagsjablonen**, klik op **Galerij doorzoeken**.
3. Voeg de **OpenAI Conversions API** tagsjabloon toe.
#### Stap 6: Maak de server-side tag
1. Maak een nieuwe **OpenAI Conversions API** tag.
2. Onder **Instelmethode voor gebeurtenisnaam**, kies **Overnemen van client**.
3. Kies **Overschrijven** alleen wanneer de Pixel-tag dezelfde overschrijving gebruikt.
4. Kies de juiste **Actiebron**, zoals **Website**.
5. Voer de OpenAI Pixel-ID en API-sleutel in.
6. Laat **Automatische gebeurtenisparameters** toewijzing ingeschakeld.
#### Stap 7: Geef de gebeurtenis-ID door aan OpenAI
1. Maak een variabele in de servercontainer die de binnenkomende `event_id` gebeurtenisparameter uitleest.
2. Open de OpenAI Conversions API-tag.
3. Onder **Servergebeurtenisdataparameters**, voeg **Gebeurtenis-ID**.
4. Stel de waarde in op de server-side gebeurtenis-ID-variabele.
#### Stap 8: Configureer toestemming en de trigger
Schakel **ondersteuning voor Consent Granted / GTM Consent Mode**. Koppel het aan marketingtoestemming.
Maak een trigger voor de gebeurtenissen die je wilt verzenden. Gebruik beide voorwaarden:
* `{{Event Name}}` komt overeen met RegEx `purchase|order_completed`.
* `{{Client Name}}` is gelijk aan `GA4`.
Laat **Klik-ID-cookie instellen** ingeschakeld, tenzij de klant anders vereist. Het slaat OpenAI's klik-ID op in de first-party `__oppref` cookie.
{% hint style="warning" %}
De Pixel- en Conversions API-tags moeten dezelfde gebeurtenisnaam en gebeurtenis-ID gebruiken. Verschillende waarden voorkomen deduplicatie.
{% endhint %}
### Test en valideer de volledige configuratie in voorbeeldmodus
Voordat je publiceert, bevestig je dat de OpenAI-cookies de servercontainer bereiken en dat de Conversions API-tag de klik-ID doorstuurt (`oppref`) en de browserreferentie (`obref`) naar OpenAI.
De Pixel slaat beide waarden op in first-party cookies (`__oppref` en `__obref`). De Conversions API legt ze niet voor je vast. De tag moet de klik-ID vinden in de URL, de cookie of de gebeurtenisdata en deze sturen als `oppref`. De browserreferentie gaat in `user.obref`, ongewijzigd.
**Bereid de test voor**
1. Open een schoon incognitovenster. Verbind de GTM-voorbeeldmodus voor zowel de webcontainer als de servercontainer.
2. Werk in een aparte werkruimte. Als de tag **Alleen valideren**, schakel dit in voor de test, zodat testgebeurtenissen worden uitgesloten van meting. Schakel het weer uit voordat je publiceert.
3. Open een landingspagina met een test-klik-ID, bijvoorbeeld `https://yourdomain.com/?oppref=test123`. Je kunt ook op een testcampagne klikken
**Waar je in de servervoorbeeldmodus moet kijken**
| Locatie | Wat je moet controleren |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Inkomende aanvraag (client) | De `cookie` header bevat `__oppref` en `__obref`. Als ze ontbreken, kan de tag ze niet lezen. De servercontainer draait waarschijnlijk niet op een first-party domein van de website. |
| Gebeurtenisgegevens | `page_location` bevat de `oppref` parameter. De toestemmingsstatus toont `ad_storage` verleend. |
| OpenAI-tag → Aanvraag | De URL is `https://bzr.openai.com/v1/events?pid=`. De body bevat `oppref`, `user.obref`, `id` en `source_url`. |
| Browser → Toepassing → Cookies | `__oppref` bestaat met het verwachte domein en de verwachte vervaldatum. De servercontainer zet het in de `Set-Cookie` header van de respons. |
**Voer de testscenario's uit**
| # | Scenario | Verwacht resultaat |
| - | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| 1 | Landingspagina met `oppref` in de URL, marketingtoestemming verleend | De eerste gebeurtenis bevat `oppref`, gelijk aan de URL-waarde. De `__oppref` cookie is ingesteld. |
| 2 | Tweede paginaweergave zonder `oppref` in de URL | `oppref` komt uit de cookie en heeft dezelfde waarde. |
| 3 | Tweede advertentieklik met een andere `oppref` | De nieuwe waarde wordt verzonden en de cookie wordt overschreven. |
| 4 | Direct bezoek zonder `oppref` | `oppref` wordt weggelaten uit de body. Het is geen lege tekenreeks. |
| 5 | Marketingtoestemming geweigerd | Er gaat geen verzoek naar OpenAI en er worden geen cookies ingesteld. Intrekken van toestemming verwijdert de cookies. |
| 6 | Toestemming gegeven nadat de landingspagina was geladen | De OpenAI-tag wordt afgevuurd na de toestemmingsupdate en bevat nog steeds `oppref` uit de URL. |
| 7 | `user.obref` | Komt overeen met de waarde van de `__obref` cookie en is niet gehasht. |
| 8 | Pixel en Conversions API samen | Beide sturen dezelfde gebeurtenis-ID, dus slechts één conversie telt. |
| 9 | Aankoop verzonden vanuit een webwinkel-webhook | Er zijn geen browsercookies beschikbaar. Sla de klik-ID op bij de bestelling en stel deze handmatig in de tag in. |
**Pas de bevindingen toe op de sjabloon**
1. Werk de **OpenAI Conversions API** sjabloon bij naar de nieuwste versie uit de galerij. Controleer of de gebruikersvelden in de request body overeenkomen met de OpenAI-specificatie, bijvoorbeeld `emails_sha256`, `cities`, `postal_codes` en `countries` als lijsten.
2. Als `oppref` ontbreekt bij de eerste gebeurtenis terwijl `page_location` het bevat, stel de **Klik-ID** handmatig in onder **Servergebeurtenisdataparameters**. Gebruik een variabele die `oppref` uit `page_location` eerst, daarna uit de `__oppref` cookie leest, daarna uit de gebeurtenisdata. Handmatige waarden hebben voorrang op automatisch gekoppelde waarden, dus zorg ervoor dat de variabele correct terugvalt. Test in de voorbeeldmodus wat er gebeurt wanneer de variabele leeg is.
3. Laat **Klik-ID-cookie instellen** ingeschakeld. Laat **Alleen HTTP** op de standaardwaarde (uit), zodat browserscripts de cookie nog steeds kunnen lezen. Kies een vervaldatum die overeenkomt met de cookieduur van OpenAI van 30 tot 90 dagen.
4. Laat de OpenAI Pixel `page_view` tag afvuren na de toestemmingsupdate. De landings-URL bevat `oppref` alleen op de eerste pagina. Als de tag afvuurt voordat toestemming bekend is, gaat de klik-ID verloren.
5. Gebruik dezelfde Unieke gebeurtenis-ID in beide tags. Schakel uit **Automatisch een gebeurtenis-ID genereren** in de servertag wanneer de Pixel ook gebeurtenissen verzendt.
**Controleer het resultaat na publicatie**
Bevestig in de uitgaande verzoeklogs dat:
* Landingspagina's met `oppref` in de URL dragen `oppref` in de request body.
* Vervolg-paginaweergaven dragen dezelfde waarde.
* Geen verzoeken bevatten `"validate_only": true`.
* Het aantal niet-2xx-responses neemt niet toe.
{% hint style="warning" %}
Stuur alleen de klik-ID, gehashte e-mails en cookiewaarden voor bezoekers die marketingtoestemming hebben gegeven. Testwaarden zoals `test123` komen als echte gebeurtenissen bij OpenAI aan, tenzij **Alleen valideren** is ingeschakeld.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/openai-ads.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
