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
Importante: As métricas de visitantes e sessões (
uniqueVisitorsevisits) 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ície | Definição Técnica |
|---|---|---|
uniqueVisitors | Página de Transferência e PassFlow | Navegadores ou dispositivos distintos que acedem à superfície pública durante o período do relatório. |
visits | Página de Transferência e PassFlow | Sessões distintas de visitantes que acedem à superfície pública selecionada. |
pageViews | Superfícies Públicas | Eventos 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). |
interactions | Página de Transferência e PassFlow | Açõ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. |
saveInitiations | Apenas Página de Transferência | Cliques monitorizados nos botões Adicionar à Apple Wallet ou Guardar na Google Wallet (DOWNLOAD_STARTED). |
saveCompletions | Apenas Página de Transferência | Gravaçõ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). |
submissions | Apenas PassFlow | Tentativas de submissão de formulário pelo cliente numa página pública de inscrição PassFlow. |
conversions | Apenas PassFlow | Gerações de passes bem-sucedidas concluídas a partir de uma submissão PassFlow. |
conversionRate | Página de Transferência e PassFlow | Rá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
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/openeGET /email-campaigns/track/:recipientId/click) para atribuir instalações subsequentes na carteira a lotes de envio específicos. -
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/sesePOST /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
Conformidade de Cancelamento de Subscrição com Um Clique: As comunicações de marketing incorporam cabeçalhos RFC 8058 com tokens (
POST /email/unsubscribe/:tokene redirecionamento seguroGET /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:
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)
{
"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
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
}
}
Documentação Relacionada
-
Configure domínios de remetente personalizados em Personalização de Marca e Opções White-Label.
-
Consulte as definições de estados de passes em Métricas de Emissão e Utilização de Passes.
