> 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/tiktok-ads.md).
# TikTok Ads
Hoe je TikTok Ads-tracking instelt via de TikTok Events API
Deze handleiding laat je stap voor stap zien hoe je de TikTok Events API configureert in je Google Tag Manager-servercontainer.
{% hint style="warning" %}
**Dit artikel behandelt alleen een server-side configuratie.** Alle TikTok-gebeurtenissen worden vanuit je servercontainer naar de Events API verzonden; er wordt geen TikTok Pixel in de browser geactiveerd. Je kunt ook TikTok Ads uitvoeren **client-side en server-side tegelijk**, met gebeurtenis-deduplicatie op basis van een gedeelde gebeurtenis-ID. We beschrijven die configuratie in [TikTok Ads-tracking client-side instellen met deduplicatie](/documentation/documentation-nl/integraties-marketingtools/tiktok-ads/client-side-tiktok-ads-tracking-instellen-met-deduplicatie.md).
{% endhint %}
### Voordat je begint
Zorg ervoor dat u het volgende heeft:
* [ ] Een werkende GTM-servercontainer die events ontvangt (meestal via je Google Tag / GA4-client).
* [ ] Je **TikTok Pixel-ID** en **API-toegangstoken**. Zie [Hoe je je TikTok Pixel-ID en toegangstoken vindt](/documentation/documentation-nl/integraties-marketingtools/tiktok-ads/waar-je-de-tiktok-pixel-id-en-de-tiktok-api-token-vindt.md).
### Stap 1: Voeg de tagsjabloon toe
1. Open je GTM-servercontainer en ga naar **Sjablonen**.
2. Onder **Tagsjablonen**, klik op **Sjabloongalerij doorzoeken**.
3. Zoek naar de **TikTok Events API** tagsjabloon en voeg deze toe aan je werkruimte.
### Stap 2: Maak de Events API-tag aan
1. Ga naar **Tags** en maak een nieuwe tag aan. Kies **TikTok Events API** als tagconfiguratie.
2. Onder **Methode voor instelling van gebeurtenisnaam**, kies **Overnemen van client**. De tag gebruikt dan de gebeurtenisnamen van de binnenkomende GA4-verzoeken.
3. Vul je toegangstoken in bij de **Toegangstoken** veld.
4. Vul je TikTok Pixel-ID in bij de **TikTok Pixel-ID** veld.
{% hint style="info" %}
Het overnemen van de gebeurtenisnaam betekent dat TikTok je GA4-gebeurtenisnamen ontvangt, zoals `purchase` en `add_to_cart`. Die komen binnen als aangepaste gebeurtenissen. Het algoritme van TikTok werkt beter met de eigen standaardgebeurtenisnamen, en je hebt standaardgebeurtenissen nodig als je later de TikTok Pixel met deduplicatie toevoegt.
{% endhint %}
5. Stel de vier selectievakjes als volgt in:
| Optie | Aanbevolen |
| -------------------------------------------------------- | ------------- |
| Genereer Browser-ID (`_ttp`)-cookie als die niet bestaat | Uitgeschakeld |
| Schakel gebeurtenisverrijking in | Ingeschakeld |
| Cookie-instellingen overschrijven | Uitgeschakeld |
| Gebruik optimistische scenario | Uitgeschakeld |
**Genereer Browser-ID (\_ttp)-cookie als die niet bestaat**
De \_ttp-cookie bevat de browser-ID. In een configuratie met een TikTok Pixel maakt de Pixel deze cookie zelf aan, dus is die optie daar overbodig. **Aanbeveling: laat dit uitgeschakeld.** Een \_ttp-waarde die je eigen server verzint, is geen identificatiecode die TikTok uitgeeft of herkent. TikTok kan die niet zelfstandig aan een persoon koppelen. Het enige wat TikTok kan doen, is gebeurtenissen groeperen die uit dezelfde browser komen, en dat werkt alleen als de cookie betrouwbaar naar je trackingdomein wordt geschreven en bij elk volgend verzoek wordt teruggestuurd.
**Schakel gebeurtenisverrijking in**
Met deze optie kan de tag gebruikersgegevens opslaan in een afzonderlijke HttpOnly-cookie (gtmeec-tt) op je eigen domein. Wanneer een latere gebeurtenis zonder gebruikersgegevens binnenkomt, verrijkt de tag die gebeurtenis met de opgeslagen gegevens.**Aanbeveling: schakel dit in.** Het verhoogt de kwaliteit van je gebeurtenisovereenkomsten, wat de attributie en het vermogen van TikTok om je campagnes te optimaliseren verbetert.
{% hint style="info" %}
Houd wel rekening met je privacydocumentatie: de tag slaat persoonlijke gegevens (gehasht) op in een cookie op je domein, dus zorg ervoor dat dit is opgenomen in je cookiebeleid en dat de tag alleen wordt geactiveerd met marketingtoestemming.
{% endhint %}
**Cookie-instellingen overschrijven**
De tag schrijft drie cookies op je domein: de klik-ID, de browser-ID en de cookie voor gebeurtenisverrijking. Met deze optie kun je het volgende overschrijven: de **domein** en de **SameSite** attribuut waarmee alle drie worden weggeschreven. Standaard wordt het domein automatisch bepaald op basis van de pagina-URL van de binnenkomende gebeurtenis, met de verzoekheaders als terugvaloptie. Dat is correct voor een normale configuratie met één domein. Schakel dit alleen in als het automatische gedrag niet klopt voor jouw situatie, bijvoorbeeld wanneer je de cookies op je topleveldomein moet instellen omdat je tracking over subdomeinen doet, of wanneer je SameSite-beleid moet afwijken van de standaardinstelling.
**Gebruik optimistische scenario**
Normaal wacht de tag tot TikToks API bevestigt dat de gebeurtenis is ontvangen voordat hij terugmeldt aan GTM. Als deze optie is ingeschakeld, meldt de tag direct succes, zonder op een reactie te wachten. **Aanbeveling: laat dit uitgeschakeld.** Je verliest je enige inzicht in of gebeurtenissen daadwerkelijk binnenkomen, waardoor trackingproblemen heel moeilijk op te sporen zijn.
### Stap 3: Voeg een trigger toe
1. Klik op **Triggers** onder de tagconfiguratie en klik vervolgens op het blauwe pluspictogram rechtsboven om een nieuwe trigger te maken.
2. Kies de grijze **Aangepast** optie als triggerconfiguratie.
3. Selecteer **Sommige gebeurtenissen** om voorwaarden toe te voegen. Voeg je voorwaarde toe. Veelgebruikte opties zijn:
* **Gebaseerd op specifieke eventnamen**
* `{{Event Name}}` komt overeen met RegEx `eventname|eventname`
* Altijd opnemen `page_view` als eerste gebeurtenisnaam.
* **Zonder voorwaarde**, als je elk GA4-event naar de Conversions API wilt sturen
* `{{Client Name}}` is gelijk aan `GA4`
4. Sla de trigger en de tag op.
### Stap 4: Testen
Gebruik de voorbeeldmodus van de servercontainer om te controleren of de Facebook Conversion API-tag wordt geactiveerd bij binnenkomende gebeurtenissen.
Voor een grondigere controle voeg je een **Test-ID** aan de tag toe en open het tabblad Testgebeurtenissen in TikTok Ads Manager. Je gebeurtenissen zouden moeten verschijnen met **Server** vermeld als bron. Verwijder de Test-ID weer zodra je klaar bent met testen.
### Optioneel: Voeg eventparameters toe of overschrijf ze
Standaard stelt de tag zijn payload zelf samen op basis van de binnenkomende gebeurtenis. Hij leest de parameters die je webcontainer naar de servercontainer stuurt en koppelt de parameters die hij herkent aan hun TikTok-equivalenten. Voor de meeste configuraties is dat voldoende.
Je kunt die koppeling overschrijven of parameters toevoegen die de tag niet vanzelf oppikt. Open je TikTok Events API-tag en vouw de secties onder de hoofdinstellingen uit:
* **Overschrijven van servergebeurtenisgegevens** — voor velden op gebeurtenisniveau, zoals de gebeurtenis-ID, verwijzer, tijdstempel en URL.
* **Gebruikersgegevens** — voor identificatieparameters, waaronder e-mail, telefoonnummer, externe ID, klik-ID en browser-ID.
* **Eigenschappen** — voor de commerciële details van de gebeurtenis, zoals waarde, valuta, inhoud en zoekopdracht.
Elke sectie werkt op dezelfde manier: je voegt een eigenschap toe, kiest welk veld je wilt vullen en geeft die een waarde. Die waarde is normaal gesproken een variabele die verwijst naar een parameter in de binnenkomende gebeurtenis. Alles wat je handmatig invoert heeft voorrang op wat de tag automatisch heeft gekoppeld.
Er zijn twee redenen om dit te doen:
* **De parameter komt binnen, maar de tag koppelt hem niet.** Je webcontainer kan een waarde sturen onder een naam die de tag niet herkent, of in een structuur die hij niet kan lezen. Door het veld zelf naar de juiste parameter te laten verwijzen, komt die in de payload terecht.
* **De parameter is onjuist of ontbreekt.** Als de automatische koppeling een waarde oplevert die je niet wilt verzenden, vervangt een overschrijving die.
Welke parameters voor jou beschikbaar zijn, hangt volledig af van wat je GA4-gebeurtenistags vanuit de webcontainer verzenden. Er is geen universele lijst. Open de voorbeeldmodus van de servercontainer, bekijk een binnenkomend verzoek en werk met de parameters die je daar daadwerkelijk ziet.
Twee dingen om in gedachten te houden. De tag hasht gebruikersgegevens automatisch, dus geef waarden in platte tekst door en hash ze niet eerst zelf. En koppel alleen parameters die je rechtmatig mag verzenden: alles wat je hier toevoegt gaat naar TikTok, dus het moet gedekt zijn door je toestemmingsinstellingen en je privacyverklaring.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.adpage.io/documentation/documentation-nl/integraties-marketingtools/tiktok-ads.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
