Acompanhamento de eventos e receitas

Seguir
Avatar
Eyal Rabinovich
Updated
Documento

Guia de integração do SDK do Unreal Engine

Guia para Desenvolvedores Registro de alterações
Pré-requisitos
Compatibilidade Unreal Engine 4.23+
Guias de integração
  1. Integração básica
  2. Acompanhamento de eventos e receita
  3. Implementação de links profundos
  4. Adicionando suporte a SKAdNetwork
  5. Opções avançadas

Rastreamento de eventos (sem receita)

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

Por exemplo, a sua organização pode querer recolher dados sobre logins de utilizadores, registos, conclusões de tutoriais ou subida de nível numa aplicação de jogos.

Você pode enviar eventos para o Singular a partir do seu aplicativo usando o método SendEvent e 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, se você planeja usá-los.

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

Exemplo de uso

 
// Send an event without any parameters, just a name

  USingularSDKBPLibrary::SendEvent("Login");
Método SingularSDK SendEventWithArgs
Descrição Envia um evento de usuário para o 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 recolher dados sobre a receita obtida através da aplicação para ajudar a analisar o desempenho e o ROI das suas campanhas. A Singular disponibilizará os dados em relatórios, exportação de logs e postbacks.

Notas: Qualquer receita relatada em uma moeda diferente será convertida automaticamente para a moeda preferida da sua organização, conforme definido na sua conta Singular.

Use SendRevenue para passar informações sobre uma compra para o 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 parâmetros personalizados adicionais.

Método SendRevenue do SingularSDK
Descrição Envia um evento de receita para o Singular.
Assinatura 
public static void SendRevenue(FString eventName,
 FString currency, float amount)
Nota: 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 Envia um evento de receita para o Singular com parâmetros personalizados adicionais.
Assinatura 
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
Nota: Passe a moeda como um código de moeda ISO 4217 de três letras, como "USD", "EUR", "INR".
Exemplo de uso 
// Send a revenue event with product details

  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
  "USD", 9.99, args);

Rastreamento de evento híbrido (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 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 "Acompanhamento de receitas" no guia de 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.

Guia de integração do SDK do Unreal Engine

Guias de integração
  1. Integração básica
  2. Acompanhamento de eventos e receita
  3. Implementação de links profundos
  4. Adicionando suporte a SKAdNetwork
  5. Opções avançadas