Unreal Engine SDK: Eventos de rastreamento e receita

Seguir
Avatar
Eyal Rabinovich
Updated
Singular Unreal Engine SDK
Download
 Singular Unreal Engine SDK versão 2.4.0
Compatibilidade

Unreal Engine 4.23+
Guias de integração
  1. Integração básica
  2. Rastreamento de eventos e receita
  3. Implementação de links profundos
  4. Adicionando suporte à SKAdNetwork
  5. Opções avançadas

 

Rastreamento de eventos (não receita)

A Singular pode coletar dados sobre eventos in-app para ajudar a analisar o desempenho de suas campanhas e medir KPIs.

Por exemplo, sua organização pode querer coletar dados sobre logins de usuários, registros, conclusões de tutoriais ou aumento de nível em um aplicativo de jogos.

Você pode enviar eventos para a Singular a partir de seu aplicativo usando os métodos SendEvente SendEventWithArgs .

Observação: é 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 planeje usá-los.

Método SendEvent do SingularSDK
Descrição Envia um evento de usuário para a Singular para rastreamento, com um nome de evento personalizado.
Assinatura 
public static void SendEvent(FString eventName)

Exemplo de uso

 
// Envie um evento sem nenhum parâmetro, apenas um nome
  USingularSDKBPLibrary::SendEvent("Login");
Método SingularSDK SendEventWithArgs
Descrição Envia um evento de usuário para a Singular para rastreamento, com um nome de evento personalizado e parâmetros personalizados adicionais.
Assinatura 
public static void SendEventWithArgs(FString eventName, 
  TMap<FString, FString> args)

Exemplo de uso

 
TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendEventWithArgs("Login", args);

Rastreamento de receita

A Singular pode coletar dados sobre a receita obtida por meio do aplicativo para ajudar a analisar o desempenho e o ROI de suas campanhas. A Singular disponibilizará os dados para você em relatórios, exportação de registros e postbacks.

Observações: Qualquer receita informada em uma moeda diferente será convertida automaticamente para a moeda preferida de sua organização, conforme definido em sua conta da Singular.

Use SendRevenue para passar informações sobre uma compra para a Singular, incluindo um nome de evento personalizado, a moeda da transação e o valor da transação. SendRevenueWithArgs é muito semelhante, mas permite que você adicione outros parâmetros personalizados.

Método SendRevenue do SingularSDK
Descrição Enviar um evento de receita para a Singular.
Assinatura 
public static void SendRevenue(FString eventName,
 FString currency, float amount)
Observação: Passe a moeda como um código de moeda ISO 4217 de três letras, como "USD", "EUR", "INR".
Exemplo de uso 
USingularSDKBPLibrary::SendRevenue("Purchase Completed", "USD", 9.99);
Método SendRevenueWithArgs do SingularSDK
Descrição Enviar um evento de receita para a Singular com parâmetros personalizados adicionais.
Assinatura 
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
Observação: passe a moeda como um código de moeda ISO 4217 de três letras, como "USD", "EUR", "INR".
Exemplo de uso 
// Envie um evento de receita com detalhes do produto
  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
  "USD", 9.99, args);

Rastreamento híbrido de eventos (avançado)

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 pelo 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 Server-to-Server 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 registrado o identificador do dispositivo, a partir de uma sessão de aplicativo, a solicitação de evento será considerada a "primeira sessão" do dispositivo desconhecido, e o Singular atribuirá o dispositivo como uma atribuição orgânica.
  • Se o Singular SDK tiver registrado um identificador de dispositivo, mas o identificador do Singular SDK for diferente do identificador de dispositivo especificado na solicitação de evento de servidor para servidor, o evento será atribuído incorretamente.

Guias de rastreamento de eventos híbridos

Envio de eventos de um servidor interno

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

Requisitos:

  • A partir de um evento de registro ou login no aplicativo, capture e passe os identificadores de dispositivo e armazene esses dados com o ID do usuário no seu servidor. Como os identificadores de dispositivo podem mudar para um usuário, certifique-se de atualizar os identificadores quando um usuário gerar uma sessão de aplicativo. Isso garante que o evento no 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).
  • Você pode usar o mecanismo de postback do Singular Internal BI para enviar um evento em tempo real para seu endpoint interno, de modo que possa atualizar o conjunto de dados no lado do servidor. Consulte as Perguntas frequentes sobre postback do BI interno.
  • Consulte a seção "Rastreamento de receita" no guia Integração servidor a servidor para obter detalhes.
Envio de eventos de um provedor de receita
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 habilitar esses parceiros.

Envio de eventos do segmento

Para permitir que o Segment envie eventos para a Singular, em paralelo com o SDK da Singular, você deve adicionar um destino "Cloud-Mode" no Segment. Siga nosso guia AQUI.

Singular Unreal Engine SDK
Guias de integração
  1. Integração básica
  2. Rastreamento de eventos e receita
  3. Implementação de links diretos
  4. Adicionando suporte a SKAdNetwork
  5. Opções avançadas