Integración con Adjust

Glosario

Adjust

Plataforma de atribución y análisis de marketing para dispositivos móviles. Adjust 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 Adjust para obtener más información sobre la plataforma.

Token de aplicación

ID de aplicación móvil único para cada plataforma (Android, iOS, etc.). Se genera automáticamente al añadir una aplicación a Adjust. Encontrará este valor en Adjust, en AppView > All apps, junto al nombre de la aplicación correspondiente.

ID de Adjust

ID de usuario generado por Adjust.

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 Adjust para obtener más información sobre el LTV.

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

Métrica que mide la eficacia de una campaña publicitaria calculando los ingresos obtenidos por unidad de inversión publicitaria. Consulte la documentación de Adjust para obtener más información sobre la ROAS.

Evento dentro de la aplicación

Acción de usuarios dentro de la aplicación. Consulte la documentación de Adjust 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 Adjust 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.

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 Adjust. Este parámetro se utiliza para la concordancia de usuarios y la atribución.

Aviso

Debe transmitir el CUID como parámetro de socio xsolla_cuid siguiendo las instrucciones.

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.

Devolución de llamada

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

Token de seguridad de servidor a servidor (S2S)

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

Escenario de integración

Adjust y Xsolla admiten la integración S2S de aplicaciones móviles, lo que permite realizar mediciones completas de LTV y ROAS para las compras que se realizan dentro de la aplicación y en la Web Shop. Xsolla envía información sobre las compras en Web Shop a Adjust como eventos dentro de la aplicación, que Adjust luego atribuye al número de instalaciones de la aplicación móvil, adquisición de usuarios y campañas de recaptación.

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

• tiene una aplicación móvil en la plataforma Android/iOS
• utiliza Adjust
• utiliza la solución Web Shop para vender artículos de juegos

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

Cómo funciona

La integración incluye un flujo de datos bidireccional entre Xsolla y Adjust. 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 Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    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->>Adjust: 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 Adjust, por ejemplo, login, signup u otro evento que incluya el CUID.
3. Adjust envía una devolución de llamada a Xsolla, que incluye el token de la aplicación, el ID de Adjust, el CUID y otros parámetros de datos relacionados.
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 Adjust.
7. El servidor de Xsolla envía un evento S2S dentro de la aplicación a Adjust, que contiene el ID de Adjust, el token de la aplicación y otros parámetros recibidos de Adjust.

Adjust 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 Adjust.

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. Introduzca los siguientes datos:
   • Token de seguridad S2S de Adjust.
   • Token de la aplicación para plataformas de publicación (Android/iOS). Para añadir una plataforma, haga clic en Add app token.
6. Haga clic en Save.
7. Active la integración en Adjust.

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 Adjust.
2. Haga los cambios necesarios en la ventana que se abre.
3. Haga clic en Save.

Cómo se establece en Adjust

En Adjust, debe:

1. Configurar la transmisión del CUID como parámetro de socio.
2. Obtener un token de seguridad S2S.
3. Activar la integración con Xsolla.

Transmitir el CUID como parámetro de socio

Configure la transferencia del CUID siguiendo las instrucciones. Para ello, llame al método addGlobalPartnerParameter y transmita los siguientes datos:

• ID de usuario en su lado
• forKey: “xsolla_cuid”

Ejemplo:

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

Obtener token de seguridad S2S

Para obtener un token de seguridad S2S:

1. Inicie sesión en su cuenta de Adjust.
2. Abra la sección AppView > All apps y vaya a la página de su aplicación.
3. Vaya a la pestaña Protection.
4. En el bloque S2S security, haga clic en Open S2S security.
5. En la línea con el token S2S necesario, haga clic en el icono de copiar.

Si aún no tiene el token S2S, cree uno siguiendo las instrucciones.

Activar la integración con Xsolla

1. Inicie sesión en su cuenta de Adjust.
2. Vaya a la sección Campaign Lab > Partners.
3. Haga clic en New partner.

4. En la barra de búsqueda, introduzca y seleccione Xsolla.
5. Haga clic en Next.

6. Seleccione la aplicación para la que quiera configurar la integración.
7. Haga clic en Next.
8. Habilite el intercambio de datos. Para ello, en el bloque Enable data sharing, haga clic en Edit, active la opción, y haga clic en Enable.

9. Configure la asignación de eventos:

1. 1. En el bloque Map your events, haga clic en Map event.

1. 2. En la sección Adjust event, seleccione xsolla-billing-payment.
   3. En la sección Partner event, seleccione Xsolla billing payment.
   4. Haga clic en Apply.

10. Haga clic en Next.
11. Revise la configuración y haga clic en Enable partner. Si es necesario, puede volver a los pasos anteriores y cambiar la configuración.

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 Adjust. La siguiente información de compra se transmite en los parámetros del evento:

Datos adicionales

También puede transmitir los siguientes parámetros en la devolución de llamada: