Amplitude

Amplitude, güçlü bir mobil analiz hizmetidir. Adapty ile Amplitude’e kolayca event gönderebilir, kullanıcıların nasıl davrandığını görebilir ve akıllı kararlar alabilirsiniz.

Adapty, mağazalardan gelen abonelik eventlerini tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar ve bunu Amplitude hesabınıza iletir. Bu sayede kullanıcı davranışlarını Amplitude’deki ödeme geçmişleriyle eşleştirerek ürün kararlarınızı daha sağlam temellere oturtabilirsiniz.

Amplitude entegrasyonu nasıl kurulur

Adapty’de Apple veya Stripe sandbox ortamından ya da Google test hesabından gelen production ve test eventleri için ayrı akışlar oluşturabilirsiniz.

• Production eventleri için Amplitude kontrol panelindeki Production API anahtarlarını girin; iOS, Android ve Stripe için ayrı birer API anahtarı kullanın.
• Test eventleri için gerektiğinde Sandbox alanlarını kullanın.

Amplitude entegrasyonunu kurmak için:

1. Adapty Kontrol Paneli’nde Integrations -> Amplitude sayfasını açın.

2. Amplitude integration seçeneğini açık konuma getirerek etkinleştirin.

3. Entegrasyon alanlarını doldurun:

   Alan	Açıklama
   Amplitude iOS/ Android/ Stripe API key	iOS/ Android/ Stripe için Amplitude API Key’ini Adapty’ye girin. Amplitude’de Project settings bölümünden bulabilirsiniz. Yardım için Amplitude belgelerine bakın. Önce test için Sandbox anahtarlarıyla başlayın, testler başarılı olduktan sonra Production anahtarlarına geçin.

   

4. Daha fazla özelleştirme için isteğe bağlı ayarlar:

   Parametre	Açıklama
   How the revenue data should be sent	Brüt geliri mi yoksa vergi ve komisyon düşüldükten sonraki geliri mi göndereceğinizi seçin. Ayrıntılar için Mağaza komisyonu ve vergiler bölümüne bakın.
   Exclude historical events	Adapty SDK kurulumundan önceki eventleri hariç tutarak yinelenen verileri önleyin. Örneğin, bir kullanıcı 10 Ocak’ta abone olmuş ancak Adapty SDK’yı 6 Mart’ta kurmuşsa Adapty yalnızca 6 Mart’tan itibaren olan eventleri gönderir.
   Send User Attributes	Dil tercihleri gibi kullanıcıya özgü nitelikleri göndermek için bu seçeneği işaretleyin.
   Always populate user_id	Adapty, device_id’yi otomatik olarak amplitudeDeviceId olarak gönderir. user_id için bu ayar şu davranışı belirler: ON: amplitudeUserId veya customer_user_id mevcut değilse Adapty profile_id’sini gönderir. OFF: Hiçbir ID mevcut değilse user_id boş bırakılır.

5. Almak istediğiniz eventleri seçin ve isimlerini eşleştirin.

6. Değişikliklerinizi kaydetmek için Save’e tıklayın.

Save’e tıkladıktan sonra Adapty, Amplitude’e event göndermeye başlar.

Eventlere ek olarak Adapty, abonelik durumunu ve abonelik ürün ID’sini Amplitude kullanıcı özelliklerine gönderir.

Eventler ve etiketler

Kimlik bilgilerinin altında, Adapty’den Amplitude’e gönderebileceğiniz üç grup event bulunur. İhtiyacınız olanları açmanız yeterli. Adapty’nin sunduğu eventlerin tam listesine buradan ulaşabilirsiniz.

Adapty’nin sunduğu varsayılan event isimlerini kullanmanızı öneririz. Ancak ihtiyaçlarınıza göre event isimlerini değiştirebilirsiniz. Adapty, abonelik eventlerini sunucudan sunucuya entegrasyon aracılığıyla Amplitude’e gönderir; böylece tüm abonelik eventlerini Amplitude kontrol panelinizde görüntüleyebilirsiniz.

SDK yapılandırması

amplitude_device_id parametresini ayarlamak için setIntegrationIdentifier() metodunu kullanın. Bu, entegrasyonu kurmanın zorunlu bir adımıdır.

Kullanıcı kaydınız varsa amplitude_user_id parametresini de iletebilirsiniz.

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

Amplitude event yapısı

Adapty, eventleri Amplitude’e HTTP API v2 aracılığıyla gönderir. Her event şu şekilde yapılandırılmıştır:

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

Parametreler: