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

Métricas de emisión y uso

Interpreta Creados, Activos en Wallet, No instalados, Eliminados y el conteo multidispositivo de Apple.

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 ampliado
Elementos clave de la interfaz

Salud de los pases y acciones recomendadas (Zoom)

Controla la proporción de pases activos frente a no instalados en Pass health y actúa sobre las recomendaciones automáticas para dar seguimiento a pases pendientes de instalación.

Descripción General

La interpretación precisa de la telemetría de billetera requiere una distinción arquitectónica estricta entre Instancias de Pases (registros lógicos de credenciales emitidos en la base de datos e identificados por UUID id, serialNumber y un externalId de origen opcional) y Registros de Dispositivos (dispositivos móviles físicos o relojes inteligentes que almacenan activamente esas credenciales asociadas al bundleId / passTypeIdentifier de Apple de la plantilla o al ID de objeto de Google Wallet).

Passinstance aplica esta separación en metric-definitions.ts (PASS_ANALYTICS_METRIC_DEFINITIONS y WALLET_INSTALLATION_METRIC_DEFINITIONS), mostrada visualmente en el Panel en Analíticas -> Pases (/analytics/passes) y a través de /api/v1/analytics/*, para que los equipos de marketing y los administradores de facturación nunca confundan los enlaces generados con las tarjetas de billetera instaladas.

Separación Arquitectónica: Instancias de Pases frente a Registros de Dispositivos

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
TAXONOMÍA DE INSTANCIA DE PASE VS. REGISTRO DE DISPOSITIVO
ETAPA 01
1
CAPA LÓGICA DE INSTANCIA DE PASE (1 Registro de Pase = 1 serialNumber Único) [ Pase Creado ]+[ No Reclamado (unclaimedPasses) ] (0 Registros) (totalPasses)
+[ Activo (activePasses) ] (>= 1 Reg Activo) +[ Eliminado (inactivePasses) ] (Todos Regs Elim.) +[ Terminal (expiredPasses / voidedPasses) ]
ETAPA 02
Ecosistema Apple Wallet (APNs)
iPhone del Titular (Reg #1)
Apple Watch Enlazado (Reg #2)
1 Pase Activo = 2 Regs Dispos.
Ecosistema Google Wallet (REST)
PassObject Vinculado a Google ID
Sinc. Callback Guardar/Eliminar
1 Pase Activo = 1 Reg Objeto
2
CAPA FÍSICA DE REGISTRO DE DISPOSITIVOS (installedDevices en uniqueDevices)

Importante: En GET /api/v1/analytics/wallet-installations, un único pase instalado tanto en el iPhone como en el Apple Watch de un cliente cuenta como 1 activePasses en el resumen de Instancias de Pases, mientras que registra 2 installedDevices en el resumen de Registros de Dispositivos porque APNs entrega notificaciones push a cada token de dispositivo de forma independiente.

Definiciones Canónicas de Métricas (metric-definitions.ts)

Métricas de Instancias de Pases

Clave de MétricaEtiqueta en el PanelDefinición Técnica y Base de Evaluación
totalPassesTotal de Pases EmitidosTotal de registros de pases emitidos y no eliminados en el momento de la instantánea.
activePassesPases ActivosInstancias de pases en vivo que cuentan actualmente con al menos un registro de dispositivo alcanzable (excluye pases vencidos y anulados en el resumen estándar de pases).
inactivePassesPases EliminadosInstancias de pases en vivo guardadas previamente en una billetera que ya no tienen ningún registro de dispositivo alcanzable (removedPasses en los informes de instalación).
unclaimedPassesPases No ReclamadosInstancias de pases en vivo emitidas mediante API, CSV o PassFlow que nunca se han guardado en la billetera de un dispositivo (noRegistrationPasses).
expiredPassesPases VencidosInstancias de pases cuya expirationDate ha pasado o cuyo estado está marcado como EXPIRED.
voidedPassesPases AnuladosInstancias de pases revocadas o anuladas en el servidor mediante el panel, un flujo de trabajo o VOIDED_AFTER_SCAN scan mode.

Métricas de Registros de Dispositivos

Clave de MétricaEtiqueta en el PanelDefinición Técnica y Base de Evaluación
installedDevicesRegistros de Dispositivos ActivosTotal de registros de pases guardados y alcanzables en todos los dispositivos físicos (1 pase en 2 dispositivos = 2).
inactiveDeviceRegistrationsRegistros de Dispositivos EliminadosRegistros de pases guardados que fueron dados de baja por el dispositivo o invalidados por un fallo permanente de envío push en APNs.
totalDeviceRegistrationsTotal de Registros de DispositivosRegistros acumulados de pases guardados tanto en estado activo como eliminado.
uniqueDevicesDispositivos ÚnicosIdentificadores de hardware de dispositivos físicos distintos que mantienen actualmente al menos un registro de pase activo.
devicePlatformDistributionDistribución por Plataforma de DispositivoDesglose de registros de dispositivos activos por ecosistema de billetera (APPLE_WALLET frente a GOOGLE_WALLET) y familia de sistema operativo.

Matices de la Telemetría de Billetera y Casos Especiales

Además de los estados confirmados, el informe GET /api/v1/analytics/wallet-installations realiza un seguimiento de las transiciones a nivel de evento y de los estados límite:

  • installEvents (Instalaciones en Billetera): Registros de dispositivos creados durante el período del informe, contados una vez por cada par único de pase y dispositivo. Reinstalar un pase ya registrado en el mismo dispositivo no infla el recuento de instalaciones.
  • removalEvents (Eliminaciones de Billetera): Registrados cuando Apple Wallet llama a DELETE /v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber o Google Wallet envía un callback de eliminación, además de las eliminaciones inferidas cuando APNs devuelve 410 Unregistered.
  • otherStatePasses (Registros No Resueltos): Pases cuyos únicos registros están pendientes, suspendidos o en un estado indeterminado que no demuestra ni una instalación activa ni una eliminación confirmada.
  • noRegistrationPasses (Sin Instalación Confirmada): Pases con cero registros de dispositivo. En Apple Wallet, la instalación siempre activa una llamada inmediata de registro de dispositivo; en Google Wallet, la instalación depende de los callbacks de guardado.

Endpoints Principales de la API de Emisión y Registro

EndpointVerbo HTTPDescripción
/api/v1/analytics/passes/overviewGETInstantánea de totalPasses, activePasses, inactivePasses, unclaimedPasses, expiredPasses y voidedPasses.
/api/v1/analytics/passes/createdGETSerie temporal de instancias de pases recién creadas agrupadas por day, week o month.
/api/v1/analytics/registrationsGETSerie temporal de registros de dispositivos activos y desactivados durante la ventana seleccionada.
/api/v1/analytics/wallet-installationsGETMatriz integral que separa los estados de instalación a nivel de pase de los eventos de registro a nivel de dispositivo.

Ejemplo: Matriz Detallada de Instalación en Billetera

HTTP
GET /api/v1/analytics/wallet-installations?range=last_30days&templateId=b4f29c10-83e1-4a7b-9d12-56e8012a9c04 HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "snapshotAt": "2026-11-15T23:59:59.999Z",
  "passes": {
    "totalPasses": 5000,
    "activePasses": 3850,
    "removedPasses": 310,
    "otherStatePasses": 15,
    "noRegistrationPasses": 825
  },
  "registrations": {
    "installedDevices": 4290,
    "inactiveDeviceRegistrations": 365,
    "totalDeviceRegistrations": 4655,
    "uniqueDevices": 4180,
    "devicePlatformDistribution": {
      "apple": 2910,
      "google": 1380
    }
  },
  "periodEvents": {
    "passesCreated": 640,
    "installEvents": 595,
    "removalEvents": 42
  }
}

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.