> ## Documentation Index
> Fetch the complete documentation index at: https://ticketsoft.nl/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Pixel en Conversions API instellen

> Koppel je ticketshop aan Meta en meet na toestemming het resultaat van je advertenties.

Adverteer je voor je evenement op Facebook of Instagram? Met de module **Meta Pixel en Conversions API** kun je bezoek en bestellingen in je ticketshop aan Meta doorgeven. Zo kun je in Meta bekijken welke resultaten je advertenties opleveren.

We verzorgen de koppeling vanuit TicketSoft. Je vult je eigen Pixel-ID in en kiest hoe je wilt meten. Je hoeft hiervoor zelf geen pixelscript aan je ticketshop toe te voegen.

## Wat heb je nodig?

* Toegang tot het Meta-bedrijfsaccount met de pixel die je wilt gebruiken.
* Het **Pixel-ID** van die pixel.
* Een link naar het **eigen privacybeleid van je organisatie**.
* Voor de Conversions API: een toegangstoken voor de gekozen pixel.

Alleen een eigenaar of administrator van je TicketSoft-organisatie kan de module instellen. Zie je de module niet bij **Modules > Alle modules**? Neem dan [contact met ons op](https://ticketsoft.nl/contact).

## Kies hoe je wilt meten

| Meetmethode | Hoe werkt het? | Wat vul je in? |
| - | - | - |
| Alleen Meta Pixel | De browser van je bezoeker stuurt de metingen naar Meta. | Pixel-ID. |
| Pixel + Conversions API | De browser en TicketSoft sturen metingen naar Meta. We geven dezelfde herkenning mee, zodat Meta dubbele metingen kan herkennen. | Pixel-ID en toegangstoken. |
| Alleen Conversions API | TicketSoft stuurt de metingen naar Meta, zonder browserpixel. Deze keuze staat onder **Andere meetopties**. | Pixel-ID en toegangstoken. |

Voor elke meetmethode is toestemming van de bezoeker nodig, ook als je alleen via de Conversions API meet.

## De module inschakelen

**1. Open de Meta-module**

Open je evenement, ga naar **Modules** en kies **Alle modules**. Open **Meta Pixel en Conversions API** en klik op **Configureren**.

**2. Vul je Pixel-ID in**

Plak het nummer bij **Meta Pixel-ID**. Bij **Waar vind ik mijn Pixel-ID?** vind je uitleg en een link naar Meta Gebeurtenisbeheer.

**3. Kies de meetmethode**

Kies hoe je wilt meten. Gebruik je de Conversions API, vul dan ook het **Conversions API-toegangstoken** in. De uitleg bij het veld helpt je om dit token bij Meta op te halen.

**4. Kies voor welke evenementen dit geldt**

Kies **Alleen dit evenement** of **Alle huidige en toekomstige evenementen**. Bij de tweede keuze deel je dezelfde Meta-instellingen met de evenementen die deze gedeelde instellingen gebruiken.

**5. Controleer je privacybeleid**

We gebruiken de link naar het privacybeleid van je organisatie. Ontbreekt die, dan vragen we je om de link in te vullen. De link wordt voor je organisatie opgeslagen en geldt voor alle evenementen, ook als je de Meta-module alleen voor dit evenement inschakelt.

**6. Sla op**

Klik op **Module inschakelen**. Bekijk daarna de opgeslagen instellingen en controleer of je nog een melding ziet.

Een link naar het privacybeleid van TicketSoft is hiervoor niet voldoende. Gebruik je eigen privacybeleid en leg daarin uit hoe je de Meta-koppeling gebruikt en welke gegevens je deelt.

> [!NOTE]
>
> Heb je al een Meta Pixel toegevoegd via eigen code of een andere koppeling? Controleer die inrichting voordat je de module inschakelt. Zo voorkom je dat dezelfde stappen meerdere keren worden gemeten. De toestemmingsmelding van deze module beheert de Meta-metingen die via deze module lopen.

## Welke stappen meten we?

Na toestemming kan de module de volgende momenten doorgeven:

| Moment | Naam in Meta |
| - | - |
| Bezoek aan de ticketshop of verkooppagina | PageView |
| Bekijken van het evenement | ViewContent |
| Tickets toevoegen aan de winkelmand | AddToCart |
| Beginnen met afrekenen | InitiateCheckout |
| Een betaalde bestelling via de ticketshop | Purchase |

Bij een aankoop geven we het werkelijk betaalde bestelbedrag door, met kortingen en kosten die de bezoeker betaalt. Een afgeronde gratis bestelling via de ticketshop krijgt een waarde van €0. Gasten, deurverkoop, geïmporteerde en administratief toegevoegde bestellingen worden niet als aankoop doorgestuurd. Terugbetalingen worden niet als aparte meting doorgegeven.

## Wat zien je bezoekers?

Wanneer de module actief is, tonen we automatisch een privacykeuze in de ticketshop en op de verkooppagina. Bezoekers kunnen **Afwijzen**, **Selectie toestaan** of **Alles toestaan** kiezen. Bij de details staat welke gegevens met Meta gedeeld kunnen worden.

Zonder toestemming sturen we via deze module geen metingen naar Meta. Een bezoeker die afwijst, kan gewoon tickets bestellen.

De keuze geldt voor jouw organisatie en wordt 13 maanden onthouden. Via de privacyknop bovenaan de ticketshop, naast de toegankelijkheidsknop, kan de bezoeker de keuze later aanpassen of toestemming intrekken. Daarna stopt de module met nieuwe Meta-metingen voor die bezoeker.

Afhankelijk van de meetmethode kunnen onder andere bezochte pagina's, ticketkeuzes, winkelmandjes en aankopen worden gedeeld. Bij de Conversions API kunnen ook het IP-adres, browsergegevens en gegevens over een advertentieklik worden meegestuurd. Je leest meer over de organisatie-instellingen bij [Privacy en bewaartermijnen](https://ticketsoft.nl/docs/organisator/account/privacy-en-bewaartermijnen.md).

## Controleren of de Conversions API werkt

Gebruik je de Conversions API, dan zie je bij de module het onderdeel **Conversions API-verbinding**.

| Status | Betekenis |
| - | - |
| Ingesteld, wacht op eerste servermeting | De instellingen zijn opgeslagen. Er is nog geen echte meting vanuit TicketSoft door Meta geaccepteerd. |
| CAPI-verbinding bevestigd | Meta heeft een echte meting vanuit TicketSoft geaccepteerd. Bij **Laatste bevestiging** zie je wanneer dit gebeurde. |
| CAPI-verbinding vraagt aandacht | Er is een probleem gemeld. Lees de melding en controleer bijvoorbeeld het token en het Pixel-ID. |

Open je ticketshop als bezoeker en geef toestemming voor Meta om de koppeling te controleren. Kies daarna bij de module **Status vernieuwen**. Alleen instellingen opslaan is nog geen bevestiging dat een meting is ontvangen.

Een bevestigde verbinding betekent dat Meta een meting heeft ontvangen. Het betekent niet automatisch dat Meta die meting aan een specifieke advertentie toeschrijft. Daardoor kunnen de resultaten in Meta afwijken van de verkoopcijfers in TicketSoft, bijvoorbeeld wanneer bezoekers geen toestemming geven.

### Recente servermetingen bekijken

Klap **Recente servermetingen bekijken** open voor de 20 recentste metingen vanuit TicketSoft voor deze Meta-configuratie. Bij gedeelde instellingen kunnen daar metingen van meerdere evenementen tussen staan.

Je ziet het moment, het type meting, de verzendstatus, het aantal pogingen en een eventuele melding. Via het oog-icoon bekijk je meer details, zoals het evenement, het bedrag en de tickets.

* **In wachtrij**: de meting wacht op verzending of een nieuwe poging.
* **Verzonden**: de meting is naar Meta verstuurd.
* **Mislukt**: het versturen is niet gelukt. Bekijk de laatste melding.

Dit overzicht gaat over de Conversions API. Metingen die alleen via de browserpixel lopen, staan hier niet in.

## Instellingen of toegangstoken wijzigen

Open de module en klik op **Instellingen wijzigen**. Laat het tokenveld leeg om het opgeslagen token te behouden. Vul een nieuw token in om het te vervangen. We slaan het token versleuteld op en tonen de opgeslagen waarde niet opnieuw.

Je kunt het token ook vervangen bij **Conversions API-verbinding** via **Toegangstoken vervangen**. Bij een gedeelde configuratie geldt het nieuwe token voor alle evenementen die deze configuratie gebruiken. De verbinding wordt daarna opnieuw bevestigd zodra Meta een echte meting met het nieuwe token accepteert.

Bij een probleem met het token kunnen we de Conversions API-metingen pauzeren. De melding bij de verbinding geeft aan wat je moet doen. Gebruik je ook de browserpixel, dan kan die na toestemming actief blijven.

## De module uitschakelen

Klap **Module uitschakelen** open. Bij gedeelde instellingen kies je of je Meta alleen voor dit evenement of voor alle evenementen met deze gedeelde instellingen wilt uitschakelen. Je instellingen blijven bewaard.

Meer uitleg over gedeelde instellingen vind je bij [Modules beheren](https://ticketsoft.nl/docs/organisator/modules/overzicht.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.