Skip to content
Guia da Central de AjudaFase de integração 1
4 min de leituraVerificado 2026-11-16

Painel analítico

Alterne entre Visão Geral e Analítica, filtre períodos, compare Apple vs. Google e veja recomendações Pass Health.

Neste guia

Inspecione capturas de ecrã exatas do painel e detalhes ampliados relacionados com este guia.

Foco ampliado da interface1 / 2
Elementos-chave da interface

Painel Principal — KPIs ao vivo e Tendências (Ampliado)

Com o fluxo no ar, monitore Active in Wallets, Removed, Not Installed além das curvas de criação e registro.

Visão Geral

O Painel de Analítica (/analytics, /analytics/passes, /analytics/downloads, /templates/:id/analytics ao nível do modelo e vistas personalizadas em /dashboards) fornece telemetria operacional em tempo real e agregação histórica de séries temporais em todo o seu espaço de trabalho, sem necessitar de pipelines externos de business intelligence. Alimentada por Dashboard Analytics API (/api/v1/dashboards/*) e Analytics API (/api/v1/analytics/*), a consola apresenta métricas multidimensionais que abrangem emissão de passes, registos de dispositivos ativos, divisões de instalação por plataforma e diagnósticos proativos de Saúde dos Passes.

Os operadores podem alternar entre o modo de alto nível Visão Geral — otimizado para KPIs executivos, alertas de saúde e estado operacional imediato — e o modo aprofundado Analítica para análises detalhadas de coortes em modelos específicos, canais de distribuição e intervalos temporais.

Arquitetura de Agregação de Telemetria

O Passinstance separa os contadores operacionais em tempo real das consolidações históricas de séries temporais para garantir uma apresentação no painel em menos de um segundo, mesmo em espaços de trabalho com centenas de milhares de passes ativos:

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
PIPELINE DE TELEMETRIA E ANALÍTICA DO PAINEL
ETAPA 01 FONTES DE INGESTÃO E DE EVENTOS
Apple Web Service
/v1/devices/...
Google Wallet JWT
Callback Guardar/Rem.
Eventos em Tempo Real
de Leitor e PassFlow
ETAPA 02 MOTOR DE ANALÍTICA E PAINEL (API)
Analytics API (/api/v1/analytics)
AnalyticsScope: customer | owner | template | passFlow
AnalyticsRange: last_7days | last_30days | last_12_months | custom
AnalyticsBucket: day | week | month (Consolidações por Fuso Horário)
Dashboard Analytics API (/api/v1/dashboards)
/analytics & /analytics/range (KPIs Executivos e Comp. de Períodos)
/metrics/realtime (Passes Ativos em Direto, Débito da Fila e Leituras)
/performance & /insights (Diagnósticos de Saúde e Ações Recomendadas)
ETAPA 03 INTERFACE DO PAINEL PASSINSTANCE
Cartões de Resumo KPI e
Quota Apple vs. Google
Gráficos de Tendência
Multissérie (D/S/M)
Saúde dos Passes e
Alertas de Gargalo

Importante: Todos os intervalos de séries temporais (day, week, month) são alinhados e avaliados de acordo com o fuso horário regional configurado no seu espaço de trabalho (GET /api/v1/customer/:customerId/regional-settings), garantindo que os limites diários correspondem ao horário de funcionamento local das suas lojas.

Modos de Visão Geral do Espaço de Trabalho vs. Analítica Aprofundada

Vista do PainelEndpoints da API de SuporteTelemetria Principal e Capacidades
Visão Geral do Espaço de Trabalho (/analytics)GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insightsContador de passes ativos em tempo real, variações de crescimento a 30 dias, velocidade de leitura em direto, avisos de expiração de certificados e recomendações acionáveis de Saúde dos Passes.
Analítica Aprofundada (/analytics/passes e /analytics/downloads)GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/rangeGráficos multissérie de criação de passes vs. instalação na carteira, variações líquidas por plataforma (walletAppsChanges), comparações de intervalos de datas personalizados e filtragem por entidade com âmbito definido.
Desempenho do SistemaGET /api/v1/dashboards/performanceLatência de envio de notificações push, taxas de sucesso de sincronização APNs/Google Wallet e tempos de resposta de verificação do leitor.

Enumerações de Filtragem: AnalyticsScope, AnalyticsRange e AnalyticsBucket

Ao consultar GET /api/v1/analytics ou GET /api/v1/analytics/overview (request payload), pode segmentar a telemetria do espaço de trabalho através de três enumerações ortogonais:

  1. 1
    AnalyticsScope (scope):

- customer: Agrega todos os modelos, fluxos de passes e configurações de leitura dentro do espaço de trabalho autenticado (derivado automaticamente da sua sessão/chave de API). - owner: Agrega métricas entre múltiplos espaços de trabalho para proprietários de organizações que gerem vários ambientes associados. - template: Isola métricas de emissão, registo e remoção para um único UUID templateId. - passFlow: Isola visitas públicas de registo, submissões de formulários e taxas de conversão para um UUID passFlowId específico.

  1. 2
    AnalyticsRange (range):

- Janelas predefinidas: last_7days, last_30days, last_12_months. - Intervalos personalizados: custom combinado com parâmetros de consulta ISO YYYY-MM-DD from e to (from=2026-10-15&to=2026-11-16).

  1. 3
    AnalyticsBucket (bucket):

- day: Pontos de dados diários (predefinição para janelas de 7 e 30 dias). - week: Consolidações por semana ISO para análise de tendências ao longo de vários meses. - month: Consolidações por mês civil (predefinição para last_12_months).

Referência da API de Telemetria Programática

Obter Analítica Multissérie do Espaço de Trabalho

Obtenha curvas de séries temporais para eventos do ciclo de vida dos passes, registos de dispositivos e distribuição pelos ecossistemas de carteira:

HTTP
GET /api/v1/analytics?range=last_30days&bucket=day&scope=template&templateId=b4f29c10-83e1-4a7b-9d12-56e8012a9c04 HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Payload de Resposta (200 OK)

JSON
{
  "range": {
    "preset": "last_30days",
    "startDate": "2026-10-17T00:00:00.000Z",
    "endDate": "2026-11-15T23:59:59.999Z",
    "bucket": "day",
    "timezone": "Europe/Berlin"
  },
  "scope": {
    "type": "template",
    "targetId": "b4f29c10-83e1-4a7b-9d12-56e8012a9c04"
  },
  "summary": {
    "totalPasses": 4820,
    "activePasses": 3915,
    "inactivePasses": 245,
    "unclaimedPasses": 660,
    "installedDevices": 4380
  },
  "series": {
    "passes": [
      { "bucketStart": "2026-11-14", "created": 145, "active": 3810, "deactivated": 8 },
      { "bucketStart": "2026-11-15", "created": 162, "active": 3915, "deactivated": 5 }
    ],
    "registrations": [
      { "bucketStart": "2026-11-14", "active": 4260, "deactivated": 11 },
      { "bucketStart": "2026-11-15", "active": 4380, "deactivated": 6 }
    ],
    "walletAppsChanges": [
      { "bucketStart": "2026-11-14", "appleNetChange": 84, "googleNetChange": 32 },
      { "bucketStart": "2026-11-15", "appleNetChange": 91, "googleNetChange": 29 }
    ]
  },
  "walletAppsShare": {
    "apple": 2980,
    "google": 1400,
    "total": 4380,
    "applePercentage": 68.04,
    "googlePercentage": 31.96
  }
}

Consultar Métricas em Tempo Real e Diagnósticos de Saúde dos Passes

Para consultar os estados dos contadores em direto e as recomendações de diagnóstico através de Dashboard Analytics API:

HTTP
GET /api/v1/dashboards/insights HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "generatedAt": "2026-11-15T23:30:00.000Z",
  "healthScore": 94,
  "insights": [
    {
      "code": "HIGH_UNCLAIMED_RATIO",
      "severity": "warning",
      "templateId": "b4f29c10-83e1-4a7b-9d12-56e8012a9c04",
      "message": "13.7% of issued passes remain unclaimed after 72 hours.",
      "recommendedAction": "Enable automated 48-hour reminder sendouts in Delivery Center."
    }
  ]
}

Documentação Relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.