Mixpanel

Mixpanel es un potente servicio de análisis de productos. Su solución de seguimiento basada en eventos permite a los equipos de producto obtener información valiosa sobre las mejores estrategias de adquisición, conversión y retención de usuarios en distintas plataformas. Esta integración te permite llevar todos los eventos de Adapty a Mixpanel. Como resultado, obtendrás una visión más completa de tu negocio de suscripciones y las acciones de tus clientes. Adapty ofrece un conjunto completo de datos que te permite rastrear eventos de suscripción de los stores en un solo lugar. Con Adapty, puedes ver fácilmente cómo se comportan tus suscriptores, conocer sus preferencias y usar esa información para comunicarte con ellos de forma dirigida y efectiva.

Cómo configurar la integración con Mixpanel

1. Abre la página Integrations -> Mixpanel en el Adapty Dashboard.
2. Activa el interruptor e introduce tu Mixpanel Token. Puedes especificar un token para todas las plataformas o limitarlo a plataformas concretas si solo quieres recibir datos de algunas de ellas.
3. Configura Mixpanel Data Residency para que coincida con tu proyecto de Mixpanel. Este campo es obligatorio y su valor predeterminado es US. Elige US para el endpoint api.mixpanel.com o Europe para api-eu.mixpanel.com.

Cómo encontrar tu token de Mixpanel

Para obtener tu Mixpanel Token:

1. Inicia sesión en tu Mixpanel Dashboard.
2. Abre Settings y selecciona Organization Settings.

3. En la barra lateral izquierda, ve a Projects y selecciona tu proyecto.

Cómo funciona la integración

Adapty mapea automáticamente las propiedades de evento relevantes —como el ID de usuario y los ingresos— a las propiedades nativas de Mixpanel. Esto garantiza un seguimiento e informes precisos de los eventos relacionados con suscripciones.

Además, Adapty acumula datos de ingresos por usuario y actualiza sus Propiedades de Perfil de Usuario, incluidas subscription state y subscription product ID. Una vez recibido un evento, Mixpanel actualiza los campos correspondientes en tiempo real.

Eventos y etiquetas

Debajo de las credenciales, hay tres grupos de eventos que puedes enviar a Mixpanel desde Adapty. Simplemente activa los que necesites. Consulta la lista completa de eventos que ofrece Adapty aquí.

Recomendamos usar los nombres de evento predeterminados que ofrece Adapty. Pero puedes cambiarlos según tus necesidades.

Configuración del SDK

Usa el método .setIntegrationIdentifier() para configurar mixpanelUserId. Si no se establece, Adapty usa tu ID de usuario (customerUserId) o, si es nulo, el ID de Adapty. Asegúrate de que el ID de usuario que usas para enviar datos a Mixpanel desde tu app sea el mismo que envías a Adapty.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: Mixpanel.mainInstance().distinctId
    )
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
            .with(mixpanelUserId: Mixpanel.mainInstance().distinctId)

Adapty.updateProfile(params: builder.build())

Adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelAPI.distinctId) { error ->
    if (error != null) {
        // handle the error
    }
}

final mixpanel = await Mixpanel.init("Your Token", trackAutomaticEvents: true);
final distinctId = await mixpanel.getDistinctId();

try {
    await Adapty().setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: distinctId,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

var distinctId = Mixpanel.DistinctId;

if (distinctId != null) {
  Adapty.SetIntegrationIdentifier(
    "mixpanel_user_id",
    distinctId,
    (error) => {
    // handle the error
  });
}

// Si ya tienes una instancia compartida de Mixpanel en tu app, úsala en su lugar.
const trackAutomaticEvents = true;
const mixpanel = new Mixpanel('YOUR_PROJECT_TOKEN', trackAutomaticEvents);
await mixpanel.init();

// Este es el distinct_id actual de Mixpanel (generado automáticamente, o establecido mediante mixpanel.identify(...))
const mixpanelUserId = await mixpanel.getDistinctId();

try {
    await adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelUserId);
} catch (error) {
    // maneja `AdaptyError`
}

Estructura de eventos de Mixpanel

Adapty envía eventos a Mixpanel usando el método track. Las propiedades del evento tienen esta estructura:

{
  "event": "subscription_renewed",
  "properties": {
    "ip": 0,
    "time": 1709294400,
    "$insert_id": "123e4567-e89b-12d3-a456-426614174000",
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383...",
    "currency": "USD",
    "environment": "Production",
    "store": "app_store",
    "purchase_date": "2024-03-01T12:00:00.000000+0000"
  }
}

Donde:

Actualizaciones del perfil de usuario

Adapty también actualiza el Perfil de Usuario de Mixpanel usando people_set con las siguientes propiedades: