Como rastrear eventos no aplicativo

 

Ao rastrear os eventos in-app corretos em seu aplicativo, você pode medir o sucesso dos esforços de marketing da sua organização por meio dos KPIs que são importantes para você.

Este guia se aplica aos novos clientes do Growth Plan. Para outros clientes, o processo é um pouco diferente, pois os eventos não são adicionados automaticamente à página Eventos (consulte a etapa 5 abaixo). Esse recurso está sendo implementado para todos os clientes.

Guia para Equipes de marketing e de aquisição de usuários
Pré-requisitos

Use a Singular como seu parceiro de atribuição (MMP).

Para rastrear eventos, você precisa:

  1. Escolher os eventos que você deseja rastrear.
  2. Pedir a seus desenvolvedores que incluam código no SDK da Singular ou integração S2S em seu aplicativo para enviar os eventos escolhidos à medida que eles ocorrem.
  3. Certificar-se de que seus eventos apareçam na página Configurações > Eventos na plataforma Singular.

events1.jpg

Siga o guia abaixo para obter instruções detalhadas.

1

Defina uma lista de eventos

Pense nos KPIs que você deseja medir e liste os eventos in-app que o ajudarão a medi-los.

Para ajudar você a começar, compilamos uma lista de eventos comumente usados por vertical, incluindo os atributos recomendados para aprovação.Recomendamos usar esses eventos padrão sempre que possível, pois eles são importados automaticamente no Singular.

Por exemplo, para aplicativos de comércio eletrônico, recomendamos a implementação de eventos como Product View, Add To Cart e Checkout.

(Opcional) Adicione eventos personalizados, se necessário

Dependendo do conteúdo do seu aplicativo e das suas necessidades de marketing, talvez você queira rastrear eventos in-app que não sejam facilmente mapeados para nenhum dos eventos padrão da Singular. Nesse caso, você pode definir seus próprios eventos personalizados.

Os eventos personalizados devem ser configurados manualmente na Singular para serem medidos nos relatórios da Singular. Dependendo da rede de publicidade, você poderá ou não usá-los para otimização.

Observação: mesmo que você defina eventos personalizados, ainda assim recomendamos o uso de atributos padrão sempre que possível para transmitir dados com o evento. Isso ajudará as redes de anúncios a informar sobre seus atributos. Os atributos padrão também serão relatados pela Singular em um futuro próximo.

2

Implementar eventos na integração do SDK

Forneça à sua equipe de desenvolvimento a lista de eventos e atributos a serem incorporados à integração do SDK da Singular.

O objetivo é que seu aplicativo informe aos servidores da Singular todos os eventos escolhidos à medida que eles acontecem, de modo que:

  1. A Singular possa agregar e analisar as informações para você.
  2. A Singular envie postbacksautomáticos para redes de anúncios sobre eventos em seu aplicativo. Consulte Perguntas frequentes sobre postbacks.
Quais eventos são incorporados e sempre implementados?

Quando você integra um SDK ou S2S da Singular em seu aplicativo, a Singular rastreia automaticamente vários tipos de eventos no aplicativo, sem que você precise adicionar código para enviá-los à Singular quando ocorrerem.

Esses eventos integrados podem aparecer em:

Eventos incorporados com suporte

Nome do evento Descriçãodo evento Quando é rastreado
__START__ Instalação Automaticamente rastreado quando a primeirasessão é enviada por meio de uma integração SDK/S2S.
__SESSION__ Sessão Automaticamente rastreado quando as sessões são enviadas por meio de uma integração SDK/S2S.
__iap__ Receita do SDK Rastreado se uma integração SDK/S2S estiver relatando um evento de receita por meio do método de receita.
__REVENUE__ Qualquer receita

Rastreado se alguma receita for informada, por exemplo:

  • Se um evento __iap__ for acionado
  • Se o SDK relatar um evento de receita de anúncios
  • Se você estiver informando receita via S2Scom um nome de evento como "purchase" (compra).
  • Se você estiver informando outros eventos de receita, como "reembolso" ou "compra off-line"

Observação: não recomendamos o envio de postbacks para esse evento se você já estiver enviando postbacks para __iap__ ou outros eventos de receita, pois poderá acabar relatando uma receita duplicada.

__UNINSTALL__ Desinstalação Rastreado automaticamente se a desinstalação estiver ativada para seu aplicativo iOSou Androide se pelo menos uma desinstalação tiver sido rastreada. Se uma desinstalação for detectada em um dispositivo, ela será acionada uma vez por dia.
__REINSTALAÇÃO__ Reinstalação Rastreado automaticamente se a desinstalação estiver ativada por meio do SDK/S2S. Se um __UNINSTALL__ de um dispositivo for rastreado e, em seguida, uma __SESSION__ subsequente for acionada, o evento __REINSTALL__ também será acionado

