AppMetrica

AppMetrica, kullanıcı davranışını izlemenize ve mobil uygulamanızın performansını gerçek zamanlı olarak analiz etmenize yardımcı olan ücretsiz bir analitik aracıdır. AppMetrica’yı Adapty ile entegre ederek abonelik metrikleriniz ve kullanıcı etkileşiminiz hakkında daha derin içgörüler elde edebilirsiniz.

AppMetrica entegrasyonu nasıl kurulur

AppMetrica entegrasyonunu kurmak iki ana adımdan oluşur:

1. Adapty Kontrol Paneli’nde entegrasyonu yapılandırın
2. Uygulama kodunuzda entegrasyonu ayarlayın

Kontrol paneli yapılandırması

AppMetrica entegrasyonunu kurmak için:

1. AppMetrica uygulamalar listesini açın
2. İzlemek istediğiniz uygulamayı seçin
3. Settings > Main bölümüne gidin ve Application ID ile Post API key değerlerini kopyalayın

4. Adapty Kontrol Paneli’nde Integrations > AppMetrica sayfasına gidin
5. AppMetrica kimlik bilgilerinizi yapıştırın.

Etkinlikler ve etiketler

Adapty, AppMetrica’ya üç grup etkinlik göndermenize olanak tanır. Uygulamanızın performansını izlemek için ihtiyaç duyduğunuz etkinlikleri etkinleştirebilirsiniz. Mevcut etkinliklerin tam listesi için etkinlikler belgelerimize bakın.

Gelir ayarları

Adapty varsayılan olarak gelir verilerini etkinliklerdeki özellikler olarak gönderir; bu veriler AppMetrica’nın Etkinlikler raporunda görünür. Bu gelir verilerinin nasıl hesaplanıp görüntüleneceğini yapılandırabilirsiniz:

• Gelir hesaplama: Finansal raporlama ihtiyaçlarınıza uygun gelir değerlerinin nasıl hesaplanacağını seçin:

  • Brüt gelir: Herhangi bir kesinti yapılmadan önceki toplam geliri gösterir; müşterilerin ödediği tam tutarı izlemek için kullanışlıdır
  • Mağaza komisyonu sonrası gelir: App Store/Play Store ücretleri düşüldükten sonraki geliri gösterir; gerçek kazançlarınızı izlemenize yardımcı olur
  • Mağaza komisyonu ve vergiler sonrası gelir: Hem mağaza ücretleri hem de geçerli vergiler düşüldükten sonraki net geliri gösterir; kazançlarınızın en doğru görünümünü sunar

• Kullanıcının para birimini raporla: Etkinleştirildiğinde, satışlar kullanıcının yerel para biriminde raporlanır; bu da bölgeye göre geliri analiz etmeyi kolaylaştırır. Devre dışı bırakıldığında, farklı pazarlarda tutarlı raporlama için tüm satışlar USD’ye dönüştürülür.

• Gelir etkinliklerini gönder: Bu seçeneği etkinleştirerek gelir verilerinin yalnızca Etkinlikler raporunda değil, aynı zamanda AppMetrica’nın Uygulama içi ve reklam geliri raporunda da görünmesini sağlayabilirsiniz. Başka bir yerden de gelir göndermediğinizden emin olun; aksi takdirde veri tekrarına yol açabilir.

• Geçmiş etkinlikleri hariç tut: Etkinleştirildiğinde, Adapty kullanıcının uygulamayı Adapty SDK ile yüklemesinden önce gerçekleşen etkinlikleri göndermez. Adapty’yi entegre etmeden önce zaten analitiğe etkinlik gönderiyorsanız bu, veri tekrarını önlemeye yardımcı olur.

SDK yapılandırması

Uygulamanızda AppMetrica entegrasyonunu etkinleştirmek için iki tanımlayıcı ayarlamanız gerekir:

1. appmetrica_device_id: Temel entegrasyon için zorunludur
2. appmetrica_profile_id: İsteğe bağlıdır, ancak uygulamanızda kullanıcı kaydı varsa önerilir

Bu değerleri ayarlamak için setIntegrationIdentifier() metodunu kullanın. Her platform için nasıl uygulayacağınız aşağıda açıklanmıştır:

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`
}

AppMetrica etkinlik yapısı

Adapty, etkinlikleri AppMetrica’ya sorgu parametreleri olarak POST istekleri aracılığıyla gönderir. Her Adapty etkinliği için AppMetrica iki ayrı istek alır:

1. Profil etkinliği (her zaman gönderilir): Etkinlik meta verilerini içerir
2. Gelir etkinliği (isteğe bağlı): Adapty Kontrol Paneli’nde “Gelir etkinliklerini gönder” seçeneği etkinleştirilmişse gelir verilerini içerir

Profil Etkinliği İsteği

Gönderildiği adres: https://api.appmetrica.yandex.ru/logs/v1/import/events

Sorgu parametreli örnek URL:

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

Sorgu parametreleri:

Gelir Etkinliği İsteği (İsteğe Bağlı)

Gönderildiği adres: https://api.appmetrica.yandex.ru/logs/v1/import/revenue

Bu istek yalnızca Adapty Kontrol Paneli entegrasyon ayarlarında “Gelir etkinliklerini gönder” seçeneği etkinleştirildiğinde gönderilir.

Sorgu parametreli örnek URL:

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

Sorgu parametreleri: