Amplitude

Amplitude est un puissant service d’analyse mobile. Avec Adapty, vous pouvez facilement envoyer des événements à Amplitude, observer le comportement de vos utilisateurs et prendre des décisions éclairées.

Adapty fournit un ensemble complet de données qui vous permet de suivre les événements d’abonnement depuis les stores en un seul endroit et de les envoyer à votre compte Amplitude. Cela vous permet de relier le comportement de vos utilisateurs à leur historique de paiement dans Amplitude, et d’orienter vos décisions produit.

Comment configurer l’intégration Amplitude

Dans Adapty, vous pouvez configurer des flows distincts pour les événements de production et les événements de test provenant de l’environnement sandbox d’Apple ou Stripe, ou d’un compte de test Google.

• Pour les événements de production, saisissez les clés API de Production depuis le tableau de bord Amplitude, avec une clé API unique pour chaque plateforme : iOS, Android et Stripe.
• Pour les événements de test, utilisez les champs Sandbox selon vos besoins.

Pour configurer l’intégration Amplitude :

1. Ouvrez Integrations -> Amplitude dans votre Adapty Dashboard.

2. Activez Amplitude integration pour l’activer.

3. Remplissez les champs de l’intégration :

   Field	Description
   Amplitude iOS/ Android/ Stripe API key	Saisissez la Clé API Amplitude pour iOS/ Android/ Stripe dans Adapty. Vous la trouverez sous Project settings dans Amplitude. Pour obtenir de l’aide, consultez la documentation Amplitude. Commencez avec les clés Sandbox pour les tests, puis passez aux clés de Production après des tests réussis.

   

4. Paramètres optionnels pour une personnalisation supplémentaire :

5. Choisissez les événements que vous souhaitez recevoir et associez leurs noms.

6. Cliquez sur Save pour confirmer vos modifications.

Une fois que vous avez cliqué sur Save, Adapty commencera à envoyer des événements à Amplitude.

En plus des événements, Adapty envoie le statut d’abonnement et l’ID du produit d’abonnement aux propriétés utilisateur Amplitude.

Événements et tags

Sous les identifiants, trois groupes d’événements peuvent être envoyés à Amplitude depuis Adapty. Activez simplement ceux dont vous avez besoin. Consultez la liste complète des événements proposés par Adapty ici.

Nous recommandons d’utiliser les noms d’événements par défaut fournis par Adapty. Vous pouvez toutefois les modifier selon vos besoins. Adapty enverra les événements d’abonnement à Amplitude via une intégration serveur à serveur, ce qui vous permettra de consulter tous les événements d’abonnement dans votre tableau de bord Amplitude.

Configuration du SDK

Utilisez la méthode setIntegrationIdentifier() pour définir le paramètre amplitude_device_id. C’est indispensable pour configurer l’intégration.

Si vous gérez l’inscription des utilisateurs, vous pouvez également passer 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("amplitude_device_id", 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("amplitude_user_id", 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`
}

Structure des événements Amplitude

Adapty envoie les événements à Amplitude via l’API HTTP v2. Chaque événement est structuré comme suit :

{
  "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"
      }
    }
  ]
}

Where:

Résolution des problèmes

access_level_updated apparaît comme échoué dans le journal d’événements

access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.