Use o guia de implementação de eventos para o SDK/S2S apropriado. O guia descreve como implementar eventos padrão e personalizados (se você os usar).

Guias de implementação de eventos por SDK:

Integração do SDK do iOS Integração do Singular S2S: Rastreamento de eventos
SDK do Android: Rastreamento de eventos e receita Integração com o Flutter
SDK do Unity:Rastreamento de eventos e receita Integração com mParticle
SDK do React Native: Rastreamentode eventos e receita Integração do SDK do Segment
SDK do Unreal Engine:Rastreamento de eventos e receita Integração do Segment S2S

Observação: os nomes padrão de eventos/atributos podem variar um pouco de acordo com a plataforma, por exemplo, sngLogin em vez de sng_login, dependendo das diretrizes da plataforma para nomes de entidades. O guia de cada SDK contém links para uma lista atualizada de eventos padrão disponíveis na plataforma específica e seus nomes conforme precisam aparecer no código.

3

Verifique seus eventos na Singular Platform

Defina eventos na página Settings > Events (Configurações > Eventos) para vê-los em seus relatórios agregados.

Quando seu aplicativo começar a enviar eventos padrão para a Singular, eles serão automaticamente adicionados à página Eventos. Para cada evento no SDK, a Singular cria um evento exclusivoe um evento não exclusivo na interface do usuário. Consulte Entenda a UI de eventos abaixo.

Observação: se você remover um evento, a Singular não o adicionará novamente de forma automática, mas você sempre poderá adicioná-lo novamente de forma manual.

 

Entenda a interface do usuário do evento de coorte
#

A guia Eventos de coorte mostra uma lista recolhida de eventos que foram adicionados automaticamente. Ao expandir um evento, você verá suas propriedades.

events3.png

  1. Nome e ícone de recolhimento: o nome que você fornecer aqui será mostrado na interface do usuário dos relatórios.
  2. Filtro de evento exclusivo: Essa opção altera se os eventos exclusivos ou não exclusivos de seus MMPs estão disponíveis para agregação. Consulte Entender a medição de eventos - Únicos.
  3. Fontes de dados: Selecione os eventos da Singular ou de suas redes de anúncios para agregar a esse evento. É possível agregar vários eventos em um só. Depois que um evento é salvo, ele é bloqueado.
  4. Adicionar métricas calculadas: Consulte as perguntas frequentes sobre CPEe ECVR.
  5. Excluir evento: Remova seu evento. A página de eventos é limitada a 12 eventos*.
  6. Botões Salvar alterações e Cancelaralterações
  7. Histórico de eventos

* Observação: Devido ao limite de 12 eventos, a Singular adiciona automaticamente até 6 versões exclusivas e 6 versões não exclusivas de seus eventos SDK. Os clientes Enterprise não estão limitados a 12 eventos.

Depois que um evento de coorte é salvo, nenhum evento SDK adicionado pode ser editado. Observe o ícone de cadeado ao lado dos eventos. Você ainda pode adicionar mais eventos SDK para agregar no mesmo evento de coorte.

Entenda a interface do usuário do evento de conversão
#

A guia Conversion Events (Eventos de conversão) mostra uma lista recolhida de eventos de seus parceiros de publicidade. Ao expandir um evento, você verá suas propriedades.

events4.png

  1. Nome e ícone de recolhimento: o nome que você fornecer aqui será mostrado na interface do usuário dos relatórios.
  2. Fontes de dados: Selecione os eventos de suas redes de anúncios para agregar a esse evento. Você pode agregar vários eventos em um só. Esses eventos podem ser editados livremente.*
  3. Adicione métricas calculadas: Consulte as perguntas frequentes sobre CPEe ECVR.
  4. Excluir evento: Remova seu evento. A página de eventos de conversão pode ter um número ilimitado de eventos.*
  5. Botões Salvar alterações e Cancelaralterações
  6. Histórico de eventos

* Observação: Diferentemente dos eventos de coorte, os eventos de conversão configurados não são limitados e você pode editá-los livremente. Observe o ícone "x" ao lado de cada evento.

Adição manual de eventos personalizados

Se seu SDK enviar eventos personalizados para a Singular, eles não serão adicionados automaticamente à página Events (Eventos). Você precisa adicioná-los manualmente clicando em New Event (Novo evento) e definindo os detalhes do evento.