Overzicht van marketingattributie & campagnetracking
Wanneer u digitale passen verspreidt via socialmedia-advertenties, influencersamenwerkingen, e-mailnieuwsbrieven, QR-displays in de winkel en affiliatenetwerken, is inzicht in het rendement per kanaal cruciaal. Passinstance bevat native UTM-parametertracking (UTM Attribution Engine en UTM Tracking API op /templates/:templateId/utm-tracking) om verkeersbronnen vast te leggen, pasinschrijfconversies te meten en first-touch marketingattributie rechtstreeks op elk uitgegeven pasrecord op te slaan.
Ondersteunde UTM-tags & parameters
Passinstance volgt de gangbare Google Analytics UTM-taxonomie, aangevuld met eigen tags:
| Parametersleutel | Doel | Voorbeeldwaarde | Meest geschikt voor |
|---|---|---|---|
utm_source | Identificeert het verkeersplatform of de verwijzer | facebook, instagram, newsletter, counter_qr | Bepalen welk platform de bezoeker heeft aangebracht |
utm_medium | Het marketingkanaal of distributiemedium | cpc, social, email, print_flyer, sms | Onderscheid maken tussen betaalde advertenties, organisch verkeer en drukwerk |
utm_campaign | Specifieke naam van de promotiecampagne | spring_launch_2026, black_friday_vip, store_opening | Groeperen van passen die binnen een bepaald initiatief zijn uitgegeven |
utm_term | Betaald zoekwoord of doelgroepsegment | loyalty_rewards, coffee_club, fitness_sub | Meten van specifieke advertentiezoekwoorden of doelgroepvarianten |
utm_content | Specifieke advertentievariant of call-to-action | blue_button, story_ad_v2, table_stand_4 | A/B-testen van advertenties of verschillende balielocaties |
utm_id | Campagne-ID uit CRM of marketingautomatisering | camp_01j8k9m2, ad_99214 | Koppelen van pasuitgifte aan Google Ads- of HubSpot-ID's |
tag | Vrije categorisatie-identificator | store_munich, partner_nike, staff_alex | Eigen trackingtags specifiek voor uw bedrijfsproces |
First-touch-attributiemodel (FIRST_TOUCH)
Passinstance hanteert een First-Touch-attributiemodel (ATTRIBUTION_MODEL = 'FIRST_TOUCH', FIRST_TOUCH_SOURCE = 'UTM_FIRST_TOUCH'):
-
1
Sessiekoppeling: Zodra een potentiële klant voor het eerst op een openbare PassFlow (
/f/:slug) of Slimme link (/d/:slug) met UTM-parameters landt, schrijft Passinstance het attributiepakket weg in de sessieopslag. -
2
First-touch-invariant: Als de klant tussentijds wegklikt, pakketten vergelijkt of uren later via een directe link terugkeert, blijft de oorspronkelijke campagnebron behouden waarmee de klant voor het eerst bij uw merk terechtkwam.
-
3
Onveranderlijke pastelemetrie: Zodra de pas wordt gegenereerd, wordt het attributieobject definitief vastgelegd in het pasrecord in de database. Latere bewerkingen of updates van de pas overschrijven nooit de oorspronkelijke acquisitietelemetrie.
UTM-regels configureren via Dashboard & API
Via het Dashboard:
-
1
Open uw sjabloon in het dashboard.
-
2
Ga naar Functionaliteiten -> UTM & tracking (
/templates/:templateId/utm-tracking). -
3
Schakel UTM-parametertracking inschakelen in.
-
4
Stel standaardparameters in voor reguliere sjabloonlinks, of definieer verplichte attributiesleutels voor partnercampagnes.
Via de API (UTM Tracking API):
PUT /api/v1/templates/{templateId}/utm-tracking HTTP/1.1
Host: api.passinstance.com
X-API-Key: <API_KEY>
Content-Type: application/json
{
"enabled": true,
"defaultSource": "direct",
"defaultMedium": "web",
"allowedTags": ["store_location", "promoter_id", "partner_code"],
"trackDeviceTelemetry": true
}
UTM-attributie exporteren bij pasexports
Alle vastgelegde attributieparameters worden meegenomen wanneer u pascohorten naar CSV exporteert of passen opvraagt via de REST API (POST /passes/export en GET /api/v1/passes):
Geëxporteerde telemetriekolommen:
-
utm_source -
utm_medium -
utm_campaign -
utm_term -
utm_content -
utm_id -
tag -
attribution_model(FIRST_TOUCH) -
attribution_captured_at(ISO-tijdstempel) -
attribution_captured_from(PASSFLOW,SMART_LINKofDIRECT_API) -
attribution_landing_url -
attribution_referrer
Voorbeeld van een geëxporteerde CSV-rij:
id,serialNumber,externalId,status,utm_source,utm_medium,utm_campaign,tag,capturedAt
pass_01j9x1,PI-8821,CUST-901,ACTIVE,instagram,story,spring_launch_2026,influencer_maya,2026-03-15T14:22:10Z
Voorbeelden voor het opbouwen van campagne-URL's
Voeg bij het verspreiden van uw openbare links UTM-parameters toe volgens standaard URL-querysyntaxis:
1. QR-code op tafelkaartje in de winkel:
https://app.passinstance.com/f/coffee-club?utm_source=in_store&utm_medium=qr_code&utm_campaign=table_tents&tag=table_12
2. Instagram Story Swipe-Up-advertentie:
https://app.passinstance.com/f/coffee-club?utm_source=instagram&utm_medium=story_ad&utm_campaign=summer_promo_2026&utm_content=video_b
3. Voettekst in e-mailnieuwsbrief:
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11
Gerelateerde documentatie
-
Selfservice-distributie — PassFlows, slimme links en NFC-distributie.
-
Passen verkopen — Passen verkopen via PassFlow-checkout.
-
Gegevensexports & rapportages — Pascohorten en telemetrie exporteren naar CSV.
