Integración con AppsFlyer

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

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 AppsFlyer 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 AF as AppsFlyer
    U->>WSP: Pulsa en el banner
    WSP->>WS: Redirige con los parámetros de la URL
    WS->>AF: Envía un evento de carga
    U->>WS: Inicia sesión con CUID
    WS->>AF: Envía un evento de identificación
    U->>WS: Realiza una compra
    WS->>AF: Envía un evento de compra

1. El usuario hace clic en el banner de la campaña publicitaria.
2. Se redirige al usuario a la Web Shop y la URL de esta transición incluye los parámetros de AppsFlyer, que especifica desde qué banner y sitio web se dirigió al usuario.
3. Un evento sobre la visita se envía desde el lado del cliente de la Web Shop a AppsFlyer.
4. El usuario inicia sesión en Web Shop mediante un CUID.
5. El evento de autorización se envía a AppsFlyer.
6. El usuario realiza una compra en Web Shop.
7. El evento de compra se envía a AppsFlyer.

Cómo se establece en AppsFlyer

Antes de comenzar, configure los siguientes ajustes en la plataforma AppsFlyer:

1. Agregue una aplicación:
   1. Pulse en Add app.
   2. Seleccione de la lista la plataforma Web (PBA).
   3. Especifique el dominio de su Web Shop, p. ej. https://www.webshop.example.com/, como una URL de aplicación.
   4. Especifique un nombre de aplicación, p. ej., Xsolla.
   5. Pulse en Add my app.

2. Agregue un lote:
   1. Haga clic en Add bundle.
   2. Especifique Xsolla-bundle como un nombre.
   3. En la lista de aplicaciones web, seleccione Xsolla que agregó previamente.
   4. Haga clic en Create bundle.

1. Abra su proyecto en Cuenta del editor.
2. Vaya al creador de sitios utilizando uno de los siguientes métodos:
   • En el menú lateral, haga clic en Storefronts > Websites.
   • En el menú lateral, haga clic en Integrations. En la sección que se abre:
     1. Haga clic en el panel AppsFlyer.
     2. En el panel Web SDK (Site Builder), haga clic en Configure.

3. Seleccione su sitio web y haga clic en En la barra lateral haga clic en Configure.
4. En la pestaña Site settings, vaya a la sección Apps.
5. En el panel AppsFlyer, haga clic en Connect.

1. Abra su proyecto en su cuenta.
2. Vaya al creador de sitios utilizando uno de los siguientes métodos:
   • En el menú lateral, haga clic en Storefronts > Websites.
   • En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
     1. Haga clic en el panel AppsFlyer.
     2. En el panel Web SDK (Site Builder), haga clic en Configure.

3. Seleccione su sitio web y haga clic en En la barra lateral haga clic en Configure.
4. En la pestaña Site settings, vaya a la sección Apps.
5. En el panel AppsFlyer, haga clic en Connect.

1. Abra su proyecto en su cuenta.
2. Vaya al creador de sitios utilizando uno de los siguientes métodos:
   • En el menú lateral, haga clic en Storefronts > Websites.
   • En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
     1. Haga clic en el panel AppsFlyer.
     2. En el panel Web SDK (Site Builder), haga clic en Configure.

3. Seleccione su sitio web y haga clic en En la barra lateral haga clic en Configure.
4. En la pestaña Site settings, vaya a la sección Apps.
5. En el panel AppsFlyer, haga clic en Connect.

1. Abra su proyecto en su cuenta.
2. Vaya al creador de sitios utilizando uno de los siguientes métodos:
   • En el menú lateral, haga clic en Storefronts > Websites.
   • En el menú lateral, haga clic en Other tools > Integrations. En la sección que se abre:
     1. Haga clic en el panel AppsFlyer.
     2. En el panel Web SDK (Site Builder), haga clic en Configure.

3. Seleccione su sitio web y haga clic en En la barra lateral haga clic en Configure.
4. En la pestaña Site settings, vaya a la sección Apps.
5. En el panel AppsFlyer, haga clic en Connect.

1. Abra su proyecto en la cuenta para juegos en móviles.
2. Vaya al creador de sitios utilizando uno de estos métodos:
   • En el menú lateral, haga clic en Web Shop.
   • En el menú lateral, haga clic en Operations > MMP. En la sección que se abre:
     1. Haga clic en el panel AppsFlyer.
     2. En el panel Web SDK (Site Builder), haga clic en Configure.

3. En el panel de su sitio web, haga clic en el icono ⋮ y seleccione Configure.
4. En la pestaña Site settings, vaya a la sección Apps.
5. En el panel de AppsFlyer, haga clic en Connect.

6. En el campo AppsFlyer Dev Key, introduzca la clave de desarrollador. Encontrará estos datos en su cuenta de AppsFlyer:
   1. Acceda a la sección My Apps.
   2. Haga clic en View brand bundles.
   3. En la línea del lote de marca Xsolla-bundle, haga clic en el icono de copia en la columna Web dev key.
7. Haga clic en Connect.

Para obtener información sobre los eventos en su cuenta de AppsFlyer:

1. Vaya a la sección My Apps.
2. En la sección Available Apps, elija la app de Xsolla y haga clic en View in PBA.

También puede ver los eventos analíticos en la sección Dashboards > People-Based Attribution.

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

• dispone de con una aplicación móvil en la plataforma Android/iOS
• utiliza la plataforma de medición AppsFlyer
• utiliza la solución de Web Shop para vender artículos dentro del juego

Los siguientes eventos están disponibles mediante la integración de Xsolla con AppsFlyer S2S:

Cómo funciona

La integración incorpora el flujo de datos bidireccional entre Xsolla y AppsFlyer. Más abajo se presenta el escenario de interacción del sistema cuando un usuario realiza una compra.

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

1. El usuario (jugador del juego) se registra o inicia sesión en la aplicación móvil Android/iOS.
2. Su aplicación envía un evento interno de la app estándar a AppsFlyer: af_login, af_signup o cualquier evento que contenga un CUID.
3. AppsFlyer envía una postback (devolución) a Xsolla, que incluye un ID de aplicación, un ID de AppsFlyer y un CUID.
4. El usuario inicia sesión en Web Shop mediante un CUID.
5. El usuario realiza una compra en Web Shop.
6. El evento de compra se envía al back-end de Xsolla y coincide con la información recibida de AppsFlyer.
7. El back-end de Xsolla envía un evento S2S interno de la aplicación a AppsFlyer que contiene el ID de AppsFlyer y el CUID.

AppsFlyer asigna este 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.

2. Haga clic en el panel de AppsFlyer.

3. En el panel Mobile app S2S integration, haga clic en Configure.

4. En la ventana que aparece, introduzca los siguientes datos:
   1. Token S2S de AppsFlyer.
   2. ID de aplicación para plataformas de publicación Android/iOS en el siguiente formato:
      • iOS: idXXXXXXXXX
      • Android: com.example.yourapp
      Para añadir una plataforma, haga clic en Add application ID.
5. Haga clic en Save.

Tras guardar, se activará el conmutador del panel de AppsFlyer.

Para implementar cambios en la integración conectada:

1. Haga clic en el panel de AppsFlyer.
2. En la ventana que se muestra, haga los cambios necesarios.
3. Haga clic en Save.

Cómo se establece en AppsFlyer

In AppsFlyer, tiene que:

1. Obtener un token S2S.
2. Activar la integración con Xsolla.

Obtener un token S2S

Para recuperar el token S2S:

1. Inicie sesión en su cuenta de AppsFlyer HQ.
2. Vaya a la sección Account > Security Center > AppsFlyer API and S2S tokens.
3. En la línea en la que aparezca el token S2S, pulse en el icono de copia de la columna Token.

Si no tiene todavía el token S2S, cree uno.

Activación de la integración con Xsolla

1. En su cuenta de AppsFlyer HQ, seleccione la aplicación de Android/iOS y vaya a la sección Collaborate > Partner marketplace.

2. Busque y seleccione Xsolla en la barra de búsqueda.

3. Haga clic en Set up integration.

4. En la pestaña de integración:
   1. Active el conmutador Activate Partner.
   2. Solamente para las aplicaciones de iOS: establezca el conmutador Advanced Privacy en consonancia con su política de privacidad:
      • On: todos los eventos se envían a Xsolla
      • Off: solo los eventos autorizados por ATT se envían a Xsolla

1. 3. Deje los valores de postbacks (devoluciones) predeterminadas — off (por defecto).
   4. Active el conmutador In-app event postbacks.
   5. Configure al menos un evento interno de la app que incluya la información de inicio de sesión (CUID).
   6. Introduzca cualquier valor en el campo mapped to partner event (evento asignado al socio). Xsolla admite cualquier nombre de evento.
   7. Guarde la integración.

Puede obtener más información sobre la configuración de la integración en el servidor de AppsFlyer en la documentación.

Estructura de valores del evento

Si desea establecer un evento específico o si las capacidades de integración actuales no cubren sus necesidades, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].

Compra de artículos

Cuando un usuario compra en la Web Shop, Xsolla envía el evento xsolla-billing-payment a AppsFlyer.

Parámetros principales

Parámetros adicionales

Estos parámetros no se muestran en los informes agregados ni en los paneles de control, y solo están disponibles al exportar los datos sin procesar:

Ejemplo de evento con código de artículo (SKU) único:

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Ejemplo de evento con códigos de artículo (SKU) múltiples:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Reembolso

Cuando un usuario inicia el reembolso de un pago, Xsolla envía el evento xsolla-billing-refund a AppsFlyer.

Parámetros principales

Parámetros adicionales

Estos parámetros no se muestran en los informes agregados ni en los paneles de control, y solo están disponibles al exportar los datos sin procesar:

Ejemplo de evento con códigos de artículo (SKU) múltiples:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Creación de facturas

Cuando se crea en el sistema de Xsolla una factura por la compra de un artículo para la Web Shop, Xsolla envía el evento xsolla-billing-created a AppsFlyer.

Parámetros principales

Parámetros adicionales

Estos parámetros no se muestran en los informes agregados ni en los paneles de control, y solo están disponibles al exportar los datos sin procesar:

Ejemplo de evento con códigos de artículo (SKU) múltiples:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Error de pago

Cuando se produce un error de pago durante una compra en la Web Shop, Xsolla envía el evento xsolla-billing-error a AppsFlyer. Los parámetros del evento contienen la siguiente información:

Parámetros principales

Parámetros adicionales

Estos parámetros no se muestran en los informes agregados ni en los paneles de control, y solo están disponibles al exportar los datos sin procesar:

Ejemplo de evento con códigos de artículo (SKU) múltiples:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}