Panoramica su attribuzione marketing e tracciamento campagne
Quando distribuisci pass digitali tramite inserzioni sui social media, collaborazioni con influencer, newsletter e-mail, espositori QR in negozio e reti di affiliazione, misurare il ROI di ciascun canale è fondamentale. Passinstance include un sistema nativo di Tracciamento dei parametri UTM (UTM Attribution Engine e UTM Tracking API su /templates/:templateId/utm-tracking) per acquisire le sorgenti di traffico, monitorare le conversioni di iscrizione ai pass e registrare l'attribuzione marketing first-touch direttamente su ogni record di pass emesso.
Tag e parametri UTM supportati
Passinstance standardizza la tassonomia UTM di Google Analytics riconosciuta nel settore insieme a tag personalizzati:
| Chiave parametro | Scopo | Valore di esempio | Ideale per |
|---|---|---|---|
utm_source | Identifica la piattaforma di traffico o il referrer | facebook, instagram, newsletter, counter_qr | Determinare quale piattaforma ha generato il visitatore |
utm_medium | Il canale marketing o il mezzo di distribuzione | cpc, social, email, print_flyer, sms | Distinguere annunci a pagamento da traffico organico o materiale stampato |
utm_campaign | Nome specifico della campagna promozionale | spring_launch_2026, black_friday_vip, store_opening | Raggruppare i pass emessi nell'ambito di una specifica iniziativa |
utm_term | Parola chiave a pagamento o segmento di audience | loyalty_rewards, coffee_club, fitness_sub | Tracciare specifiche parole chiave degli annunci o varianti di audience |
utm_content | Specifica creatività pubblicitaria o variante CTA | blue_button, story_ad_v2, table_stand_4 | Test A/B delle varianti di annuncio o dei diversi punti di esposizione |
utm_id | ID campagna CRM o marketing automation | camp_01j8k9m2, ad_99214 | Correlare l'emissione del pass con gli ID di Google Ads o HubSpot |
tag | Identificatore di categorizzazione libero | store_munich, partner_nike, staff_alex | Tag di tracciamento personalizzati specifici del tuo flusso operativo |
Modello di attribuzione First-Touch (FIRST_TOUCH)
Passinstance implementa un Modello di attribuzione First-Touch (ATTRIBUTION_MODEL = 'FIRST_TOUCH', FIRST_TOUCH_SOURCE = 'UTM_FIRST_TOUCH'):
-
1
Blocco nella sessione: quando un potenziale cliente atterra per la prima volta su un PassFlow pubblico (
/f/:slug) o su uno Smart Link (/d/:slug) contenente parametri UTM, Passinstance memorizza il pacchetto di attribuzione nello storage di sessione. -
2
Invariante First-Touch: se il cliente naviga altrove, confronta piani o ritorna ore dopo tramite un link diretto, la sorgente della campagna originale che lo ha portato per prima al tuo brand viene preservata.
-
3
Telemetria del pass immutabile: una volta generato il pass, l'oggetto di attribuzione viene sigillato nel record del pass sul database. Modifiche o aggiornamenti successivi del pass non sovrascriveranno mai la telemetria di acquisizione originale.
Configurazione delle regole UTM tramite Dashboard e API
Dalla Dashboard:
-
1
Apri il modello nella dashboard.
-
2
Vai su Funzionalità -> UTM e tracciamento (
/templates/:templateId/utm-tracking). -
3
Attiva l'opzione Abilita tracciamento parametri UTM.
-
4
Imposta i parametri predefiniti per i link standard del modello oppure definisci le chiavi di attribuzione richieste per le campagne partner.
Tramite 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
}
Esportazione dell'attribuzione UTM nei dati dei pass
Tutti i parametri di attribuzione acquisiti vengono inclusi quando esporti coorti di pass in CSV o interroghi i pass tramite REST API (POST /passes/export e GET /api/v1/passes):
Colonne di telemetria esportate:
-
utm_source -
utm_medium -
utm_campaign -
utm_term -
utm_content -
utm_id -
tag -
attribution_model(FIRST_TOUCH) -
attribution_captured_at(timestamp ISO) -
attribution_captured_from(PASSFLOW,SMART_LINKoDIRECT_API) -
attribution_landing_url -
attribution_referrer
Esempio di riga CSV esportata:
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
Esempi di composizione URL per campagne marketing
Quando distribuisci i tuoi link pubblici, aggiungi i parametri UTM usando la sintassi standard delle query string URL:
1. Codice QR su cavalierino da tavolo in negozio:
https://app.passinstance.com/f/coffee-club?utm_source=in_store&utm_medium=qr_code&utm_campaign=table_tents&tag=table_12
2. Inserzione Instagram Story con swipe-up:
https://app.passinstance.com/f/coffee-club?utm_source=instagram&utm_medium=story_ad&utm_campaign=summer_promo_2026&utm_content=video_b
3. Piè di pagina newsletter e-mail:
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11
Documentazione correlata
-
Distribuzione self-service — PassFlow, smart link e distribuzione NFC.
-
Vendere pass — Monetizzazione dei pass tramite checkout PassFlow.
-
Esportazione dati e reportistica — Esportazione in CSV delle coorti di pass e della telemetria.
