Referência de Eventos Integrados
Guia completo sobre eventos mapeados automaticamente no SDK da Singular e integrações S2S, abrangendo tipos de eventos, gatilhos de rastreamento e locais de relatórios.
Rastreamento Automático de Eventos: Ao integrar o SDK da Singular ou o S2S ao seu aplicativo, determinados eventos são mapeados e rastreados automaticamente na plataforma Singular sem configuração adicional.
Esses eventos integrados aparecem automaticamente em relatórios de nível de usuário, postbacks de parceiros e análises agregadas, fornecendo métricas fundamentais para medição de campanhas e análise de comportamento do usuário.
Rastreamento Automático de Eventos
Benefícios da Inicialização do SDK
Após a inicialização do SDK da Singular ou a configuração da integração S2S, o Singular reporta automaticamente os eventos principais sem exigir implementação adicional.
Métricas Rastreadas Automaticamente:
- Instalações: Primeira sessão de dispositivos únicos rastreada automaticamente
- Sessões: Todos os lançamentos do aplicativo e sessões de usuário monitorados
- DAU: Usuários ativos diários calculados a partir dos dados de sessão
- Retenção: Taxas de retorno de usuários medidas entre coortes
Configuração de Evento de Receita: Embora os eventos de instalação e sessão sejam automáticos, os eventos de receita exigem configuração no aplicativo usando os métodos de receita do SDK ou parâmetros de receita do S2S. Uma vez configurado, o rastreamento de receita é automático para todas as compras subsequentes.
Locais de Relatórios de Eventos
Onde os Eventos Integrados Aparecem
Os eventos integrados aparecem automaticamente em vários locais de relatórios e exportação de dados na plataforma Singular.
| Local | Descrição |
|---|---|
| Logs de Atribuição de Nível de Usuário |
Exporte dados detalhados de nível de usuário, incluindo todos os eventos integrados com timestamps e informações de atribuição. |
| Postbacks de Parceiros |
Envie eventos integrados para plataformas de parceiros para otimização de campanhas se o parceiro estiver configurado para receber nomes de eventos gerados automaticamente. Configure em Configuração de Parceiro → Postbacks de Eventos |
| Postbacks Internos de BI |
Encaminhe eventos integrados para sistemas internos de business intelligence para análises e relatórios personalizados. |
| Modelos de Conversão SKAN |
Inclua eventos integrados no mapeamento de valor de conversão SKAdNetwork para otimização de campanhas iOS. Configure no Construtor de Modelo de Conversão SKAN |
Eventos Mapeados Automaticamente Suportados
Referência completa dos eventos integrados rastreados automaticamente pelo SDK da Singular e integrações S2S, com gatilhos de rastreamento e detalhes de disponibilidade.
Referência de Eventos de Nível de Usuário
Tipos de Eventos Integrados
__START__
- Evento de Instalação
Descrição do Evento
Representa a instalação do aplicativo e a primeira sessão para um dispositivo único, servindo como evento principal de atribuição de instalação.
Gatilho de Rastreamento
Rastreado automaticamente quando a primeira sessão é enviada por meio de integração SDK/S2S para um identificador de dispositivo único.
Limitação Importante:
O evento
__START__
é visível
APENAS em Postbacks de BI. Este evento não aparece em
relatórios padrão
nem em postbacks de parceiros.
Detalhes Técnicos
| Nome do Evento |
__START__
|
| Tipo de Evento | Instalação/Primeira Sessão |
| Método de Rastreamento | Automático (inicialização do SDK/S2S) |
| Configuração Necessária | Nenhuma - rastreado automaticamente |
| Disponibilidade | Somente Postbacks de BI |
__SESSION__
- Evento de Sessão
Descrição do Evento
Rastreia todos os lançamentos do aplicativo e sessões de usuário, fornecendo a base para métricas de engajamento e retenção.
Gatilho de Rastreamento
Rastreado automaticamente quando as sessões são enviadas por meio de integração SDK/S2S. Inclui a primeira sessão (instalação) e todos os lançamentos subsequentes do aplicativo.
Definição de Sessão
A sessão começa quando o aplicativo é trazido para o primeiro plano e termina após um período de tempo limite configurável (padrão: 60 segundos) quando o aplicativo vai para o segundo plano.
Detalhes Técnicos
| Nome do Evento |
__SESSION__
|
| Tipo de Evento | Sessão/Lançamento do Aplicativo |
| Método de Rastreamento | Automático (gerenciamento de sessão do SDK) |
| Configuração Necessária | Nenhuma - rastreado automaticamente |
| Disponibilidade | Todos os locais de relatórios |
Uso em Análises
Os eventos de sessão alimentam várias métricas derivadas:
- Usuários Ativos Diários (DAU): Usuários únicos com sessões em um determinado dia
- Taxa de Retenção: Porcentagem de usuários que retornam para sessões subsequentes
- Frequência de Sessão: Média de sessões por usuário ao longo de um período
- Atribuição de Reengajamento: Sessões provenientes de campanhas de reengajamento
__iap__
- Evento de Receita do SDK
Descrição do Evento
Rastreia compras no aplicativo e eventos de receita reportados por meio dos métodos de receita do SDK sem nomes de eventos personalizados.
Gatilho de Rastreamento
Rastreado quando a integração SDK/S2S reporta um evento de receita por meio do método de receita , desde que o evento de receita não possua um nome personalizado na configuração do SDK.
Nomes Personalizados de Eventos de Receita:
Se o evento
de receita for configurado
com um nome personalizado (por exemplo, "purchase" ou
"subscription"),
ele aparece com esse nome personalizado em vez de
__iap__
. Ambas as
abordagens rastreiam
a receita corretamente;
__iap__
é o padrão quando
nenhum nome personalizado
é especificado.
Detalhes Técnicos
| Nome do Evento |
__iap__
|
| Tipo de Evento | Receita/Compra no Aplicativo |
| Método de Rastreamento | Método de receita do SDK ou parâmetros de receita S2S |
| Configuração Necessária | Implementação de rastreamento de receita no código do aplicativo |
| Disponibilidade | Todos os locais de relatórios |
Exemplos de Implementação
SDK do iOS:
// Track revenue without custom event name (appears as __iap__)
Singular.revenue(withAmount: 9.99, currency: "USD")
SDK do Android:
// Track revenue without custom event name (appears as __iap__)
Singular.revenue("USD", 9.99);
Receita S2S:
amt=9.99&cur=USD&is_revenue_event=true
__REVENUE__
- Qualquer Evento de Receita
Descrição do Evento
Evento de receita agregado acionado automaticamente sempre que qualquer tipo de receita é reportada, independentemente da fonte de receita ou do nome do evento.
Gatilho de Rastreamento
Rastreado automaticamente se qualquer receita for reportada por qualquer método:
-
__iap__evento acionado (evento de receita padrão) - SDK reporta evento de receita de monetização de anúncios
- S2S reporta receita com nome de evento personalizado (por exemplo, "purchase")
- Outros eventos de receita como "refund" ou "offline_purchase" reportados
Aviso de Configuração de Postback
Risco de Receita Duplicada:
Não envie
postbacks para
__REVENUE__
se já estiver enviando postbacks
para
__iap__
ou outros eventos de receita. Isso causa
reportagem de receita duplicada, pois
__REVENUE__
é acionado para cada evento de receita.
Abordagem Recomendada:
Envie postbacks
para eventos de receita específicos (
__iap__
, eventos de receita personalizados)
OU
__REVENUE__
,
mas não ambos.
Detalhes Técnicos
| Nome do Evento |
__REVENUE__
|
| Tipo de Evento | Receita Agregada (todas as fontes) |
| Método de Rastreamento | Automático (acionado por qualquer evento de receita) |
| Configuração Necessária | Nenhuma - automático quando há eventos de receita |
| Disponibilidade | Todos os locais de relatórios |
Casos de Uso
Quando Usar
__REVENUE__
:
- Postback único para todos os tipos de receita para plataformas de parceiros
- Relatório de receita agregada sem detalhamento por evento
- Configuração simplificada de parceiros com um único evento de receita
Quando Usar Eventos de Receita Específicos:
- Rastreamento separado para IAP, assinaturas e receita de anúncios
- Otimização específica por evento em plataformas de parceiros
- Atribuição de receita detalhada por tipo de evento
__UNINSTALL__
- Evento de Desinstalação
Descrição do Evento
Rastreia desinstalações do aplicativo, permitindo análise de churn e segmentação para campanhas de reengajamento.
Gatilho de Rastreamento
Rastreado automaticamente se o rastreamento de desinstalação estiver ativado para um aplicativo iOS ou Android, e pelo menos uma desinstalação for detectada. Uma vez detectada a desinstalação para um dispositivo, o evento é acionado uma vez por dia até a reinstalação ou o limite de retenção de dados.
Pré-requisitos
O rastreamento de desinstalação deve ser habilitado explicitamente na
plataforma Singular antes que os eventos
__UNINSTALL__
apareçam.
Configuração por Plataforma:
- Introdução ao Rastreamento de Desinstalação no iOS
- Introdução ao Rastreamento de Desinstalação no Android
Detalhes Técnicos
| Nome do Evento |
__UNINSTALL__
|
| Tipo de Evento | Desinstalação/Churn |
| Método de Rastreamento | Automático (requer habilitação do rastreamento de desinstalação) |
| Configuração Necessária | Habilitar rastreamento de desinstalação na plataforma Singular |
| Frequência | Uma vez por dia por dispositivo desinstalado |
| Disponibilidade | Todos os locais de relatórios (após habilitação) |
Métodos de Detecção de Desinstalação
iOS: Verificação via notificação push silenciosa
Android: Verificação via FCM (Firebase Cloud Messaging)
Tempo de Detecção: A detecção de desinstalação não é em tempo real. Geralmente detectada dentro de 24 a 48 horas após a desinstalação real, dependendo da entrega de notificações da plataforma.
__REINSTALL__
- Evento de Reinstalação
Descrição do Evento
Rastreia a reinstalação do aplicativo após uma desinstalação anterior, permitindo a medição de campanhas de recuperação e análise do ciclo de vida do usuário.
Gatilho de Rastreamento
Rastreado automaticamente
se o rastreamento de
desinstalação estiver habilitado via
SDK/S2S. Quando
__UNINSTALL__
for rastreado para um dispositivo,
a próxima
__SESSION__
acionada dispara automaticamente o evento
__REINSTALL__
.
Sequência de Acionamento
-
Instalação Inicial:
Usuário instala o aplicativo;
__START__e__SESSION__são rastreados -
Uso do Aplicativo:
Usuário interage com o aplicativo; múltiplos eventos
__SESSION__são rastreados -
Desinstalação:
Usuário desinstala o aplicativo;
__UNINSTALL__é detectado e rastreado - Reinstalação: Usuário reinstala o aplicativo e o lança
-
Detecção de Reinstalação:
Primeiro
__SESSION__após__UNINSTALL__aciona o evento__REINSTALL__
Detalhes Técnicos
| Nome do Evento |
__REINSTALL__
|
| Tipo de Evento | Reinstalação/Recuperação de Usuário |
| Método de Rastreamento | Automático (requer rastreamento de desinstalação) |
| Configuração Necessária | Habilitar rastreamento de desinstalação na plataforma Singular |
| Pré-requisitos |
Evento
__UNINSTALL__
anterior para o dispositivo
|
| Disponibilidade | Todos os locais de relatórios |
Considerações sobre Atribuição
As reinstalações podem ser atribuídas a campanhas de reengajamento se o usuário tiver clicado em um link de campanha antes de reinstalar. As configurações de janela de atribuição se aplicam à atribuição de reinstalação da mesma forma que à atribuição de instalação inicial.
Medição de Campanhas de Recuperação:
Use os eventos
__REINSTALL__
para medir a eficácia de campanhas de recuperação
direcionadas a
usuários inativos. Compare taxas de reinstalação e engajamento
subsequente entre
fontes de campanhas.
Relatórios de Eventos Agregados
O Singular gera automaticamente eventos e métricas de nível agregado com base em eventos integrados, fornecendo medição de desempenho de campanhas e análises de comportamento do usuário.
Métricas Derivadas
Eventos Baseados em Sessão
Métricas agregadas calculadas automaticamente a partir de eventos de sessão, que aparecem em relatórios e painéis de análise.
Nota Importante: Esses eventos agregados não são visíveis na seção Eventos, mas aparecem em toda a interface de relatórios como métricas padrão.
Definição da Métrica
Rastreia a primeira sessão de dispositivos únicos, representando novas instalações do aplicativo e a métrica de atribuição principal.
Método de Cálculo
Contagem de identificadores de dispositivos únicos com o primeiro evento
__SESSION__
no período de relatório.
Uso em Relatórios
- Medição de desempenho de campanhas
- Atribuição de instalação por fonte e canal
- Cálculo de custo por instalação (CPI)
- Análise do funil de instalação
Definição da Métrica
Rastreia sessões acionadas por campanhas de reengajamento, medindo a eficácia de campanhas direcionadas a usuários existentes.
Dependência de Configuração
O rastreamento de reengajamento depende das configurações de Configuração de Parceiro que definem janelas de atribuição de reengajamento e parâmetros de campanha.
Método de Cálculo
Sessões atribuídas a campanhas de reengajamento dentro da janela de atribuição configurada, independentemente de ser a primeira ou uma sessão subsequente do usuário.
Uso em Relatórios
- Medição de ROI de campanhas de reengajamento
- Taxas de ativação de usuários inativos
- Desempenho de reengajamento entre canais
- Transições de estágio no ciclo de vida do usuário
Definição da Métrica
Contagem diária de usuários únicos com pelo menos uma sessão no dia especificado, medindo o tamanho da base de usuários ativos.
Método de Cálculo
Contagem de identificadores de dispositivos únicos com pelo menos um evento
__SESSION__
em um dia de calendário específico.
Métricas Relacionadas
- WAU: Usuários Ativos Semanais (contagem de usuários únicos em 7 dias)
- MAU: Usuários Ativos Mensais (contagem de usuários únicos em 30 dias)
- Razão DAU/MAU: Indicador de stickiness (DAU dividido por MAU)
Uso em Relatórios
- Análise de tendências de engajamento do aplicativo
- Medição do crescimento da base de usuários
- Identificação de padrões de uso sazonais
- Monitoramento da saúde da plataforma
Definição da Métrica
Porcentagem de usuários que instalaram o aplicativo (primeira sessão) e retornaram para sessões adicionais dentro de um período de tempo especificado.
Método de Cálculo
(Usuários com sessões no Dia N após a instalação / Total de usuários instalados no Dia 0) × 100
Tipos de Retenção
| Tipo de Retenção | Descrição |
|---|---|
| Retenção do Dia 1 | Porcentagem de usuários que retornam no dia seguinte à instalação |
| Retenção do Dia 7 | Porcentagem de usuários que retornam 7 dias após a instalação |
| Retenção do Dia 30 | Porcentagem de usuários que retornam 30 dias após a instalação |
| Retenção Contínua | Usuário retornou no Dia N ou depois (cumulativo) |
Uso em Relatórios
- Avaliação de product-market fit
- Medição da eficácia do onboarding
- Comparação de qualidade de campanhas (fontes com alta vs. baixa retenção)
- Previsão e prevenção de churn
Eventos Baseados em Receita
Métricas de Receita Agregada
Métricas de receita calculadas automaticamente que aparecem em relatórios e painéis de análise para medição de ROI de campanhas.
Definição da Métrica
Rastreia IAP (compras no aplicativo), eventos de receita personalizados e receita de assinaturas, excluindo monetização de anúncios.
Fontes de Receita Incluídas
-
__iap__eventos (evento de receita padrão) - Eventos de receita personalizados (purchase, subscription, etc.)
- Renovações e upgrades de assinatura
- Compras únicas e consumíveis
Fontes de Receita Excluídas
- Receita de monetização de anúncios (rastreada separadamente em Receita de Anúncios)
Uso em Relatórios
- Cálculo de ROI e ROAS de campanhas
- Medição do valor do tempo de vida do usuário (LTV)
- Análise do funil de monetização
- Atribuição de receita por fonte
Definição da Métrica
Rastreia APENAS a receita gerada por eventos de monetização de anúncios, separando a renda de publicidade da receita de compras.
Fontes de Receita Incluídas
- Impressões de anúncios em banner
- Visualizações de anúncios intersticiais
- Conclusões de vídeo recompensado
- Engajamentos com anúncios nativos
- Conclusões de offerwall
Requisito de Implementação
Requer integração de SDK de monetização de anúncios ou reporte de receita de anúncios via S2S com a designação de tipo de evento adequada.
Uso em Relatórios
- Otimização de estratégia de monetização de anúncios
- Análise de modelo de monetização híbrida
- Lucratividade por segmento de usuário (IAP vs. receita de anúncios)
- Desempenho de fill rate e eCPM
Definição da Métrica
Rastreia todos os eventos de receita de todas as fontes, fornecendo um panorama completo de monetização incluindo IAP, assinaturas e receita de anúncios.
Método de Cálculo
Receita Total = Receita + Receita de Anúncios
Fontes de Receita Incluídas
- Toda receita de IAP e compras
- Receita de assinaturas
- Receita de monetização de anúncios
- Eventos de receita personalizados (reembolsos, compras offline, etc.)
Uso em Relatórios
- Medição completa de ROI de campanhas
- Cálculo de LTV combinado entre tipos de monetização
- Rastreamento geral do desempenho do negócio
- Comparação de lucratividade entre canais
Segmentação de Receita: Use Receita, Receita de Anúncios e Receita Total em conjunto para entender o mix de monetização e otimizar a estratégia para diferentes segmentos de usuários.
Recursos Adicionais
Documentação completa sobre rastreamento de eventos, configuração e relatórios na plataforma Singular.
Documentação de Eventos
- FAQ sobre Eventos - Referência completa de eventos e perguntas frequentes
- Como Rastrear Eventos no Aplicativo - Guia passo a passo para implementação de eventos
- Eventos Padrão da Singular - Lista completa de eventos padrão e eventos recomendados por vertical
- FAQ sobre Exportação de Logs e Dados de Nível de Usuário - Acesso a dados de eventos de nível de usuário
- Postbacks Internos de BI - Encaminhamento de eventos para sistemas internos