Skip to content
Helpcentrum-gids · Pass-distributie
3 min leestijdGecontroleerd 2026-11-16

UTM-trackingparameters

Volg marketingcampagnes, advertentiebronnen en conversietrechters op pass-distributielinks en PassFlows met first-touch-attributie.

In deze gids

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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
UTM-ATTRIBUTIE & TELEMETRIEPIPELINE
FASE 01 CONTACTPUNT VAN DE MARKETINGCAMPAGNE
Klant klikt op link of scant QR-code met UTM-tags: https://app.passinstance.com/f/vip-club?utm_source=instagram&utm_medium=story...
FASE 02 UTM-VERWERKINGS- & ATTRIBUTIE-ENGINE
Leest querytags uit: utm_source, utm_medium, utm_campaign, utm_term, …
Legt HTTP Referer en initiële landingUrl vast
Handhaaft first-touch-attributie (ATTRIBUTION_MODEL = 'FIRST_TOUCH')
FASE 03 OPSLAG VAN PASATTRIBUTIE (DATABASE)
Permanent opgeslagen in het JSON-veld Pass.attribution:
utm_source: "instagram"
utm_medium: "story"
utm_campaign: "summer_promo_2026"
tag: "influencer_sarah"
capturedAt: ISO-tijdstempel | capturedFrom: "PASSFLOW"
FASE 04A CSV-EXPORT & ANALYTICS
Opgenomen in POST/passes/export
Filter cohorten op marketingcampagne
FASE 04B INTEGRATIEWEBHOOKS
Doorgestuurd in pass.created
Sync naar CRM / Google Analytics

Ondersteunde UTM-tags & parameters

Passinstance volgt de gangbare Google Analytics UTM-taxonomie, aangevuld met eigen tags:

ParametersleutelDoelVoorbeeldwaardeMeest geschikt voor
utm_sourceIdentificeert het verkeersplatform of de verwijzerfacebook, instagram, newsletter, counter_qrBepalen welk platform de bezoeker heeft aangebracht
utm_mediumHet marketingkanaal of distributiemediumcpc, social, email, print_flyer, smsOnderscheid maken tussen betaalde advertenties, organisch verkeer en drukwerk
utm_campaignSpecifieke naam van de promotiecampagnespring_launch_2026, black_friday_vip, store_openingGroeperen van passen die binnen een bepaald initiatief zijn uitgegeven
utm_termBetaald zoekwoord of doelgroepsegmentloyalty_rewards, coffee_club, fitness_subMeten van specifieke advertentiezoekwoorden of doelgroepvarianten
utm_contentSpecifieke advertentievariant of call-to-actionblue_button, story_ad_v2, table_stand_4A/B-testen van advertenties of verschillende balielocaties
utm_idCampagne-ID uit CRM of marketingautomatiseringcamp_01j8k9m2, ad_99214Koppelen van pasuitgifte aan Google Ads- of HubSpot-ID's
tagVrije categorisatie-identificatorstore_munich, partner_nike, staff_alexEigen 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. 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. 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. 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. 1
    Open uw sjabloon in het dashboard.
  2. 2
    Ga naar Functionaliteiten -> UTM & tracking (/templates/:templateId/utm-tracking).
  3. 3
    Schakel UTM-parametertracking inschakelen in.
  4. 4
    Stel standaardparameters in voor reguliere sjabloonlinks, of definieer verplichte attributiesleutels voor partnercampagnes.

Via de API (UTM Tracking API):

HTTP
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_LINK of DIRECT_API)
  • attribution_landing_url
  • attribution_referrer

Voorbeeld van een geëxporteerde CSV-rij:

CSV
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:

TEXT
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:

TEXT
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:

TEXT
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11

Gerelateerde documentatie

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.