Integración con Tenjin

Glosario

Tenjin

Una plataforma de análisis de marketing y atribución en dispositivos móviles. Permite a los desarrolladores de aplicaciones y a los profesionales del marketing llevar un seguimiento, medir y optimizar las campañas de marketing en distintos canales y dispositivos.

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

ID de aplicación

ID de la aplicación para móviles que se genera automáticamente al añadir una aplicación a Tenjin. Corresponde a Bundle ID. Para encontrar su valor:

1. En su cuenta de Tenjin, vaya a la sección Configure > All apps.
2. Abra la página de la aplicación correspondiente.
3. En la sección Add details, copie Bundle ID.

Clave de SDK

ID de la aplicación para móviles que se genera automáticamente al añadir una aplicación a Tenjin. Corresponde a Bundle ID. Para encontrar su valor:

1. En su cuenta de Tenjin, vaya a la sección Configure > All apps.
2. Abra la página de la aplicación correspondiente.
3. En la sección Add details, copie Bundle ID.

Nota

Si su aplicación está publicada tanto en plataformas iOS como Android, deberá obtener una clave de nivel de cuenta. Para ello, contacte con su gestor de Tenjin.

Clave de nivel de cuenta

Token que se utiliza para autorizar llamadas de servidor a servidor (S2S) cuando su aplicación está publicada tanto en plataformas iOS como Android. Lo genera Tenjin de forma manual. Para obtenerlo, contacte con su gestor de Tenjin.

Tenga en cuenta que los ID de lote son únicos para cada plataforma.

ID de Tenjin

ID de usuario generado por Tenjin (analytics_installation_id).

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

Rentabilidad de la inversión publicitaria (ROAS)

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 Tenjin para obtener más información sobre la ROAS.

Retorno de la inversión (ROI)

Métrica que mide el retorno de la inversión calculando el porcentaje de beneficio obtenido en relación con el coste total. Consulte la documentación de Tenjin para obtener más información sobre el ROI.

Evento interno de la app

Acción de usuario dentro de la aplicación. Las acciones de usuario en Web Shop también se consideran eventos dentro de la aplicación en el caso de integración S2S y se envían a Tenjin desde el backend 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 de registrarse el usuario. El СUID debe ser el mismo para Web Shop y Tenjin. Este parámetro se utiliza para la concordancia de usuarios y la atribución.

Aviso

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 Tenjin para obtener más información.

Escenario de integración

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

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 Tenjin
• 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 Tenjin:

Cómo funciona

La integración incluye un flujo de datos bidireccional entre Xsolla y Tenjin. 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 Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>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->>Tenjin: 7. Sends xsolla-billing-payment event

1. El usuario 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 que incluye el CUID a Tenjin.
3. Tenjin envía una devolución de llamada a Xsolla, que incluye el ID de aplicación, ID de Tenjin, 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 Tenjin.
7. El servidor de Xsolla envía un evento S2S dentro de la aplicación a Tenjin, que contiene el ID de Tenjin, el ID de aplicación y otros parámetros recibidos de Tenjin.

Tenjin atribuye un nuevo evento, una compra y los ingresos a la fuente de medios.

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

3. En el panel Mobile app S2S integration, haga clic en Configure.
4. Marque la casilla Enable this integration.
5. Introduzca los siguientes datos:
   • Clave de SDK generada por Tenjin para cada plataforma. Si su aplicación está publicada tanto en la plataforma iOS como en la plataforma Android, deberá especificar una clave de nivel de cuenta que haya recibido de Tenjin.
   • ID de aplicación.
6. Haga clic en Save.
7. Active la integración en Tenjin.

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 activa:

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

Cómo se establece en Tenjin

En Tenjin, deberá:

1. Configurar la transmisión de CUID a Tenjin.
2. Añadir Xsolla como canal publicitario.
3. Configurar una devolución de llamada.

Transmisión de CUID

Configure la transferencia de CUID desde su aplicación móvil a Tenjin llamando al método setCustomerUserId:

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

Añadir Xsolla como canal

1. Inicie sesión en su cuenta de Tenjin.
2. Vaya a la sección Configure > Channels.
3. Haga clic en Add a channel.

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

6. Haga clic en Add ad account.

Configuración de devolución de llamada

1. Inicie sesión en su cuenta de Tenjin.
2. Vaya a la sección Configure > Channels.
3. Abra la página de la aplicación correspondiente.
4. Vaya a la pestaña Callbacks.
5. En la lista desplegable de canales publicitarios, seleccione Xsolla.

6. En la sección Channel callbacks, haga clic en Add events y seleccione Xsolla login.

7. En la ventana modal, seleccione el evento que contiene CUID y haga clic en Save.

Estructura de valores de eventos

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 Tenjin. 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: