Amplitude

Amplitude, güçlü bir mobil analitik hizmetidir. Adapty sayesinde etkinlikleri kolayca Amplitude’a gönderebilir, kullanıcıların nasıl davrandığını görebilir ve daha akıllı kararlar alabilirsiniz. Adapty, mağazalardan gelen abonelik olaylarını tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar ve bunu Amplitude hesabınıza gönderir. Bu sayede kullanıcı davranışlarını ödeme geçmişleriyle Amplitude’da eşleştirebilir ve ürün kararlarınızı daha sağlıklı verebilirsiniz.

Amplitude entegrasyonu nasıl kurulur

Adapty’de, Apple veya Stripe sandbox ortamından ya da Google test hesabından gelen production ve test event’leri için ayrı akışlar kurabilirsiniz.

• Production event’leri için, Amplitude kontrol panelindeki Production API anahtarlarını girin. iOS, Android ve Stripe için ayrı birer API anahtarı kullanılır.
• Test event’leri için ise gerektiğinde Sandbox alanlarını doldurun.

Amplitude entegrasyonunu kurmak için:

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

2. Amplitude integration seçeneğini açın.

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 belgelerine bakın. Test için önce Sandbox anahtarlarıyla başlayın, ardından testler başarılı olunca 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 gelir mi yoksa vergi ve komisyonlar düşüldükten sonraki gelir mi gönderileceğini 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ı hariç tutarak veri tekrarını önleyin. Örneğin, bir kullanıcı 10 Ocak’ta abone olmuş ancak Adapty SDK’yı 6 Mart’ta yüklemişse, 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 değerini otomatik olarak amplitudeDeviceId olarak gönderir. user_id için bu ayar şu şekilde davranır:

   • ON: amplitudeUserId veya customer_user_id mevcut değilse Adapty profile_id gönderilir.
   • OFF: Hiçbir kimlik mevcut değilse user_id boş bırakılır.
   |

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

6. Değişikliklerinizi onaylamak için Save düğmesine tıklayın.

Save düğmesine tıkladıktan sonra Adapty, Amplitude’e etkinlik göndermeye başlayacaktır.

Adapty, etkinliklere ek olarak abonelik durumunu ve abonelik ürün kimliğini Amplitude kullanıcı özelliklerine gönderir.

Etkinlikler ve etiketler

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

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

SDK yapılandırması

Entegrasyonu kurmak için setIntegrationIdentifier() metodunu kullanarak amplitude_device_id parametresini ayarlayın. Bu adım zorunludur.

Kullanıcı kaydınız varsa, amplitude_user_id değerini 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 olay yapısı

Adapty, olayları Amplitude’e HTTP API v2 üzerinden 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"
      }
    }
  ]
}

The input appears to be incomplete — “Where:” is not a documentation fragment I can translate meaningfully. Please provide the full MDX content you’d like translated from English to Turkish.