Unreal Engine SDK: Eventos de seguimiento e ingresos

Seguir
Avatar
Eyal Rabinovich
Updated
Singular Unreal Engine SDK
Guías de integración
  1. Integración básica
  2. Seguimiento de eventos e ingresos
  3. Implementación de enlaces profundos
  4. Añadir soporte SKAdNetwork
  5. Opciones avanzadas

 

Seguimiento de eventos (no ingresos)

Singular puede recopilar datos sobre eventos dentro de la aplicación para ayudar a analizar el rendimiento de sus campañas y medir los KPI.

Por ejemplo, es posible que su organización desee recopilar datos sobre inicios de sesión de usuarios, registros, finalización de tutoriales o subidas de nivel en una aplicación de juegos.

Puede enviar eventos a Singular desde su aplicación utilizando los métodos SendEventy SendEventWithArgs .

Nota: Recomendamos encarecidamente pasar los nombres y atributos de los eventos en inglés para garantizar la compatibilidad con socios y soluciones analíticas de terceros si tiene previsto utilizarlos.

Método SendEvent de SingularSDK
Descripción Envía un evento de usuario a Singular para su seguimiento, con un nombre de evento personalizado.
Firma 
public static void SendEvent(FString eventName)

Ejemplo de uso

 
// Enviar un evento sin parámetros, solo un nombre
  USingularSDKBPLibrary::SendEvent("Login");
Método SendEventWithArgsde SingularSDK
Descripción Envía un evento de usuario a Singular para su seguimiento, con un nombre de evento personalizado y parámetros personalizados adicionales.
Firma 
public static void SendEventWithArgs(FString eventName, 
  TMap<FString, FString> args)

Ejemplode uso

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

Seguimiento de ingresos

Singular puede recopilar datos sobre los ingresos obtenidos a través de la aplicación con el fin de ayudar a analizar el rendimiento y el ROI de sus campañas. Singular pondrá los datos a su disposición en informes, exportación de registros y postbacks.

Notas: Cualquier ingreso reportado en una moneda diferente se convertirá automáticamente a la moneda preferida de su organización según lo establecido en su cuenta de Singular.

Utilice SendRevenue para pasar información sobre una compra a Singular, incluido un nombre de evento personalizado, la moneda de la transacción y el importe de la transacción. SendRevenueWithArgs es muy similar, pero le permite añadir parámetros personalizados adicionales.

Método SendRevenue de SingularSDK
Descripción Envía un evento de ingresos a Singular.
Firma 
public static void SendRevenue(FString eventName,
 FString currency, float amount)
Nota: Pase la moneda como un código de moneda ISO 4217 de tres letras, como "USD", "EUR", "INR".
Ejemplo de uso 
USingularSDKBPLibrary::SendRevenue("Purchase Completed", "USD", 9.99);
SingularSDK SendRevenueWithArgs Método
Descripción Envía un evento de ingresos a Singular con parámetros personalizados adicionales.
Firma 
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
Nota: Pase la moneda como un código de moneda ISO 4217 de tres letras, como "USD", "EUR", "INR".
Ejemplo de uso 
// Enviar un evento de ingresos con detalles del producto
  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
  "USD", 9.99, args);

Seguimiento de Eventos Híbrido (Avanzado)

Singular recomienda enviar todos los eventos e ingresos a través del SDK de Singular integrado en su app. Sin embargo, Singular puede recoger eventos e ingresos de otras fuentes.

Cualquier evento NO enviado desde el SDK de Singular debe cumplir con los requisitos de documentación de eventos de servidor a servidor de Singular y proporcionar el identificador de dispositivo correspondiente para atribuir correctamente un evento.

Importante:

Se producirán discrepancias si los identificadores de dispositivo utilizados en las solicitudes de eventos de servidor a servidor no tienen un identificador de dispositivo coincidente en Singular. Tenga en cuenta las siguientes posibilidades:

  • Si se recibe una solicitud de evento "antes" de que Singular SDK haya registrado el identificador de dispositivo, desde una App Session, entonces la solicitud de evento se considerará la "primera sesión" para el dispositivo desconocido, y Singular atribuirá el dispositivo como una atribución orgánica.
  • Si Singular SDK registró un identificador de dispositivo, pero el identificador de Singular SDK difiere del identificador de dispositivo especificado en la solicitud de evento de servidor a servidor, entonces el evento se atribuirá incorrectamente.

Guías de seguimiento de eventos híbridos

Envío de eventos desde un servidor interno

Singular puede recopilar datos sobre los ingresos de su Servidor para ayudar a analizar el rendimiento y el ROI de sus campañas.

Requisitos:

  • Desde un Evento de Registro o Inicio de Sesión in-app, capture y pase los identificadores de dispositivo y almacene estos datos con el ID de Usuario en su servidor. Dado que los identificadores de dispositivo pueden cambiar para un usuario, asegúrese de actualizar los identificadores cuando un usuario genere una sesión de aplicación. Esto garantiza que el evento del lado del servidor se atribuya al dispositivo correcto.
  • Los eventos del lado del servidor son específicos de cada plataforma y sólo deben enviarse con el identificador de dispositivo que coincida con la plataforma del dispositivo (por ejemplo, IDFA o IDFV para dispositivos iOS).
  • Puede utilizar el mecanismo de postback de Singular Internal BI para enviar un evento en tiempo real a su endpoint interno para que pueda actualizar el conjunto de datos en el lado del servidor. Consulte las Preguntas Frecuentes sobre Postback de BI Interno.
  • Revise la sección "Seguimiento de Ingresos" en la guía de Integración Servidor-a-Servidor para más detalles.
Envío de Eventos desde un Proveedor de Ingresos
Proveedores de terceros como RevenueCat o adapty pueden proporcionar Ingresos por Compras y Suscripciones a Singular.

Siga los siguientes enlaces para obtener más información sobre cómo habilitar a estos socios.

Envío de Eventos desde Segmento

Para que Segment pueda enviar eventos a Singular, en paralelo con el SDK de Singular, debe añadir un Destino "Cloud-Mode" en Segment. Siga nuestra guía AQUÍ.

Singular Unreal Engine SDK
Guías de integración
  1. Integración básica
  2. Seguimiento de eventos e ingresos
  3. Implementación de enlaces profundos
  4. Añadir soporte SKAdNetwork
  5. Opciones avanzadas