Referência de Eventos Integrados

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.

FAQ sobre Exportação de Logs e Dados de Nível de Usuário

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.

Documentação de Postbacks Internos de BI

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:


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

  1. Instalação Inicial: Usuário instala o aplicativo; __START__ e __SESSION__ são rastreados
  2. Uso do Aplicativo: Usuário interage com o aplicativo; múltiplos eventos __SESSION__ são rastreados
  3. Desinstalação: Usuário desinstala o aplicativo; __UNINSTALL__ é detectado e rastreado
  4. Reinstalação: Usuário reinstala o aplicativo e o lança
  5. 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.

Instalações

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
Reengajamento

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
Usuários Ativos Diários (DAU)

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
Retenção

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.

Receita

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
Receita de Anúncios

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
Receita Total

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


Rastreamento de Desinstalação