Skip to content
Guía del Centro de ayudaFase de incorporación 6
4 min de lecturaVerificado 2026-11-16

Analítica de distribución y participación

Mide entregas de canal, rebotes SES, conversión de descarga y ejecuciones de avisos push.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado1 / 2
Elementos clave de la interfaz

Analíticas de plantilla — Ciclo de vida y alcance (Ampliado)

Supervisa pases activos, sin reclamar, registros de dispositivos y evolución temporal de su alcanzabilidad.

Descripción General

Emitir un registro de pase es solo el primer paso en el recorrido del cliente. Analíticas de Distribución e Interacción (/analytics/downloads en el Panel) realiza un seguimiento del embudo de conversión completo desde la invitación inicial (campaña de correo electrónico, SMS, escaneo de QR o formulario público de admisión de PassFlow), pasando por el enrutamiento del enlace de descarga inteligente (/d/:slug, /s/:token), hasta la instalación confirmada en la billetera nativa y la interacción posterior con las actualizaciones push.

Embudo de Distribución y Conversión de Extremo a Extremo

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
EMBUDO DE CONVERSIÓN DE DISTRIBUCIÓN E INTERACCIÓN
ETAPA 01 ETAPA 1: CANALES SALIENTES Y ENTRANTES
Envío Campaña Correo
track/:recipientId/..
Admisión Púb. PassFlow
visits y pageViews
Enlace Descarga Int.
GET/d/:slug
ETAPA 02 ETAPA 2: CAPA DE INTERACCIÓN EN SUPERFICIE PÚBLICA
uniqueVisitors y visits (Sesión Propia y Agrupación Segura de Privacidad)
DownloadEventType: PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Toque en "Añadir a Apple Wallet" o "Guardar en Google")
ETAPA 03 ETAPA 3: INSTALACIÓN EN BILLETERA E INTERACCIÓN PUSH
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Desglose Apple iOS/watchOS frente a Android Google Wallet)
GET/api/v1/analytics/passes/updates (Volumen de Actualizaciones Push)

Importante: Las métricas de visitantes y sesiones (uniqueVisitors y visits) utilizan identificadores de sesión propios respetuosos con la privacidad con agrupación de respaldo anonimizada, lo que garantiza el pleno cumplimiento del RGPD sin depender de cookies de seguimiento entre sitios de terceros.

Telemetría de la Página de Descarga (DownloadEventType) y Métricas del Embudo

Cada interacción en una Página Pública de Descarga (/d/:slug, /download/:slug, /s/:token) se clasifica mediante la enumeración DownloadEventType de Passinstance database (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK), integrándose en PASS_ANALYTICS_METRIC_DEFINITIONS junto con las métricas del embudo de PassFlow:

Clave de MétricaAlcance de SuperficieDefinición Técnica
uniqueVisitorsPágina de Descarga y PassFlowNavegadores o dispositivos distintos que llegan a la superficie pública durante el período del informe.
visitsPágina de Descarga y PassFlowSesiones de visitantes distintas que llegan a la superficie pública seleccionada.
pageViewsSuperficies PúblicasEventos de visualización de página HTML renderizada (PAGE_VIEW; menor que visits cuando la transmisión MIME directa de .pkpass omite PassFlow en iOS Safari).
interactionsPágina de Descarga y PassFlowAcciones de usuario rastreadas, incluidos inicios de guardado (BUTTON_CLICK), escaneos de códigos QR (QR_SCAN), acciones de compartir (SHARE_CLICK), verificaciones OTP y envíos de formularios.
saveInitiationsSolo Página de DescargaClics rastreados en los botones Añadir a Apple Wallet o Guardar en Google Wallet (DOWNLOAD_STARTED).
saveCompletionsSolo Página de DescargaGuardados en billetera o descargas de pases completados y confirmados desde una página pública de descarga (DOWNLOAD_COMPLETED).
submissionsSolo PassFlowIntentos de envío de formularios por parte de clientes en una página pública de inscripción de PassFlow.
conversionsSolo PassFlowGeneraciones de pases exitosas completadas a partir de un envío de PassFlow.
conversionRatePágina de Descarga y PassFlowProporción de finalizaciones rastreadas (saveCompletions o conversions) dividida por visits.

Seguimiento de Campañas de Correo Electrónico y Salud de Entregabilidad

Al distribuir pases a través del Centro de Entrega, Passinstance realiza un seguimiento de la interacción a nivel de destinatario y de los bucles de retroalimentación de managed email delivery:

  1. 1
    Seguimiento de Aperturas y Clics: Los correos electrónicos de campañas salientes incorporan telemetría de píxeles y redirección sin prefijo (GET /email-campaigns/track/:recipientId/open y GET /email-campaigns/track/:recipientId/click) para atribuir las instalaciones posteriores en billetera a lotes de envío específicos.
  2. 2
    Supresión de Rebotes y Quejas: Los webhooks de rebotes duros, rebotes suaves y quejas por spam (POST /api/v1/email-campaigns/webhooks/ses y POST /api/v1/webhooks/ses) de managed email delivery se registran en las analíticas de campaña y se añaden automáticamente a la lista de supresión del espacio de trabajo para proteger la reputación de su dominio de remitente personalizado (SPF/DKIM).
  3. 3
    Cumplimiento de Baja con Un Solo Clic: Las comunicaciones de marketing incorporan encabezados RFC 8058 con token (POST /email/unsubscribe/:token y redirección segura GET /email/unsubscribe/:token) junto con portales de preferencias de autoservicio (/email/preferences/:token).

Volumen de Actualizaciones Push y Cuota de Plataforma (walletAppsShare)

Una vez instalados los pases, la interacción continua se mide según la eficacia con la que las actualizaciones push llegan a las pantallas de bloqueo de los clientes y cómo se divide su audiencia entre los ecosistemas móviles.

Consulta del Volumen de Entrega de Actualizaciones Push

Utilice GET /api/v1/analytics/passes/updates para auditar el volumen de actualizaciones de pases en segundo plano enviadas a través del servicio de notificaciones push de Apple (APNs HTTP/2) y la API REST de Google Wallet:

HTTP
GET /api/v1/analytics/passes/updates?range=last_30days&bucket=day HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Carga Útil de Respuesta (200 OK)

JSON
{
  "range": "last_30days",
  "bucket": "day",
  "totals": {
    "dispatchedUpdates": 18420,
    "appleApnsDelivered": 12650,
    "googleWalletPatched": 5690,
    "failedOrUnregistered": 80
  },
  "series": [
    {
      "bucketStart": "2026-11-14",
      "appleApnsDelivered": 410,
      "googleWalletPatched": 195,
      "failedOrUnregistered": 3
    },
    {
      "bucketStart": "2026-11-15",
      "appleApnsDelivered": 520,
      "googleWalletPatched": 230,
      "failedOrUnregistered": 2
    }
  ]
}

Consulta del Rendimiento del Embudo de PassFlow

HTTP
GET /api/v1/analytics/overview?scope=passFlow&passFlowId=9a1c4e22-7b11-4d90-8c34-12f908a7e311&range=last_30days HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "scope": "passFlow",
  "passFlowId": "9a1c4e22-7b11-4d90-8c34-12f908a7e311",
  "metrics": {
    "uniqueVisitors": 3420,
    "visits": 3890,
    "pageViews": 4120,
    "interactions": 3150,
    "submissions": 2840,
    "conversions": 2795,
    "conversionRate": 71.85,
    "saveCompletions": 2410
  },
  "walletAppsShare": {
    "apple": 1690,
    "google": 720,
    "total": 2410
  }
}

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.