Integración con Singular

Glosario

Singular

Plataforma de atribución y análisis de marketing. Singular permite a desarrolladores de aplicaciones, profesionales del marketing y marcas realizar un seguimiento, medir y optimizar la eficacia de sus campañas de marketing en diversos canales y dispositivos.

Consulte la documentación de Singular para obtener más información sobre la plataforma.

ID de aplicación

ID de aplicación móvil, que es único para cada plataforma (Android o iOS). Se corresponde con el valor Bundle ID que puedes encontrar en Singular en la sección Settings > Apps, en el panel de una aplicación requerida.

Evento dentro de la aplicación

Acción de usuarios dentro de la aplicación. Consulte la documentación de Singular para obtener más información sobre los eventos dentro de la aplicación. Las acciones de los usuarios en Web Shop también se consideran eventos dentro de la aplicación en caso de integración S2S y se envían a Singular desde el back-end de Xsolla.

Adquisición de usuarios

El proceso de atraer nuevos usuarios a un sitio, servicio, plataforma o aplicación mediante actividades de marketing.

Retargeting

Dirigirse a usuarios actuales o del pasado a través de campañas publicitarias. La estrategia consiste en atraer a usuarios que ya han interactuado con su aplicación o sitio web. Consulte la documentación de Singular para obtener más información.

ID del cliente/usuario (CUID)

ID de usuario generado y establecido por el propietario de la aplicación en el momento del registro de usuario. El СUID debe ser el mismo para Web Shop y Singular. Este parámetro se utiliza para la concordancia de usuarios y la atribución.

Aviso

Debe transmitir este parámetro en la postback (devolución de datos). Si los CUID de la Web Shop y de su aplicación móvil no coinciden, contacte con su gestor de éxito del cliente o envíe un correo electrónico a csm@xsolla.com para implementar el webhook Validación de usuarios en Web Shop o la autenticación mediante un enlace profundo.

Nota

Para configurar el CUID, consulte la documentación del SDK de Singular.

Postback (devolución de datos)

Proceso de recepción de datos sobre eventos dentro de la aplicación. Consulte la documentación de Singular para obtener más información.

Clave del SDK

Token que se utiliza para autorizar llamadas S2S para enviar datos de eventos a Singular. Se genera en el lado de Singular. Consulte la documentación de Singular para obtener más información.

Flujo de integración

Singular y Xsolla admiten la integración S2S en aplicaciones móviles eso permite medir y evaluar la eficacia de las campañas de captación de usuarios y de retargeting para atraer tráfico a la Web Shop. Xsolla envía información sobre las compras de Web Shop a Singular como in-app eventos dentro de la aplicación, los cuales Singular después atribuye a la fuente correspondiente.

Puede configurar la integración de aplicaciones móviles para obtener análisis avanzados de eventos si:

• tiene una aplicación móvil para Android/iOS
• utiliza Singular
• utiliza la solución Web Shop para vender artículos internos del juego

El siguiente evento está disponible a través de la integración S2S de Xsolla y Singular:

Cómo funciona

La integración incluye un flujo de datos bidireccional entre Xsolla y Singular. A continuación presentamos el escenario de interacción del sistema cuando un usuario realiza una compra.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular-->>Xsolla Backend: 3. Sends postback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Singular: 7. Sends xsolla-billing-payment event

1. El usuario (jugador) se registra o inicia sesión en la aplicación móvil.
2. Su aplicación envía un evento dentro de la aplicación a Singular; por ejemplo, login, signup u otro evento que incluya el CUID.

3. Singular envía una postback (devolución de datos) a Xsolla, que incluye el CUID y otros datos sobre el dispositivo del usuario.
4. El usuario inicia sesión en Web Shop mediante el CUID.
5. El usuario realiza una compra en Web Shop.
6. El evento de compra se envía al servidor de Xsolla y se compara con los datos recibidos de Singular.
7. El servidor de Xsolla envía un evento dentro de la aplicación a Singular, que contiene los parámetros requeridos para la asignación.

Singular asigna un nuevo evento, la compra y los ingresos a la fuente de medios que impulsó la adquisición del usuario o el compromiso renovado del usuario.

Cómo se establece en Cuenta del editor

1. Abra su proyecto en Cuenta del editor y vaya a Integrations.
2. Haga clic en el panel de Singular.

3. En el panel Mobile app S2S integration, haga clic en Configure.
4. En la ventana que se abre, asegúrese de que la casilla Enable this integration esté marcada.
5. Proporcione los siguientes datos:
   1. Clave del SDK de Singular.
   2. ID de la aplicación, que es único para cada plataforma (Android/iOS). Para agregar una plataforma, haga clic en Add application ID.
6. Haga clic en Save.
7. Active la integración en Singular.

Cuando haya guardado la configuración, se mostrará un indicador verde en el panel de integración S2S.

Para realizar cambios en la integración conectada:

1. Haga clic en el panel de Singular.
2. Haga los cambios necesarios en la ventana que se abre.
3. Haga clic en Save.

Cómo se establece en Singular

In Singular, tiene que:

1. Obtener una clave del SDK.
2. Activar la integración con Xsolla.

Obtener la clave del SDK

1. Inicie sesión en su cuenta de Singular.
2. Abra la sección Developer Tools > SDK Integration.
3. Vaya a la pestaña SDK Keys.
4. Haga clic en Show Keys.
5. Copie el valor del campo SDK Key.

Activar la integración con Xsolla

1. Inicie sesión en su cuenta de Singular.
2. Vaya a la sección Attribution Setup > Partner Configuration.
3. Haga clic en Add Partner.
4. En la barra de búsqueda, introduzca y seleccione Xsolla.

5. En la ventana que se abre, seleccione una aplicación para la que quiera configurar la integración.
6. Haga clic en Next.
7. Asegúrese de que en el bloque Events Postbacks, esté seleccionado el evento Login.
8. Haga clic en Save.

Estructura de valores del evento

Si quiere configurar un evento específico o si las opciones de integración actuales no cubren sus necesidades, contacte con su gestor de éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Compra de artículos

Cuando un usuario realiza una compra en Web Shop, Xsolla envía el evento xsolla-billing-payment a Singular. La siguiente información de compra se transmite en los parámetros del evento:

Datos adicionales

Además de los parámetros transmitidos en el evento xsolla-billing-payment, Xsolla envía los siguientes datos: