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
Importante: Las métricas de visitantes y sesiones (
uniqueVisitorsyvisits) 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étrica | Alcance de Superficie | Definición Técnica |
|---|---|---|
uniqueVisitors | Página de Descarga y PassFlow | Navegadores o dispositivos distintos que llegan a la superficie pública durante el período del informe. |
visits | Página de Descarga y PassFlow | Sesiones de visitantes distintas que llegan a la superficie pública seleccionada. |
pageViews | Superficies Públicas | Eventos 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). |
interactions | Página de Descarga y PassFlow | Acciones 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. |
saveInitiations | Solo Página de Descarga | Clics rastreados en los botones Añadir a Apple Wallet o Guardar en Google Wallet (DOWNLOAD_STARTED). |
saveCompletions | Solo Página de Descarga | Guardados en billetera o descargas de pases completados y confirmados desde una página pública de descarga (DOWNLOAD_COMPLETED). |
submissions | Solo PassFlow | Intentos de envío de formularios por parte de clientes en una página pública de inscripción de PassFlow. |
conversions | Solo PassFlow | Generaciones de pases exitosas completadas a partir de un envío de PassFlow. |
conversionRate | Página de Descarga y PassFlow | Proporció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
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/openyGET /email-campaigns/track/:recipientId/click) para atribuir las instalaciones posteriores en billetera a lotes de envío específicos. -
2
Supresión de Rebotes y Quejas: Los webhooks de rebotes duros, rebotes suaves y quejas por spam (
POST /api/v1/email-campaigns/webhooks/sesyPOST /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
Cumplimiento de Baja con Un Solo Clic: Las comunicaciones de marketing incorporan encabezados RFC 8058 con token (
POST /email/unsubscribe/:tokeny redirección seguraGET /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:
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)
{
"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
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>
{
"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
-
Configure dominios de remitente personalizados en Opciones de Marca Personalizada y Marca Blanca.
-
Revise las definiciones de estados de los pases en Métricas de Emisión y Uso de Pases.
