Skip to content
Guide du centre d'aide · Distribution des passes
4 min de lectureVérifié 2026-11-16

Paramètres de suivi UTM

Suivez les campagnes marketing, les sources publicitaires et les entonnoirs de conversion sur les liens de distribution de cartes et les PassFlows avec attribution au premier contact.

Dans ce guide

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.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ATTRIBUTION UTM & PIPELINE DE TÉLÉMÉTRIE
ÉTAPE 01 POINT DE CONTACT DE CAMPAGNE MARKETING
Le client clique sur un lien ou scanne un QR code portant des balises UTM : https://app.passinstance.com/f/vip-club?utm_source=instagram&utm_medium=story...
ÉTAPE 02 MOTEUR D'INGESTION & D'ATTRIBUTION UTM
Capture les paramètres : utm_source, utm_medium, utm_campaign, etc.
Enregistre l'en-tête HTTP Referer et l'URL d'arrivée (landingUrl)
Applique l'attribution au premier contact (ATTRIBUTION_MODEL = 'FIRST_TOUCH')
ÉTAPE 03 PERSISTANCE DE L'ATTRIBUTION DU PASSE (BASE DE DONNÉES)
Stockée de façon permanente dans le champ JSON Pass.attribution :
utm_source : "instagram"
utm_medium : "story"
utm_campaign : "summer_promo_2026"
tag : "influencer_sarah"
capturedAt : horodatage ISO | capturedFrom : "PASSFLOW"
ÉTAPE 04A EXPORT CSV & ANALYTIQUES
Inclus dans POST/passes/export
Filtrage des cohortes par campagne
ÉTAPE 04B WEBHOOKS D'INTÉGRATION
Transmis dans pass.created
Synchro CRM / Google Analytics 4

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ètreObjectifExemple de valeurIdéal pour
utm_sourceIdentifie la plateforme de trafic ou le référentfacebook, instagram, newsletter, counter_qrSavoir quelle plateforme a amené le visiteur
utm_mediumCanal marketing ou support de diffusioncpc, social, email, print_flyer, smsDistinguer la publicité payante de l'organique ou des supports imprimés
utm_campaignNom de la campagne promotionnellespring_launch_2026, black_friday_vip, store_openingRegrouper les passes émis dans le cadre d'une opération précise
utm_termMot-clé publicitaire payant ou segment d'audienceloyalty_rewards, coffee_club, fitness_subSuivre des mots-clés d'annonces ou des variantes d'audience
utm_contentCréatif publicitaire ou variante d'appel à l'actionblue_button, story_ad_v2, table_stand_4Réaliser des tests A/B sur les annonces ou emplacements en magasin
utm_idIdentifiant de campagne CRM ou d'automatisationcamp_01j8k9m2, ad_99214Corréler l'émission de passes avec les IDs Google Ads ou HubSpot
tagIdentifiant libre de catégorisationstore_munich, partner_nike, staff_alexBalises 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. 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. 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. 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. 1
    Ouvrez votre modèle dans le tableau de bord.
  2. 2
    Accédez à Fonctionnalités -> UTM & suivi (/templates/:templateId/utm-tracking).
  3. 3
    Activez l'option Activer le suivi des paramètres UTM (Enable UTM Parameter Tracking).
  4. 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) :

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
}

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

Exemple de ligne d'export CSV :

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 :

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

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. Pied de page de newsletter e-mail :

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

Documentation connexe

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.