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.
- Leia nosso Guia de Implementação Técnica de Eventos de Assinatura se você quiser rastrear a receita de assinatura.
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.
- Utilize o método adRevenue para acompanhar eventos de receitas de anúncios com informações detalhadas sobre os dados dos anúncios.
- Leia nosso guia detalhado sobre como implementar a atribuição de receita de anúncios com parceiros de mediação.
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
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.
Siga os links abaixo para obter detalhes sobre como ativar esses parceiros.