Documento

Guía de integración del SDK de Unreal Engine

Guía para	Desarrolladores Registro de cambios
Requisitos previos	Acceso a cuenta singular Descargar: Singular Unreal Engine SDK versión 2.5.0
Compatibilidad	Unreal Engine 4.23+
Guías de integración	Integración básica Seguimiento de eventos e ingresos Implementación de enlaces profundos Añadir soporte SKAdNetwork 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, 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 SendEvent y SendEventWithArgs .

Nota: Recomendamos encarecidamente pasar los nombres y atributos de los eventos en inglés para garantizar la compatibilidad con socios y soluciones de análisis 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	`// Send an event without any parameters, just a name USingularSDKBPLibrary::SendEvent("Login");`

Método SendEventWithArgs de 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)`
Ejemplo de 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);`
Método SendRevenueWithArgs de SingularSDK
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	`// 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);`

Seguimiento de eventos híbridos (avanzado)

Singular recomienda enviar todos los eventos e ingresos a través del SDK de Singular integrado en su aplicación. Sin embargo, Singular puede recopilar 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Í.

Guía de integración del SDK de Unreal Engine

Guías de integración	Integración básica Seguimiento de eventos e ingresos Implementación de enlaces profundos Añadir compatibilidad con SKAdNetwork Opciones avanzadas