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 Singular Device (SDID)

ID único que identifica el navegador de cada visitante, generado automáticamente por Singular Web SDK.

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.

Valor del ciclo de vida (LTV)

Promedio de ingresos que un usuario genera durante el tiempo que utiliza la aplicación. Consulte la documentación de Singular para obtener más información sobre el LTV (valor del ciclo de vida).

Rentabilidad de la inversión publicitaria (ROAS, por las siglas en inglés)

Dato métrico que mide la eficacia de una campaña publicitaria calculando los ingresos obtenidos por unidad de inversión publicitaria.

Evento web

Acciones del usuario en Web Shop, que se envían desde el lado del cliente de Web Shop a Singular y son necesarias para la integración del Web SDK.

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

Una estrategia para atraer a usuarios que han interactuado anteriormente con su aplicación o sitio web. El objetivo es restablecer la actividad de los usuarios actuales o inactivos mediante campañas publicitarias. Consulte la documentación de Singular para obtener información detallada.

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 CUID debe ser el mismo para Web Shop y Singular. Este parámetro se utiliza para la concordancia de usuarios y la atribución.

Debe transmitir este parámetro en la postback (devolución de datos).

Si ha configurado la autenticación mediante ID de usuario en su Web Shop, asegúrese de que el CUID utilizado en la Web Shop coincida con el configurado para enviarse al MMP desde su aplicación móvil. Si no coinciden, contacte con su gestor de éxito del cliente o envíe un correo electrónico a [email protected] para implementar el webhook Validación de usuarios en Web Shop o la autenticación mediante un enlace profundo.

Si ha configurado otras opciones de autenticación, consulte la sección Configuración de la autenticación para la integración con MMP.

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.

Secreto del SDK

Componente usado junto con la clave del SDK de Singular para inicializar y autenticar el SDK de Singular dentro de una aplicación. Este secreto, junto con la clave del SDK, permite que el SDK se comunique de forma segura con la plataforma Singular y atribuya adecuadamente las instalaciones de aplicaciones, los eventos y otros datos para el análisis de marketing.

Flujo de integración

Singular y Xsolla admiten los siguientes tipos de integraciones:

Integración S2S en aplicaciones móviles: permite la ejecución de mediciones LTV y ROAS completas respecto a las compras dentro de la aplicación y en la Web Shop. Xsolla envía información sobre las compras en la Web Shop a Singular como eventos internos de la app, que Singular atribuye al número de instalaciones de la aplicación móvil, adquisición de usuarios y campañas de recaptación.
Integración de Web SDK: le permite medir y evaluar la eficacia de las campañas de adquisición de usuarios y retargeting para atraer tráfico a la Web Shop.
La integración del Web SDK permite determinar el número de usuarios que llegaron al sitio a través de una campaña de retargeting y la conversión de los canales que llevan al sitio. Xsolla envía información sobre las compras en Web Shop a Singular como eventos web, que Singular atribuye a la fuente, campaña, conjunto publicitario y anuncio correspondientes que llevaron al usuario a realizar la compra.

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

Puede configurar la integración del SDK web con Singular para obtener análisis avanzados de eventos si utiliza:

Singular Mobile Measurement Platform
Creador de sitios web de Xsolla

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

Evento	Descripción
`load`	Evento de visita al sitio web, incluidos los parámetros de la URL que contienen la información sobre la fuente de la que procede el usuario, y un ID de Singular Devicer, que se guarda en una cookie de origen.
`identify`	Evento de inicio de sesión, incluido el ID de Singular Device y CUID.
`event`	Evento de compra de artículos, incluyendo el ID de Singular Device y CUID, y otros eventos de Site Builder.

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 U as Usuario
    participant WSP as Campaña promocional de Web Shop (banner publicitario)
    participant WS as Web Shop
    participant SG as Singular
    U->>WSP: Pulsa en el banner
    WSP->>WS: Redirige con los parámetros de la URL
    WS->>SG: Envía un evento de carga
    U->>WS: Inicia sesión con CUID
    WS->>SG: Envía un evento de identificación
    U->>WS: Realiza una compra
    WS->>SG: Envía un evento de compra

Flujo del usuario:

El usuario pulsa en el banner de la campaña publicitaria.
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.
Se envía un evento sobre la visita desde el lado del cliente de Web Shop a Singular.
El usuario inicia sesión en Web Shop utilizando su CUID.
El evento de autorización se envía a Singular.
El usuario hace una compra en la Web Shop.
El evento de compra se envía a Singular.

Cómo se establece en Singular

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

Haga clic en Add new step.

Especifique el nombre de su aplicación web.

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

Cómo se establece en Cuenta del editor

Cómo configurar en su cuenta

Abra su proyecto en Cuenta del editor.
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.

Abra el proyecto en su cuenta.
Vaya al creador de sitios utilizando uno de los siguientes métodos:
- En el menú lateral, haga clic en Storefronts > Websites. En el panel de su sitio web, haga clic en el icono ⋮ y seleccione Configure.
- En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
  1. Haga clic en el panel de Singular.

Abra el proyecto en su cuenta.
Vaya al creador de sitios utilizando uno de los siguientes métodos:
- En el menú lateral, haga clic en Storefronts > Websites. En el panel de su sitio web, haga clic en el icono ⋮ y seleccione Configure.
- En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
  1. Haga clic en el panel de Singular.

Abra el proyecto en su cuenta.
Vaya al creador de sitios utilizando uno de los siguientes métodos:
- En el menú lateral, haga clic en Storefronts > Websites. En el panel de su sitio web, haga clic en el icono ⋮ y seleccione Configure.
- En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
  1. Haga clic en el panel de Singular.

Abra su proyecto en la cuenta para juegos en móviles.
Vaya al creador de sitios utilizando uno de estos métodos:
- En el menú lateral, haga clic en Web Shop. En el panel de su sitio, haga clic en el ⋮ icono y seleccione Configure.
- En el menú lateral, haga clic en Operations > MMP. En la sección que se abre:
  1. Haga clic en el panel Singular.

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

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

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

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.

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

Haga clic en Connect.

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

Puede lanzar y hacer un seguimiento de las siguientes campañas publicitarias de adquisición de usuarios y retargeting para Web Shop:

Campañas web que dirigen a los usuarios desde fuentes web a su Web Shop. En este caso, Singular se encargará del seguimiento y la atribución.
Campañas en aplicaciones que dirigen a los usuarios desde las aplicaciones a su Web Shop. En este caso, debe utilizar DSP, y Singular se encargará del seguimiento y la atribución.

Para crear un enlace web de Singular:

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

Introduzca la ruta de la página de destino si es necesario (opcional)
Actualice los campos de UTM para recopilar los detalles de la campaña (opcional).
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.

Consulta la guía Singular Website Links (Enlaces web de Singular) para obtener más información.

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

Inicie sesión en su cuenta de Singular.
Vaya a la sección Settings > Events.
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.

Consulte las instrucciones de How to Track In-App Events para obtener más información.

Los eventos de ingresos se incluyen automáticamente en el parámetro Revenue (Ingresos) de los informes de Singular. No tiene que agregar un evento personalizado salvo que desee realizar un seguimiento independiente del recuento de eventos de ingresos.

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:

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

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

Escoja sus métricas web:
- Nuevos visitantes web
- Visitantes web recaptados

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

Haga clic en Run report en la esquina superior derecha.

Establezca una convención de nomenclatura clara para sus campañas que distinga entre campañas de web a web y de dentro de aplicación a web. Esta taxonomía simplifica considerablemente el análisis de informes y asegura que su equipo pueda identificar rápidamente los tipos de campaña.

Consulte las Reports FAQ (Preguntas frecuentes de informes) para obtener más información.

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:

Evento	Descripción
xsolla-billing-payment	Compra de artículo. Los parámetros del evento contienen información sobre una compra.

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

El usuario (jugador) se registra o inicia sesión en la aplicación móvil.
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.

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

Singular envía una postback (devolución de datos) a Xsolla, que incluye el CUID y otros datos sobre el dispositivo del usuario.
El usuario inicia sesión en Web Shop mediante el CUID.
El usuario realiza una compra en Web Shop.
El evento de compra se envía al servidor de Xsolla y se compara con los datos recibidos de Singular.
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

Cómo configurar en su cuenta

Abra su proyecto en Cuenta del editor y vaya a Integrations.

Abra el proyecto en su cuenta y vaya a Other tools > Integrations.

Abra el proyecto en su cuenta y vaya a Other tools > Integrations.

Abra el proyecto en su cuenta y vaya a Other tools > Integrations.

Abra su proyecto en la cuenta para juegos en móviles y vaya a Operations > MMP.

Haga clic en el panel de Singular.

En el panel Mobile app S2S integration, haga clic en Configure.
En la ventana que se abre, asegúrese de que la casilla Enable this integration esté marcada.
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.
Haga clic en Save.
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:

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

Cómo se establece en Singular

In Singular, tiene que:

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

Obtener la clave del SDK

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

Activar la integración con Xsolla

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

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

Asegúrese de haber configurado el CUID:

El método SetCustomerId y su evento de autenticación se implementan mediante el SDK de Singular.
En su Cuenta del editor de Xsolla, está configurada la integración con Singular.
En su cuenta de Singular, la integración con Xsolla está activada.

Si tiene la opción de Reject IAP without receipt habilitada para su aplicación en Singular, contacte con su gestor del cliente de Singular para habilitar o deshabilitar los eventos de ingresos de Xsolla.

Asegúrese de haber configurado el CUID:

El método SetCustomerId y su evento de autenticación se implementan mediante el SDK de Singular.
En su cuenta de Xsolla, está configurada la integración con Singular.
En su cuenta de Singular, la integración con Xsolla está activada.

Asegúrese de haber configurado el CUID:

El método SetCustomerId y su evento de autenticación están implementados utilizando el SDK de Singular.
En su cuenta para juegos en móviles, está configurada la integración con Singular.
En su cuenta de Singular, la integración con Xsolla está activada.

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 [email protected] .

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:

Parámetro	Descripción
content_id	Código de artículo (SKU) único o matriz de códigos de artículos (SKU) de la compra.
quantity	Cantidad del artículo con SKU correspondiente (uno o una matriz).
revenue	Importe de la compra. Se incluyen los descuentos. No contiene comisiones ni impuestos.
currency	Moneda de compra.

Datos adicionales

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

Parámetro	Descripción
a	Clave del SDK de Singular.
p	Plataforma de aplicaciones. Ejemplo: iOS.
ip	Dirección IP pública del dispositivo del usuario.
ve	Versión del sistema operativo del dispositivo del usuario.
ma	Marca del dispositivo del usuario. Ejemplo: Apple.
mo	Modelo del dispositivo del usuario. Ejemplo: iPhone 4S.
lc	Configuración regional del dispositivo del usuario en formato `^[a-z]{2}-[A-Z]{2}$`. Ejemplo: `en_US`.
i	ID de la aplicación en el lado de Singular.
att_authorization_status	Código de estado App Tracking Transparency (ATT, siglas en inglés de Transparencia del seguimiento de aplicaciones).
n	Nombre del evento. La longitud máxima es de 32 caracteres.
is_revenue_event	Si el evento está vinculado o no a los ingresos.
amt	Cantidad de moneda.
cur	Código de moneda de tres letras conforme a la norma ISO 4217.
custom_user_id	CUID.
partner	Socio: `xsolla`.
e	Otros parámetros personalizados (opcionales).

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Última actualización: 20 de Octubre de 2026

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Contenidos

Glosario
Flujo de integración
Cómo funciona
Cómo se establece en Singular
Cómo se establece en Cuenta del editor
Cómo configurar en su cuenta
Cómo configurar en su cuenta
Cómo lanzar campañas de anuncios web y dentro de la aplicación para Web Shop
Cómo añadir eventos web/de Web Shop en Singular
Cómo obtener el informe de rendimiento de las campañas de anuncios de Web Shop en Singular
Cómo funciona
Cómo se establece en Cuenta del editor
Cómo configurar en su cuenta
Cómo configurar en su cuenta
Cómo se establece en Singular
Obtener la clave del SDK
Activar la integración con Xsolla
Estructura de valores del evento
Compra de artículos
Datos adicionales