Descripción general de la atribución de marketing y el seguimiento de campañas
Al distribuir pases digitales en anuncios de redes sociales, colaboraciones con creadores, boletines por correo electrónico, códigos QR en tienda y redes de afiliados, medir el retorno de inversión por canal es fundamental. Passinstance incluye seguimiento nativo de parámetros UTM (UTM Attribution Engine y UTM Tracking API en /templates/:templateId/utm-tracking) para capturar fuentes de tráfico, medir conversiones de registro de pases y registrar la atribución de marketing al primer contacto directamente en cada registro de pase emitido.
Etiquetas y parámetros UTM admitidos
Passinstance estandariza la taxonomía UTM estándar de la industria de Google Analytics junto con etiquetas personalizadas:
| Clave de parámetro | Propósito | Valor de ejemplo | Ideal para |
|---|---|---|---|
utm_source | Identifica la plataforma de tráfico o el origen de referencia | facebook, instagram, newsletter, counter_qr | Determinar qué plataforma generó la visita |
utm_medium | Canal de marketing o medio de distribución | cpc, social, email, print_flyer, sms | Distinguir anuncios de pago de tráfico orgánico o material impreso |
utm_campaign | Nombre concreto de la campaña promocional | spring_launch_2026, black_friday_vip, store_opening | Agrupar pases emitidos dentro de una iniciativa específica |
utm_term | Palabra clave de búsqueda de pago o segmento de audiencia | loyalty_rewards, coffee_club, fitness_sub | Rastrear palabras clave específicas o variantes de audiencia |
utm_content | Creatividad publicitaria o variante específica de llamada a la acción | blue_button, story_ad_v2, table_stand_4 | Pruebas A/B de anuncios o distintas ubicaciones en punto de venta |
utm_id | ID de campaña de CRM o automatización de marketing | camp_01j8k9m2, ad_99214 | Correlacionar la emisión de pases con IDs de Google Ads o HubSpot |
tag | Identificador libre de categorización | store_munich, partner_nike, staff_alex | Etiquetas personalizadas específicas de su flujo operativo |
Modelo de atribución al primer contacto (FIRST_TOUCH)
Passinstance implementa un modelo de atribución al primer contacto (ATTRIBUTION_MODEL = 'FIRST_TOUCH', FIRST_TOUCH_SOURCE = 'UTM_FIRST_TOUCH'):
-
1
Fijación de sesión: Cuando un cliente potencial aterriza por primera vez en un PassFlow público (
/f/:slug) o en un enlace inteligente (/d/:slug) con parámetros UTM, Passinstance guarda el paquete de atribución en el almacenamiento de sesión. -
2
Invariante de primer contacto: Si el cliente sale de la página, compara planes o regresa horas después mediante un enlace directo, se conserva la fuente de campaña original que lo atrajo inicialmente a su marca.
-
3
Telemetría inmutable del pase: Una vez generado el pase, el objeto de atribución queda sellado en el registro del pase en la base de datos. Las ediciones o actualizaciones posteriores del pase nunca sobrescriben la telemetría de adquisición original.
Configurar reglas UTM desde el panel de control y la API
Desde el panel de control:
-
1
Abra su plantilla en el panel de control.
-
2
Vaya a Funcionalidades -> UTM y seguimiento (
/templates/:templateId/utm-tracking). -
3
Active Habilitar seguimiento de parámetros UTM.
-
4
Defina parámetros predeterminados para enlaces estándar de plantilla o establezca claves de atribución obligatorias para campañas de socios.
Mediante 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
}
Exportación de la atribución UTM en exportaciones de pases
Todos los parámetros de atribución capturados se incluyen al exportar cohortes de pases a CSV o al consultar pases mediante la API REST (POST /passes/export y GET /api/v1/passes):
Columnas de telemetría exportadas:
-
utm_source -
utm_medium -
utm_campaign -
utm_term -
utm_content -
utm_id -
tag -
attribution_model(FIRST_TOUCH) -
attribution_captured_at(marca temporal ISO) -
attribution_captured_from(PASSFLOW,SMART_LINKoDIRECT_API) -
attribution_landing_url -
attribution_referrer
Fila de ejemplo en exportación 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
Ejemplos de construcción de URL para campañas de marketing
Al distribuir sus enlaces públicos, añada los parámetros UTM con sintaxis estándar de cadena de consulta URL:
1. Código QR en mesa de tienda:
https://app.passinstance.com/f/coffee-club?utm_source=in_store&utm_medium=qr_code&utm_campaign=table_tents&tag=table_12
2. Anuncio en historia de Instagram:
https://app.passinstance.com/f/coffee-club?utm_source=instagram&utm_medium=story_ad&utm_campaign=summer_promo_2026&utm_content=video_b
3. Pie de boletín por correo electrónico:
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11
Documentación relacionada
-
Distribución en autoservicio — PassFlows, enlaces inteligentes y distribución mediante NFC.
-
Venta de pases — Monetización de pases mediante el proceso de pago de PassFlow.
-
Exportaciones de datos e informes — Exportación de cohortes de pases y telemetría a CSV.
