Aperçu de l'attribution marketing & du suivi de campagnes
Lorsque vous diffusez des passes numériques via des publicités sur les réseaux sociaux, des partenariats d'influenceurs, des newsletters, des présentoirs QR en magasin et des réseaux d'affiliation, la mesure du retour sur investissement par canal est essentielle. Passinstance intègre nativement le suivi des paramètres UTM (UTM Attribution Engine et UTM Tracking API sur /templates/:templateId/utm-tracking) afin de capturer les sources de trafic, suivre les conversions d'inscription et consigner l'attribution marketing au premier contact directement sur chaque passe émis.
Balises & paramètres UTM pris en charge
Passinstance normalise la taxonomie UTM standard de Google Analytics ainsi que les balises personnalisées :
| Clé de paramètre | Objectif | Exemple de valeur | Idéal pour |
|---|---|---|---|
utm_source | Identifie la plateforme de trafic ou le référent | facebook, instagram, newsletter, counter_qr | Savoir quelle plateforme a amené le visiteur |
utm_medium | Canal marketing ou support de diffusion | cpc, social, email, print_flyer, sms | Distinguer la publicité payante de l'organique ou des supports imprimés |
utm_campaign | Nom de la campagne promotionnelle | spring_launch_2026, black_friday_vip, store_opening | Regrouper les passes émis dans le cadre d'une opération précise |
utm_term | Mot-clé publicitaire payant ou segment d'audience | loyalty_rewards, coffee_club, fitness_sub | Suivre des mots-clés d'annonces ou des variantes d'audience |
utm_content | Créatif publicitaire ou variante d'appel à l'action | blue_button, story_ad_v2, table_stand_4 | Réaliser des tests A/B sur les annonces ou emplacements en magasin |
utm_id | Identifiant de campagne CRM ou d'automatisation | camp_01j8k9m2, ad_99214 | Corréler l'émission de passes avec les IDs Google Ads ou HubSpot |
tag | Identifiant libre de catégorisation | store_munich, partner_nike, staff_alex | Balises de suivi sur mesure propres à votre activité |
Modèle d'attribution au premier contact (FIRST_TOUCH)
Passinstance applique un modèle d'attribution au premier contact (ATTRIBUTION_MODEL = 'FIRST_TOUCH', FIRST_TOUCH_SOURCE = 'UTM_FIRST_TOUCH') :
-
1
Ancrage de session : lorsqu'un prospect arrive pour la première fois sur un PassFlow public (
/f/:slug) ou un lien intelligent (/d/:slug) comportant des paramètres UTM, Passinstance enregistre le paquet d'attribution dans le stockage de session. -
2
Invariant premier contact : si le client quitte la page, compare vos offres ou revient plusieurs heures plus tard via un lien direct, la source de campagne d'origine qui l'a fait découvrir votre marque est conservée.
-
3
Télémétrie immuable du passe : une fois le passe généré, l'objet d'attribution est scellé dans la fiche du passe en base de données. Les modifications ou mises à jour ultérieures du passe n'écrasent jamais la télémétrie d'acquisition d'origine.
Configurer les règles UTM via le tableau de bord & l'API
Via le tableau de bord :
-
1
Ouvrez votre modèle dans le tableau de bord.
-
2
Accédez à Fonctionnalités -> UTM & suivi (
/templates/:templateId/utm-tracking). -
3
Activez l'option Activer le suivi des paramètres UTM (Enable UTM Parameter Tracking).
-
4
Définissez des paramètres par défaut pour les liens standards du modèle ou déclarez les clés d'attribution requises pour les campagnes partenaires.
Via l'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
}
Exporter l'attribution UTM dans les exports de passes
Tous les paramètres d'attribution capturés sont inclus lorsque vous exportez des cohortes de passes en CSV ou que vous interrogez les passes via l'API REST (POST /passes/export et GET /api/v1/passes) :
Colonnes de télémétrie exportées :
-
utm_source -
utm_medium -
utm_campaign -
utm_term -
utm_content -
utm_id -
tag -
attribution_model(FIRST_TOUCH) -
attribution_captured_at(horodatage ISO) -
attribution_captured_from(PASSFLOW,SMART_LINKouDIRECT_API) -
attribution_landing_url -
attribution_referrer
Exemple de ligne d'export 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
Exemples de construction d'URL pour vos campagnes marketing
Lors de la diffusion de vos liens publics, ajoutez les paramètres UTM selon la syntaxe standard des chaînes de requête URL :
1. QR code de chevalet de table en magasin :
https://app.passinstance.com/f/coffee-club?utm_source=in_store&utm_medium=qr_code&utm_campaign=table_tents&tag=table_12
2. Publicité Story Instagram avec lien :
https://app.passinstance.com/f/coffee-club?utm_source=instagram&utm_medium=story_ad&utm_campaign=summer_promo_2026&utm_content=video_b
3. Pied de page de newsletter e-mail :
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11
Documentation connexe
-
Distribution en libre-service — PassFlows, liens intelligents et distribution NFC.
-
Vendre des passes — Monétiser des passes via le paiement PassFlow.
-
Exports de données & rapports — Exporter des cohortes de passes et la télémétrie en CSV.
