Amplitude

Amplitude es un potente servicio de análisis móvil. Con Adapty, puedes enviar eventos a Amplitude fácilmente, ver cómo se comportan tus usuarios y tomar decisiones más inteligentes.

Adapty proporciona un conjunto completo de datos que te permite hacer seguimiento de eventos de suscripción desde los stores en un solo lugar y los envía a tu cuenta de Amplitude. Esto te permite relacionar el comportamiento de tus usuarios con su historial de pagos en Amplitude, y así tomar mejores decisiones de producto.

Cómo configurar la integración con Amplitude

En Adapty puedes configurar flujos separados para eventos de producción y de prueba provenientes del entorno sandbox de Apple o Stripe, o de una cuenta de prueba de Google.

• Para eventos de producción, introduce las claves API de Production desde el dashboard de Amplitude, con una clave API única para cada plataforma: iOS, Android y Stripe.
• Para eventos de prueba, usa los campos de Sandbox según sea necesario.

Para configurar la integración con Amplitude:

1. Abre Integrations -> Amplitude en tu Adapty Dashboard.

2. Activa Amplitude integration para habilitarla.

3. Rellena los campos de la integración:

   Campo	Descripción
   Amplitude iOS/ Android/ Stripe API key	Introduce la API Key de Amplitude para iOS/ Android/ Stripe en Adapty. Encuéntrala en Project settings dentro de Amplitude. Para más ayuda, consulta la documentación de Amplitude. Comienza con las claves de Sandbox para pruebas y luego cambia a las claves de Production tras pruebas exitosas.

   

4. Ajustes opcionales para mayor personalización:

   Parámetro	Descripción
   How the revenue data should be sent	Elige si enviar los ingresos brutos o los ingresos después de impuestos y comisiones. Consulta Comisión del store e impuestos para más detalles.
   Exclude historical events	Elige excluir los eventos anteriores a la instalación del SDK de Adapty para evitar datos duplicados. Por ejemplo, si un usuario se suscribió el 10 de enero pero instaló el SDK de Adapty el 6 de marzo, Adapty solo enviará eventos a partir del 6 de marzo.
   Send User Attributes	Selecciona esta opción para enviar atributos específicos del usuario, como preferencias de idioma.
   Always populate user_id	Adapty envía automáticamente device_id como amplitudeDeviceId. Para user_id, esta configuración define el comportamiento: ON: Envía el profile_id de Adapty si amplitudeUserId o customer_user_id no están disponibles. OFF: Deja user_id vacío si ninguno de los IDs está disponible.

5. Elige los eventos que deseas recibir y asigna sus nombres.

6. Haz clic en Save para confirmar los cambios.

Una vez que hagas clic en Save, Adapty comenzará a enviar eventos a Amplitude.

Además de los eventos, Adapty envía el estado de la suscripción y el ID del producto de suscripción a las propiedades de usuario de Amplitude.

Eventos y etiquetas

Debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a Amplitude desde Adapty. Simplemente activa los que necesites. Consulta la lista completa de eventos disponibles en Adapty aquí.

Recomendamos usar los nombres de eventos predeterminados que proporciona Adapty. No obstante, puedes cambiarlos según tus necesidades. Adapty enviará los eventos de suscripción a Amplitude mediante una integración servidor a servidor, lo que te permitirá ver todos los eventos de suscripción en tu dashboard de Amplitude.

Configuración del SDK

Usa el método setIntegrationIdentifier() para establecer el parámetro amplitude_device_id. Es imprescindible configurarlo para que la integración funcione.

Si tienes registro de usuarios, también puedes pasar amplitude_user_id.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "amplitude_device_id", 
        value: Amplitude.instance().deviceId
    )
} catch {
    // handle the error
}

do {
    try await Adapty.setIntegrationIdentifier(
        key: "amplitude_user_id", 
        value: "YOUR_AMPLITUDE_USER_ID"
    )
} catch {
    // handle the error
}

//for Amplitude maintenance SDK (obsolete)
val amplitude = Amplitude.getInstance()
val amplitudeDeviceId = amplitude.getDeviceId()
val amplitudeUserId = amplitude.getUserId()

//for actual Amplitude Kotlin SDK
val amplitude = Amplitude(
    Configuration(
        apiKey = AMPLITUDE_API_KEY,
        context = applicationContext
    )
)
val amplitudeDeviceId = amplitude.store.deviceId

//

Adapty.setIntegrationIdentifier(AdaptyIntegrationIdentifier.amplitudeDeviceId(amplitudeDeviceId)) { error ->
    if (error != null) {
        // handle the error
    }
}

//for Amplitude maintenance SDK (obsolete)
val amplitude = Amplitude.getInstance()
val amplitudeDeviceId = amplitude.getDeviceId()
val amplitudeUserId = amplitude.getUserId()

//for actual Amplitude Kotlin SDK
val amplitude = Amplitude(
    Configuration(
        apiKey = AMPLITUDE_API_KEY,
        context = applicationContext
    )
)
val amplitudeUserId = amplitude.store.userId

//

Adapty.setIntegrationIdentifier(AdaptyIntegrationIdentifier.amplitudeUserId(amplitudeUserId)) { error ->
    if (error != null) {
        // handle the error
    }
}

final Amplitude amplitude = Amplitude.getInstance(instanceName: "YOUR_INSTANCE_NAME");

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

final Amplitude amplitude = Amplitude.getInstance(instanceName: "YOUR_INSTANCE_NAME");

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

using AdaptySDK;

Adapty.SetIntegrationIdentifier(
  "amplitude_device_id", 
  amplitude.getDeviceId(), 
  (error) => {
  // handle the error
});

using AdaptySDK;

Adapty.SetIntegrationIdentifier(
  "amplitude_user_id", 
  "YOUR_AMPLITUDE_USER_ID", 
  (error) => {
  // handle the error
});

try {
  await adapty.setIntegrationIdentifier("amplitude_device_id", deviceId);
} catch (error) {
  // handle `AdaptyError`
}

try {
  await adapty.setIntegrationIdentifier("amplitude_user_id", userId);
} catch (error) {
  // handle `AdaptyError`
}

Estructura del evento de Amplitude

Adapty envía eventos a Amplitude a través de la HTTP API v2. Cada evento tiene la siguiente estructura:

{
  "api_key": "your_amplitude_api_key",
  "events": [
    {
      "partner_id": "adapty",
      "event_type": "subscription_renewed",
      "time": 1709294400000,
      "insert_id": "123e4567-e89b-12d3-a456-426614174000",
      "user_id": "user_12345",
      "device_id": "device_12345",
      "platform": "iOS",
      "os_name": "iOS",
      "productId": "yearly.premium.6999",
      "revenue": 9.99,
      "event_properties": {
        "vendor_product_id": "yearly.premium.6999",
        "original_transaction_id": "GPA.3383...",
        "currency": "USD",
        "environment": "Production",
        "store": "app_store"
      },
      "user_properties": {
        "subscription_state": "subscribed",
        "subscription_product": "yearly.premium.6999"
      }
    }
  ]
}

Donde:

Solución de problemas

access_level_updated aparece como fallido en el Event Feed

access_level_updated es un evento exclusivo de webhooks. Adapty nunca lo envía a esta integración. Sin embargo, Adapty registra un resultado para cada integración habilitada, y un evento no compatible se muestra como un error.