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

Analítica de distribuição e envolvimento

Avalie entregas de canal, rejeições SES, conversões da página de download e envios de notificações push.

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

Análises do Template — Ciclo de vida e alcance (Ampliado)

Acompanhe passes ativos, não resgatados, registros ativos de dispositivos e alcance em tempo real.

Visão Geral

Emitir um registo de passe é apenas o primeiro passo na jornada do cliente. A Analítica de Distribuição e Envolvimento (/analytics/downloads no Painel de Controlo) acompanha o funil completo de conversão desde o convite inicial (campanha de e-mail, SMS, leitura de QR ou formulário público de admissão PassFlow), passando pelo encaminhamento de ligações inteligentes de transferência (/d/:slug, /s/:token), até à instalação nativa confirmada na carteira e ao subsequente envolvimento através de atualizações push.

Funil Ponta a Ponta de Distribuição e Conversão

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
FUNIL DE CONVERSÃO DE DISTRIBUIÇÃO E ENVOLVIMENTO
ETAPA 01 ETAPA 1: CANAIS DE SAÍDA E DE ENTRADA
Envio Campanha E-mail
track/:recipientId/..
Admissão PassFlow Púb.
visits e pageViews
Ligação Inteligente
GET/d/:slug
ETAPA 02 ETAPA 2: CAMADA DE INTERAÇÃO NA SUPERFÍCIE PÚBLICA
uniqueVisitors e visits (Sessão Própria e Agrupamento Seguro de Privac.)
DownloadEventType: PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Toque em "Adicionar à Apple Wallet" ou "Google Wallet")
ETAPA 03 ETAPA 3: INSTALAÇÃO NA CARTEIRA E ENVOLVIMENTO PUSH
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Divisão Apple iOS/watchOS vs. Android Google Wallet)
GET/api/v1/analytics/passes/updates (Volume de Atualizações APNs e Google)

Importante: As métricas de visitantes e sessões (uniqueVisitors e visits) utilizam identificadores de sessão próprios que respeitam a privacidade, com agrupamento alternativo anonimizado — garantindo total conformidade com o RGPD sem depender de cookies de rastreio entre sites de terceiros.

Telemetria da Página de Transferência (DownloadEventType) e Métricas do Funil

Cada interação numa Página Pública de Transferência (/d/:slug, /download/:slug, /s/:token) é categorizada pela enumeração DownloadEventType do Passinstance database (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK), consolidando-se em PASS_ANALYTICS_METRIC_DEFINITIONS juntamente com as métricas de funil do PassFlow:

Chave de MétricaÂmbito da SuperfícieDefinição Técnica
uniqueVisitorsPágina de Transferência e PassFlowNavegadores ou dispositivos distintos que acedem à superfície pública durante o período do relatório.
visitsPágina de Transferência e PassFlowSessões distintas de visitantes que acedem à superfície pública selecionada.
pageViewsSuperfícies PúblicasEventos de visualização de página HTML apresentada (PAGE_VIEW; mais restrito do que visits quando a transmissão MIME direta de .pkpass ignora o PassFlow no iOS Safari).
interactionsPágina de Transferência e PassFlowAções de utilizador monitorizadas, incluindo inícios de gravação (BUTTON_CLICK), leituras de códigos QR (QR_SCAN), ações de partilha (SHARE_CLICK), verificações OTP e submissões de formulários.
saveInitiationsApenas Página de TransferênciaCliques monitorizados nos botões Adicionar à Apple Wallet ou Guardar na Google Wallet (DOWNLOAD_STARTED).
saveCompletionsApenas Página de TransferênciaGravações na carteira ou transferências de passes concluídas e confirmadas a partir de uma página pública de transferência (DOWNLOAD_COMPLETED).
submissionsApenas PassFlowTentativas de submissão de formulário pelo cliente numa página pública de inscrição PassFlow.
conversionsApenas PassFlowGerações de passes bem-sucedidas concluídas a partir de uma submissão PassFlow.
conversionRatePágina de Transferência e PassFlowRácio de conclusões monitorizadas (saveCompletions ou conversions) dividido por visits.

Rastreio de Campanhas de E-mail e Saúde de Entregabilidade

Ao distribuir passes através do Centro de Entrega, o Passinstance acompanha o envolvimento ao nível do destinatário e os ciclos de feedback do managed email delivery:

  1. 1
    Rastreio de Aberturas e Cliques: Os e-mails de campanhas de saída incorporam telemetria de píxeis e redirecionamentos sem prefixo (GET /email-campaigns/track/:recipientId/open e GET /email-campaigns/track/:recipientId/click) para atribuir instalações subsequentes na carteira a lotes de envio específicos.
  2. 2
    Supressão de Devoluções e Reclamações: Os webhooks de devoluções permanentes (hard bounces), devoluções temporárias (soft bounces) e reclamações de spam (POST /api/v1/email-campaigns/webhooks/ses e POST /api/v1/webhooks/ses) do managed email delivery são registados na analítica da campanha e adicionados automaticamente à lista de supressão do espaço de trabalho para proteger a reputação do seu domínio de remetente personalizado (SPF/DKIM).
  3. 3
    Conformidade de Cancelamento de Subscrição com Um Clique: As comunicações de marketing incorporam cabeçalhos RFC 8058 com tokens (POST /email/unsubscribe/:token e redirecionamento seguro GET /email/unsubscribe/:token), juntamente com portais de preferências em autoatendimento (/email/preferences/:token).

Volume de Atualizações Push e Quota de Plataformas (walletAppsShare)

Depois de os passes serem instalados, o envolvimento contínuo é medido pela eficácia com que as atualizações push chegam aos ecrãs bloqueados dos clientes e pela forma como o seu público se divide entre os ecossistemas móveis.

Consultar o Volume de Entrega de Atualizações Push

Utilize GET /api/v1/analytics/passes/updates para auditar o volume de atualizações de passes em segundo plano enviadas através do serviço Apple Push Notification (APNs HTTP/2) e da API REST da 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>

Payload de Resposta (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
    }
  ]
}

Consultar o Desempenho do Funil 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
  }
}

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.