Skip to content
Guía del Centro de ayuda · Distribución de pases
4 min de lecturaVerificado 2026-11-16

Parámetros de seguimiento UTM

Realice un seguimiento de las campañas de marketing, fuentes de anuncios y embudos de conversión en enlaces de distribución de pases y PassFlows con atribución de primer contacto.

En esta guía

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.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CANALIZACIÓN DE ATRIBUCIÓN UTM Y TELEMETRÍA
ETAPA 01 PUNTO DE CONTACTO DE LA CAMPAÑA DE MARKETING
El cliente hace clic en un enlace o escanea un QR con etiquetas UTM: https://app.passinstance.com/f/vip-club?utm_source=instagram&utm_medium=story...
ETAPA 02 MOTOR DE INGESTA Y ATRIBUCIÓN UTM
Captura etiquetas de consulta: utm_source, utm_medium, utm_campaign, etc.
Registra la cabecera HTTP Referer y la landingUrl inicial
Aplica atribución al primer contacto (ATTRIBUTION_MODEL = 'FIRST_TOUCH')
ETAPA 03 PERSISTENCIA DE ATRIBUCIÓN DEL PASE (BASE DE DATOS)
Guardada permanentemente en el campo JSON Pass.attribution:
utm_source: "instagram"
utm_medium: "story"
utm_campaign: "summer_promo_2026"
tag: "influencer_sarah"
capturedAt: marca temporal ISO | capturedFrom: "PASSFLOW"
ETAPA 04A EXPORTACIÓN CSV Y ANALÍTICA
Incluida en POST/passes/export
Filtre cohortes por campaña marketing
ETAPA 04B WEBHOOKS DE INTEGRACIÓN
Reenviada en pass.created
Sincronización CRM / GA4

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ámetroPropósitoValor de ejemploIdeal para
utm_sourceIdentifica la plataforma de tráfico o el origen de referenciafacebook, instagram, newsletter, counter_qrDeterminar qué plataforma generó la visita
utm_mediumCanal de marketing o medio de distribucióncpc, social, email, print_flyer, smsDistinguir anuncios de pago de tráfico orgánico o material impreso
utm_campaignNombre concreto de la campaña promocionalspring_launch_2026, black_friday_vip, store_openingAgrupar pases emitidos dentro de una iniciativa específica
utm_termPalabra clave de búsqueda de pago o segmento de audiencialoyalty_rewards, coffee_club, fitness_subRastrear palabras clave específicas o variantes de audiencia
utm_contentCreatividad publicitaria o variante específica de llamada a la acciónblue_button, story_ad_v2, table_stand_4Pruebas A/B de anuncios o distintas ubicaciones en punto de venta
utm_idID de campaña de CRM o automatización de marketingcamp_01j8k9m2, ad_99214Correlacionar la emisión de pases con IDs de Google Ads o HubSpot
tagIdentificador libre de categorizaciónstore_munich, partner_nike, staff_alexEtiquetas 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. 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. 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. 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. 1
    Abra su plantilla en el panel de control.
  2. 2
    Vaya a Funcionalidades -> UTM y seguimiento (/templates/:templateId/utm-tracking).
  3. 3
    Active Habilitar seguimiento de parámetros UTM.
  4. 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):

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
}

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

Fila de ejemplo en exportación 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

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:

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

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. Pie de boletín por correo electrónico:

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

Documentación relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.