AppMetrica

AppMetrica est un outil d’analyse gratuit qui vous permet de suivre le comportement des utilisateurs et d’analyser les performances de votre application mobile en temps réel. En intégrant AppMetrica avec Adapty, vous obtenez une vision plus approfondie de vos métriques d’abonnement et de l’engagement de vos utilisateurs.

Comment configurer l’intégration AppMetrica

La configuration de l’intégration AppMetrica comprend deux étapes principales :

1. Configurer l’intégration dans l’Adapty Dashboard
2. Mettre en place l’intégration dans le code de votre application

Configuration du tableau de bord

Pour configurer l’intégration AppMetrica :

1. Ouvrez la liste des applications AppMetrica
2. Sélectionnez l’application que vous souhaitez suivre
3. Allez dans Settings > Main et copiez l’Application ID et la Post API key

4. Rendez-vous dans Integrations > AppMetrica dans l’Adapty Dashboard
5. Collez vos identifiants AppMetrica.

Événements et tags

Adapty vous permet d’envoyer trois groupes d’événements à AppMetrica. Vous pouvez activer les événements dont vous avez besoin pour suivre les performances de votre application. Pour la liste complète des événements disponibles, consultez notre documentation sur les événements.

Paramètres de revenus

Par défaut, Adapty envoie les données de revenus sous forme de propriétés dans les événements, qui apparaissent dans le rapport Événements d’AppMetrica. Vous pouvez configurer la façon dont ces données de revenus sont calculées et affichées :

• Calcul des revenus : Choisissez comment les valeurs de revenus sont calculées pour correspondre à vos besoins de reporting financier :

  • Revenus bruts : Affiche le total des revenus avant toute déduction, utile pour suivre le montant total payé par les clients
  • Recettes après commission du store : Affiche les revenus après déduction des frais de l’App Store/Play Store, pour suivre vos gains réels
  • Recettes après commission du store et taxes : Affiche les revenus nets après déduction des frais du store et des taxes applicables, offrant la vision la plus précise de vos gains

• Report user’s currency : lorsque cette option est activée, les ventes sont rapportées dans la devise locale de l’utilisateur, ce qui facilite l’analyse des revenus par région. Lorsqu’elle est désactivée, toutes les ventes sont converties en USD pour un reporting cohérent sur l’ensemble des marchés.

• Send revenue events : activez cette option pour que les données de revenus apparaissent non seulement dans le rapport Événements, mais aussi dans le rapport In-app and ad revenue d’AppMetrica. Assurez-vous de ne pas envoyer des données de revenus depuis un autre endroit, car cela pourrait entraîner des doublons.

• Exclude historical events : Lorsque cette option est activée, Adapty n’envoie pas les événements survenus avant l’installation de l’app avec le SDK Adapty. Cela permet d’éviter les doublons si vous envoyiez déjà des événements à votre outil d’analyse avant d’intégrer Adapty.

Configuration du SDK

Pour activer l’intégration AppMetrica dans votre application, vous devez configurer deux identifiants :

1. appmetrica_device_id : Requis pour l’intégration de base
2. appmetrica_profile_id : Optionnel, mais recommandé si votre application dispose d’un système d’inscription utilisateur

Utilisez la méthode setIntegrationIdentifier() pour définir ces valeurs. Voici comment l’implémenter sur chaque plateforme :

AppMetrica.requestStartupIdentifiers(on: nil) { ids, error in
  if let error {
    // handle AppMetrica error    
    return
  }

  guard let deviceIDHash = ids?[.deviceIDHashKey] as? String else {
    // handle AppMetrica error
    return
  }

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

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

val startupParamsCallback = object: StartupParamsCallback {
    override fun onReceive(result: StartupParamsCallback.Result?) {
        val deviceIdHash = result?.deviceIdHash ?: return

        Adapty.setIntegrationIdentifier("appmetrica_device_id", deviceIdHash) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }

    override fun onRequestError(
        reason: StartupParamsCallback.Reason,
        result: StartupParamsCallback.Result?
    ) {
        //handle the error
    }
}

AppMetrica.requestStartupParams(context, startupParamsCallback, listOf(StartupParamsCallback.APPMETRICA_DEVICE_ID_HASH))

val startupParamsCallback = object: StartupParamsCallback {
    override fun onReceive(result: StartupParamsCallback.Result?) {
        val deviceIdHash = result?.deviceIdHash ?: return

        Adapty.setIntegrationIdentifier("appmetrica_device_id", deviceIdHash) { error ->
            if (error != null) {
                // handle the error
            }
        }
        
        Adapty.setIntegrationIdentifier("appmetrica_profile_id", "YOUR_ADAPTY_CUSTOMER_USER_ID") { error ->
            if (error != null) {
                // handle the error
            }
        }
    }

    override fun onRequestError(
        reason: StartupParamsCallback.Reason,
        result: StartupParamsCallback.Result?
    ) {
        //handle the error
    }
}

AppMetrica.requestStartupParams(context, startupParamsCallback, listOf(StartupParamsCallback.APPMETRICA_DEVICE_ID_HASH))

final startupParams = await AppMetrica.requestStartupParams([AppMetricaStartupParams.deviceIdHashKey]);
final deviceIdHash = startupParams.result?.deviceIdHash;

if (deviceIdHash != null) {
  try {
    await Adapty().setIntegrationIdentifier(
        key: "appmetrica_device_id", 
        value: deviceIdHash,
    );
  } on AdaptyError catch (adaptyError) {
    // handle the error
  } catch (e) {
    // handle the error
  }
}

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

using AdaptySDK;
using Io.AppMetrica;

AppMetrica.RequestStartupParams(
    (result, errorReason) => {
        string deviceIdHash = result.DeviceIdHash;

        if (deviceIdHash != null) {
            Adapty.SetIntegrationIdentifier(
                "appmetrica_device_id",
                deviceIdHash,
                (error) => {
                    // handle the error
                });
          }
      },
      new List<string>() { StartupParamsKey.AppMetricaDeviceIDHash }
);

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

// ...
const startupParamsCallback = async (
  params?: StartupParams,
  reason?: StartupParamsReason
) => {
  const deviceIdHash = params?.deviceIdHash
  if (deviceIdHash) {
    try {
      await adapty.setIntegrationIdentifier("appmetrica_device_id", deviceIdHash);
    } catch (error) {
      // handle `AdaptyError`
    }
  }
}

AppMetrica.requestStartupParams(startupParamsCallback, [DEVICE_ID_HASH_KEY])

try {
  await adapty.setIntegrationIdentifier("appmetrica_profile_id", 'YOUR_ADAPTY_CUSTOMER_USER_ID');
} catch (error) {
  // handle `AdaptyError`
}

Structure des événements AppMetrica

Adapty envoie des événements à AppMetrica via des requêtes POST avec des paramètres transmis en tant que paramètres de requête. Pour chaque événement Adapty, AppMetrica reçoit jusqu’à deux requêtes distinctes :

1. Événement de profil (toujours envoyé) : contient les métadonnées de l’événement
2. Événement de revenus (optionnel) : contient les données de revenus si l’option « Send revenue events » est activée dans le Adapty Dashboard

Requête d’événement de profil

Envoyée à : https://api.appmetrica.yandex.ru/logs/v1/import/events

Exemple d’URL avec paramètres de requête :

POST https://api.appmetrica.yandex.ru/logs/v1/import/events?post_api_key=your_key&application_id=your_app_id&event_name=subscription_renewed&event_timestamp=1709294400&event_json=%7B%22vendor_product_id%22%3A%22yearly.premium%22...%7D&os_name=ios&ios_ifa=00000000-0000-0000-0000-000000000000&ios_ifv=12345678-1234-1234-1234-123456789012&profile_id=user_12345&session_type=foreground

Paramètres de requête :

Requête d’événement de revenu (Optionnelle)

Envoyée vers : https://api.appmetrica.yandex.ru/logs/v1/import/revenue

Cette requête n’est envoyée que lorsque l’option « Send revenue events » est activée dans les paramètres d’intégration de votre Adapty Dashboard.

Exemple d’URL avec paramètres de requête :

POST https://api.appmetrica.yandex.ru/logs/v1/import/revenue?post_api_key=your_key&application_id=your_app_id&revenue_event_type=subscription_renewed&price=9.99&currency=USD&product_id=yearly.premium&quantity=1&transaction_id=GPA.3383...&payload=%7B%22vendor_product_id%22%3A%22yearly.premium%22...%7D&os_name=ios&ios_ifa=00000000-0000-0000-0000-000000000000&profile_id=user_12345&session_type=foreground

Paramètres de requête :

Dépannage

access_level_updated s’affiche 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.