Puede configurar la integración de Web SDK con Singular para obtener análisis avanzados de eventos si emplea:

• Singular Mobile Measurement Platform
• Xsolla Site Builder

Los siguientes eventos están disponibles a través de la integración de Xsolla y el SDK Web de Singular:

Cómo funciona

A continuación presentamos un escenario de interacción del sistema al implementar una campaña de adquisición de usuarios y retargeting. El usuario accede a través de banners publicitarios a la Web Shop y realiza una compra. El conjunto de eventos que se envían a Singular en este proceso nos permite ver:

• qué usuarios, en qué cantidad y desde qué banner llegaron
• cuánto pagaron
• si la campaña de retargeting funcionó

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant SG as Singular
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>SG: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>SG: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>SG: 7. event

Flujo del usuario:

1. El usuario pulsa en el banner de la campaña publicitaria.
2. Al usuario se le redirige a Web Shop, y la URL de esta transición incluye los parámetros y macros de Singular, que especifican desde qué banner y sitio se ha redirigido al usuario.
3. Se envía un evento sobre la visita desde el lado del cliente de Web Shop a Singular.
4. El usuario inicia sesión en Web Shop utilizando su CUID.
5. El evento de autorización se envía a Singular.
6. El usuario hace una compra en la Web Shop.
7. El evento de compra se envía a Singular.

Cómo se establece en Singular

1. Inicie sesión en su cuenta de Singular.
2. Vaya a la sección Settings > Apps.

3. Haga clic en Add new step.

4. Especifique el nombre de su aplicación web.

5. Seleccione Web como el el sistema operativo.
6. En el campo URL, especifique el dominio de su Web Shop, p.  ej., yourapp.yourcompany.com.
7. En el campo Bundle ID especifique su ID del lote en formato de DNS inverso, p.  ej., com.yourcompany.
8. Haga clic en Save.

Cómo se establece en Cuenta del editor

1. Abra su proyecto en Cuenta del editor.
2. Vaya a Site Builder utilizando uno de los siguientes métodos:
   • En el menú lateral, haga clic en Storefronts > Websites, seleccione su sitio y pulse en Configure.
   • En el menú lateral, haga clic en Integrations. En la sección que se abre:
     1. Pulse en el panel de Singular.

1. • 2. En el panel de Web SDK (Site Builder), haga clic en Configure.

2. • 3. Seleccione su sitio y haga clic en Configure.
     4. En la pestaña Site settings tab, vaya a la sección Apps.
     5. En el panel Singular, pulse en Connect.

3. En el formulario Singular connection, rellene los campos SDK key, SDK secret y el Bundle ID:

3. Para localizar esta información en su cuenta de Singularr:
   1. Inicie sesión en su cuenta de Singular.
   2. Vaya a la sección Developer Tools > SDK Integration.
   3. Vaya a la pestaña SDK Keys.
   4. Pulse en Show Keys.
   5. Copie el valor en el campo SDK Key.
   6. Copie el valor en el campo SDK Secret.

3. 7. Para localizar su Bundle ID, vaya a Settings > Apps > Web Application y copie el Bundle ID.

4. Haga clic en Connect.

Cómo lanzar campañas de anuncios web y dentro de la aplicación para Web Shop

Utilice estas instrucciones para ejecutar y hacer seguimiento de las campañas publicitarias de adquisición y retargeting de usuarios para Web Shop de Xsolla. Esto es aplicable a ambas:

• campañas desde la web a Web Shop (anuncios que redirigen a los usuarios desde fuentes web a su Web Shop)
• como a las campañas de retargeting desde la app a Web Shop (anuncios que redirigen a los usuarios desde su aplicación a su Web Shop)

1. Inicie sesión en su cuenta de Singular.
2. Vaya a la sección Attribution Setup y seleccione Create Web Link.
3. En el campo Target (App) field, escoja su aplicación web asociada con Xsolla Web Shop.
4. En el campo Partner, seleccione su socio de red publicitaria.

5. Introduzca la ruta de la página de destino si es necesario (opcional)
6. Actualice los campos de UTM para recopilar los detalles de la campaña (opcional).
7. Haga clic en Generate Link.

Se generará una URL de destino final para su campaña web en función de su selección. Redirija el tráfico a este enlace para su campaña web.

Para realizar un seguimiento más detallado de la campaña (granularidad), puede agregar macros a la URL generada. Utilice la guía de adición de macros para agregar parámetros de macro para el Singular Web SDK, lo cual permite la adquisición de datos a nivel de campaña. Procure no anular ningún parámetro existente en el enlace.

Las instrucciones pueden actualizarse en función de la red publicitaria específica seleccionada. Respete siempre las indicaciones específicas de la red publicitaria que se visualizan en el generador de URL web.

Cómo añadir eventos web/de Web Shop en Singular

1. Inicie sesión en su cuenta de Singular.
2. Vaya a la sección Settings > Events.
3. Agregue los eventos registrados por su Web SDK:
   1. Seleccione App specific Events.
   2. Seleccione su aplicación.
   3. En la sección Cohort Events, añada el nombre del evento que aparecerá en sus informes.
   4. En el campo Event maps to the following seleccione el evento del SDK.
   5. Pulse en Save.

Cómo obtener el informe de rendimiento de las campañas de anuncios de Web Shop en Singular

Para generar un informe sobre campañas de anuncios web a web y dentro de la aplicación a web:

1. Inicie sesión en su cuenta de Singular.
2. Vaya a la sección Reports > Insights.
3. Configure sus filtros:
   • Establezca el intervalo de fechas que desee.
   • Seleccione la aplicación que quiere analizar.

4. Agregue dimensiones para segmentar sus datos:
   • Fuente
   • Nombre de campaña
   • dimensiones adicionales según las necesidades

5. Escoja sus métricas web:
   • Nuevos visitantes web
   • Visitantes web recaptados

6. Incluir datos de cohorte:
   • Ingresos
   • Retorno de la inversión
   • cualquier evento de cohorte personalizado preconfigurado en la página Settings > Events

7. Haga clic en Run report en la esquina superior derecha.

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: