React Native SDK - Rastrear eventos in-app

Documento

Acompanhar eventos In-App

Os eventos in-app ajudam a medir o desempenho da campanha e os indicadores-chave de desempenho (KPIs), acompanhando as acções do utilizador, tais como logins, registos, conclusões de tutoriais ou subidas de nível em aplicações de jogos. A Singular coleta esses eventos para fornecer insights sobre o comportamento do usuário e otimizar os esforços de marketing.

Eventos padrão vs. personalizados

Singular suporta dois tipos de eventos:

  • Eventos padrão: Eventos pré-definidos (por exemplo, sngLogin, sngContentView) reconhecidos pelo Singular e frequentemente suportados por redes de anúncios para relatórios e otimização. O uso de eventos padrão simplifica a configuração, pois o Singular os adiciona automaticamente à sua lista de eventos sem definição manual. Recomendação: Use eventos padrão sempre que possível para compatibilidade e facilidade de uso. Consulte a Lista de eventos e atributos padrão para obter nomes de eventos padrão e atributos recomendados.
  • Eventos personalizados: Eventos exclusivos do seu aplicativo (por exemplo, Signup, AchievementUnlocked) que não correspondem aos eventos padrão do Singular.

    Limitações de eventos personalizados:

    • É altamente recomendável passar nomes e atributos de eventos em inglês para garantir a compatibilidade com parceiros de terceiros e soluções de análise, caso pretenda utilizá-los.
    • Os nomes de eventos são limitados a 32 caracteres ASCII. As cadeias de caracteres em caracteres não ASCII têm de ter menos de 32 bytes depois de convertidas para UTF-8.
    • Os atributos e valores estão limitados a 500 caracteres ASCII.

Trabalhe com a sua equipa de UA, marketing ou negócios para compilar uma lista de eventos e atributos com base nos KPIs de marketing da sua aplicação. Consulte Como rastrear eventos no aplicativo: Guia para Clientes de Atribuição Singular para obter orientação sobre como selecionar eventos.

Enviar eventos

  • Use o método event para rastrear um evento personalizado simples com o SDK da Singular.
  • Use o método eventWithArgs para rastrear um evento personalizado com atributos adicionais com o SDK da Singular.

Melhores práticas

  • Use eventos padrão: Prefira eventos padrão para compatibilidade com redes de anúncios e reconhecimento automático na lista de eventos do Singular.
  • Validar atributos: Verifique se os atributos correspondem ao formato esperado.
  • Depurar eventos: Active o registo do SDK durante o desenvolvimento para verificar se os eventos são enviados corretamente e são acionados nos momentos apropriados do ciclo de vida da aplicação (por exemplo, após o início de sessão de um utilizador).

Nota: Coordene com a sua equipa de UA/marketing para garantir que os eventos monitorizados estão alinhados com os KPIs da sua aplicação. Teste os eventos em um ambiente de desenvolvimento antes de implantá-los na produção para verificar a precisão dos dados no Singular Dashboard.


Acompanhe a receita

O SDK React Native da Singular permite rastrear eventos de receita in-app para analisar o desempenho da campanha e o ROI. Os dados de receita estão disponíveis nos relatórios, exportações de log e postbacks do Singular, fornecendo insights acionáveis sobre a monetização do seu aplicativo.

Por que rastrear eventos de receita?

  • Análise rica: Capture dados detalhados de transações para melhorar os relatórios do Singular.
  • Prevenção de fraudes: Inclua recibos de transações (por exemplo, do Google Play ou da Apple App Store) para validar compras e combater fraudes in-app.
  • Otimização de campanhas: Meça o ROI associando a receita aos esforços de marketing.

Melhores práticas: Transmitir o objeto de compra completo

É altamente recomendável passar o objeto de compra retornado do processo de compra no aplicativo (IAP) do Android (Google Play Billing) ou do iOS (StoreKit). Isso garante que a Singular receba detalhes abrangentes da transação, incluindo:

  • ID do produto
  • Preço
  • Moeda
  • ID da transação
  • Dados do recibo (para validação)

Ao passar o objeto de compra completo, você permite relatórios mais ricos e aproveita os recursos de deteção de fraude do Singular, especialmente para transações do Google Play.

Capturar o objeto de compra IAP

Use as bibliotecas IAP específicas da plataforma para recuperar o objeto de compra:

  • iOS: Use react-native-iap ou similar para acessar os detalhes de compra do StoreKit.
  • Android: Utilize react-native-iap ou a biblioteca de faturamento do Google Play para obter o objeto de compra.

Enviar receita de IAP

  • Utilize o método inAppPurchase para acompanhar um evento de compra in-app com detalhes de compra.
  • Utilize o método inAppPurchaseWithArgs para acompanhar um evento de compra in-app com detalhes de compra e atributos personalizados adicionais.

Enviar receita sem o objeto de compra

Embora seja altamente recomendável relatar eventos de receita usando os métodos inAppPurchase para validação de receita, também é possível enviar eventos de receita para a Singular apenas passando a moeda e o valor da transação.

Importante: Ao enviar eventos de receita sem um objeto de compra válido, a Singular não valida as transações.

Requisitos

Nota: Passe a moeda como um código de moeda ISO 4217 de três letras, por exemplo, "USD," "EUR", "INR".

  • Use o método revenue para rastrear um evento de receita simples com uma moeda e um valor especificados.
  • Use o método revenueWithArgs para rastrear um evento de receita com uma moeda, um valor e atributos personalizados adicionais especificados.
  • Use o método customRevenue para rastrear um evento de receita personalizado com um nome de evento, moeda e valor especificados.
  • Use o método customRevenueWithArgs para rastrear um evento de receita personalizado com um nome de evento, moeda, valor e atributos personalizados adicionais especificados.

Enviar receita de assinatura

A Singular oferece um guia abrangente sobre como implementar eventos de assinatura usando o Singular SDK. Ele cobre o rastreamento de eventos de assinatura in-app em várias plataformas.


Enviar receita de anúncios

A Atribuição de Receita de Anúncios ajuda-o a ligar a sua receita de anúncios às campanhas específicas que trouxeram utilizadores à sua aplicação. Isto dá-lhe uma imagem clara do desempenho dos seus anúncios, mostrando o custo da campanha, a receita in-app e a receita de anúncios, tudo num único local. Esta funcionalidade também lhe permite enviar dados de receitas de anúncios para as suas redes de anúncios para melhorar o desempenho dos seus anúncios.


Rastreamento de eventos híbrido

A Singular recomenda o envio de todos os eventos e receitas por meio do SDK da Singular integrado ao seu aplicativo. No entanto, a Singular pode coletar eventos e receitas de outras fontes.

Qualquer evento NÃO enviado do SDK da Singular deve estar em conformidade com os requisitos de documentação de eventos de servidor para servidor da Singular e fornecer o identificador de dispositivo correspondente para atribuir corretamente um evento.

Importante:

Ocorrerão discrepâncias se os identificadores de dispositivo usados nas solicitações de eventos de servidor para servidor não tiverem um identificador de dispositivo correspondente no Singular. Esteja ciente das seguintes possibilidades:

  • Se uma solicitação de evento for recebida "antes" de o SDK do Singular ter gravado o identificador do dispositivo, a partir de uma sessão de aplicativo, a solicitação de evento será considerada a "primeira sessão" para o dispositivo desconhecido e o Singular atribuirá o dispositivo como uma atribuição orgânica.
  • Se o Singular SDK tiver registado um identificador de dispositivo, mas o identificador do Singular SDK for diferente do identificador de dispositivo especificado no pedido de evento de servidor para servidor, o evento será atribuído incorretamente.

Guias de rastreamento de eventos híbridos

Envio de eventos a partir de um servidor interno

A Singular pode coletar dados sobre a receita do seu servidor para ajudar a analisar o desempenho e o ROI de suas campanhas.

Requisitos:

  • A partir de um evento de registo ou de início de sessão in-app, capture e passe os identificadores de dispositivo e armazene estes dados com o ID de utilizador no seu servidor. Como os identificadores de dispositivo podem mudar para um utilizador, certifique-se de que actualiza os identificadores quando um utilizador gera uma sessão de aplicação. Isto garante que o evento do lado do servidor será atribuído ao dispositivo correto.
  • Os eventos do lado do servidor são específicos da plataforma e só devem ser enviados com o identificador de dispositivo correspondente à plataforma do dispositivo (por exemplo, IDFA ou IDFV para dispositivos iOS).
  • Pode utilizar o mecanismo de postback do Singular Internal BI para enviar um evento em tempo real para o seu ponto de extremidade interno, para que possa atualizar o conjunto de dados no lado do servidor. Consulte as Perguntas frequentes sobre o postback do BI interno.
  • Reveja a secção Rastreio de receitas no guia Integração Servidor a Servidor para obter mais detalhes.
Envio de eventos de um fornecedor de receitas
Provedores de terceiros como RevenueCat ou adapty podem fornecer receita de compra e assinatura para a Singular.

Siga os links abaixo para obter detalhes sobre como ativar esses parceiros.

Envio de eventos do segmento

Para permitir que o Segment envie eventos para a Singular, em paralelo com o SDK da Singular, é necessário adicionar um Destino "Cloud-Mode" no Segment. Siga nosso guia AQUI.