De catalogus
| Categorie | Events | Standaarddoeleinden |
|---|---|---|
| engagement | page_view, view_content, search, download | analytics |
| auth | sign_up, login | analytics |
| lead | generate_lead, contact, book_appointment | analytics, marketing |
| commerce | view_item_list, select_item, view_item, add_to_wishlist, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase, refund | analytics, marketing |
| subscription | subscribe, start_trial | analytics, marketing |
De namen volgen het vocabulaire van de aanbevolen GA4-events waar dat bestaat, omdat het de meest geïmplementeerde datalayer-vorm is en de SDK GA4-achtige dataLayer-pushes rechtstreeks kan waarnemen. De categorieën bepalen de standaard toestemmingsdoeleinden: commerce-, lead- en subscription-events zijn conversiesignalen die advertentieplatformen willen hebben, dus ze vereisen het doeleinde marketing om een advertentie-destination te bereiken; engagement- en auth-events zijn standaard analytics.
Properties
Elk event draagt de envelop mee: event-ID, tijdstempel, URL (met click-ID's eruit gehaald), referrer, titel, toestemmingsregistratie, bron en — als de toestemming dat toelaat — anonieme ID, sessie-ID, gebruikers-ID en gehashte identifiers.
Commerce-events voegen een getypeerd commerce-blok toe: currency, value, transaction_id, coupon, shipping, tax en items[] met item_id, item_name, price, quantity, item_category, item_brand, item_variant. refund draagt de oorspronkelijke transaction_id en een negatieve of gedeeltelijke waarde.
Lead- en subscription-events gebruiken een kleine set properties: lead_type, form_id, plan, interval, trial_days, value waar een gedocumenteerde waarde bestaat.
Al het andere gaat in props, dat tegen het schema van de site wordt gevalideerd: onbekende sleutels worden als bevindingen gerapporteerd, vrije tekst wordt gescand op persoonsgegevens en geneste objecten worden geredigeerd in plaats van doorgestuurd.
Eigen events
Eigen namen zijn toegestaan als ze voldoen aan ^[a-z][a-z0-9_]{2,39}$, niet botsen met een standaardnaam en in het trackingplan zijn gedeclareerd. Niet-gedeclareerde eigen events worden geaccepteerd, geteld en als schemabevindingen gerapporteerd, zodat het plan bewust kan worden bijgewerkt; ze worden pas aan advertentie-destinations afgeleverd zodra ze zijn gemapt.
Vertaling naar platformen
Omdat het vocabulaire vast is, levert elke connector een standaardmapping mee:
| Canoniek | Meta | Google Ads | GA4 | TikTok | Snapchat | ||
|---|---|---|---|---|---|---|---|
view_item | ViewContent | — | view_item | ViewContent | — | page_visit | VIEW_CONTENT |
add_to_cart | AddToCart | — | add_to_cart | AddToCart | — | add_to_cart | ADD_CART |
begin_checkout | InitiateCheckout | — | begin_checkout | InitiateCheckout | — | — | START_CHECKOUT |
purchase | Purchase | conversieactie | purchase | CompletePayment | conversieregel | checkout | PURCHASE |
generate_lead | Lead | conversieactie | generate_lead | SubmitForm | conversieregel | lead | SIGN_UP |
sign_up | CompleteRegistration | conversieactie | sign_up | CompleteRegistration | conversieregel | signup | SIGN_UP |
subscribe | Subscribe | conversieactie | — | Subscribe | conversieregel | — | SUBSCRIBE |
start_trial | StartTrial | conversieactie | — | StartTrial | conversieregel | — | START_TRIAL |
Een streepje betekent dat het platform geen standaardequivalent heeft; je kunt naar een eigen platform-event mappen of de rij uitgeschakeld laten. Elke standaard is per destination bewerkbaar, en elke wijziging wordt geversioneerd en verschijnt in de publicatie-diff.
Regels die het plan eerlijk houden
- Eén event per gebruikersactie.
purchasevuurt één keer per bestelling, vanuit de bron die voor die site leidend is (browser, shopwebhook of server), met dezelfde event-ID of order-ID op elk pad. - Waarden komen uit het bronsysteem. Er is geen standaardwaarde; een niet-gemapte waarde is
null, en een platform dat er een vereist, wijst de rij zichtbaar af. - Terugbetalingen zijn events, geen bewerkingen. Een
refundverwijst naar de oorspronkelijke transactie; de oorspronkelijkepurchasewordt nooit herschreven. - Namen zijn in kleine letters met underscores (snake_case). De schrijfwijze van het platform (
CompletePayment,PURCHASE) is de zorg van de connector.