Amplitude

Amplitude, güçlü bir mobil analitik hizmetidir. Adapty sayesinde olayları kolayca Amplitude’e gönderebilir, kullanıcı davranışlarını inceleyebilir ve bilinçli kararlar alabilirsiniz.

Adapty, mağazalardaki abonelik olaylarını tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar ve bu verileri Amplitude hesabınıza gönderir. Bu sayede kullanıcı davranışlarını Amplitude’deki ödeme geçmişiyle eşleştirerek ürün kararlarınızı daha iyi 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 olayları için ayrı flow’lar kurabilirsiniz.

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

Amplitude entegrasyonunu kurmak için:

1. Adapty Kontrol Paneli’nde Integrations -> Amplitude bölümünü açın.

2. Amplitude integration seçeneğini açık konuma getirerek entegrasyonu 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 altında bulabilirsiniz. Yardım için Amplitude dokümanlarına bakın. Teste başlamak için Sandbox anahtarlarını kullanı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	Gelir verilerini brüt olarak mı yoksa vergi ve komisyonlar düşüldükten sonra mı 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 olayları dışlamak için bu seçeneği etkinleştirin; böylece veri tekrarını önlemiş olursunuz. Örneğin, kullanıcı 10 Ocak’ta abone olmuş ancak Adapty SDK’yı 6 Mart’ta kurmuşsa, Adapty yalnızca 6 Mart’tan itibaren olan olayları 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 şekilde çalışır: ON: amplitudeUserId veya customer_user_id mevcut değilse Adapty profile_id’sini gönderir. OFF: Her iki ID de mevcut değilse user_id boş bırakılır.

5. Almak istediğiniz olayları 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, olayları Amplitude’e göndermeye başlayacaktır.

Adapty, olayların yanı sıra abonelik durumunu ve abonelik ürün ID’sini Amplitude kullanıcı özelliklerine gönderir.

Olaylar ve etiketler

Kimlik bilgilerinin altında, Adapty’den Amplitude’e gönderebileceğiniz üç grup olay yer almaktadır. İhtiyaç duyduklarınızı açık konuma getirmeniz yeterli. Adapty’nin sunduğu olayların tam listesine buradan ulaşabilirsiniz.

Adapty’nin sağladığı varsayılan olay adlarını kullanmanızı öneririz. Ancak olay adlarını ihtiyaçlarınıza göre değiştirebilirsiniz. Adapty, abonelik olaylarını sunucudan sunucuya entegrasyon aracılığıyla Amplitude’e gönderir; böylece tüm abonelik olaylarını Amplitude kontrol panelinde görüntüleyebilirsiniz.

SDK yapılandırması

amplitude_device_id parametresini ayarlamak için setIntegrationIdentifier() metodunu kullanın. Bu, entegrasyonun çalışması için zorunludur.

Kullanıcı kaydınız varsa amplitude_user_id’yi de aktarabilirsiniz.

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 olay yapısı

Adapty, olayları HTTP API v2 aracılığıyla Amplitude’e gönderir. Her olay ş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: