PostHog

PostHog, kullanıcı davranışını takip etmek, ürün kullanımını görselleştirmek ve retention analizi yapmak için araçlar sunan bir analitik platformdur. Etkinlik takibi, kullanıcı akışları ve özellik bayrakları gibi özellikleriyle ürününüzü daha iyi anlamanıza ve geliştirmenize yardımcı olmak için tasarlanmıştır. PostHog’u Adapty ile entegre etmek; deneme başlangıçları, yenilemeler ve iptaller gibi abonelikle ilgili olayları sorunsuz biçimde izlemenizi sağlar. Bu olayları PostHog’a göndererek abonelik değişikliklerinin kullanıcı davranışını nasıl etkilediğini analiz edebilir, paywall performansını değerlendirebilir ve mevcut analitik iş akışınız içinde monetizasyon stratejilerinize dair daha derin içgörüler elde edebilirsiniz.

Entegrasyon Özellikleri

Entegrasyon özelliği	Açıklama
Zamanlama	Gerçek zamanlı; etkinlikler PostHog kontrol panelinde hemen görünmeyebilir.
Veri yönü	Adapty etkinlikleri, Adapty sunucusundan PostHog sunucusuna gönderilir.
Adapty entegrasyon noktası	Mobil uygulama kodunda PostHog ve Adapty SDK’ları Adapty sunucusu

PostHog etkinlik yapısı

Adapty, seçilen etkinlikleri PostHog Entegrasyon sayfasındaki Events names bölümünde yapılandırıldığı şekilde PostHog’a gönderir. Her etkinlik şu yapıya sahiptir:

{
  "distinct_id": "[email protected]",
  "timestamp": "2025-01-08T11:06:12+00:00",
  "event": "subscription_started",
  "properties": {
    "$set": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe",
      "birthday": "1990-01-01",
      "gender": "male",
      "os": "iOS"
    },
    "timezone": "America/New_York",
    "ip_address": "10.168.1.1",
    "*": "{{other_event_properties}}"
  }
}

Parametreler:

Parametre	Tür	Açıklama
distinct_id	String	Kullanıcı için benzersiz tanımlayıcı (ör. `profile.posthog_distinct_user_id`, `customer_user_id` veya `profile_id`).
timestamp	ISO 8601 tarih ve saat	Etkinliğin tarihi ve saati.
event	String	PostHog yapılandırmasının Events names bölümünde tanımladığınız etkinlik adı.
properties	Object	properties.$set parametrelerini ve tüm etkinliğe özgü özellikleri içerir. Her özellik isteğe bağlıdır; eksik olması durumunda PostHog’a gönderilmez.

properties.$set parametreleri

Her properties.$set nesne parametresi isteğe bağlıdır; eksik olması durumunda PostHog’a gönderilmez.

Parametre	Tür	Açıklama
email	String	Kullanıcının e-posta adresi.
first_name	String	Kullanıcının adı.
last_name	String	Kullanıcının soyadı.
birthday	String (Date)	Kullanıcının doğum tarihi.
gender	String	Kullanıcının cinsiyeti.
os	String	Kullanıcının cihazının işletim sistemi.

PostHog entegrasyonunu kurma

Adapty Kontrol Paneli’nde Integrations -> PostHog sayfasını açın ve geçişi etkinleştirin.
PostHog Kontrol Paneli’ne giriş yapın.
Settings -> Project bölümüne gidin.
Project penceresinde Project ID bölümüne kadar aşağı kaydırın ve Project API key değerini kopyalayın.
API anahtarını Adapty Kontrol Paneli’ndeki Project API key alanına yapıştırın. PostHog, sunucudan sunucuya entegrasyon için özel bir Sandbox modu sunmaz.
PostHog Deployment seçeneğinizi belirleyin:

Seçenek Açıklama
us/eu Varsayılan PostHog barındırmalı dağıtımlar.
Custom Kendi barındırdığınız örnekler için. Örnek URL’nizi PostHog Instance URL alanına girin.
(isteğe bağlı) Kendi barındırdığınız bir PostHog dağıtımı kullanıyorsanız, dağıtımınızın adresini PostHog Instance URL alanına girin.
(isteğe bağlı) Reporting Proceeds, Exclude Historical Events, Report User’s Currency ve Send Trial Price gibi ayarları düzenleyin. Bu seçenekler hakkında ayrıntılı bilgi için Integration settings bölümüne bakın.
(isteğe bağlı) Events names bölümünde PostHog’a hangi etkinliklerin gönderileceğini özelleştirebilirsiniz. İstemediğiniz etkinlikleri devre dışı bırakın veya gerektiğinde yeniden adlandırın.
Kurulumu tamamlamak için Save’e tıklayın.

Seçenek	Açıklama
us/eu	Varsayılan PostHog barındırmalı dağıtımlar.
Custom	Kendi barındırdığınız örnekler için. Örnek URL’nizi PostHog Instance URL alanına girin.

SDK yapılandırması

PostHog’dan attribution verisi alabilmek için distinctId değerini aşağıda gösterildiği gibi Adapty’e iletin:

Üçüncü taraf bir kullanıcı kimliğini Customer User ID olarak kullanıyorsanız, bunu activate() sırasında geçirmeyin — üçüncü taraf SDK henüz bu kimliği oluşturmamış olabilir. Bunun yerine önce CUID olmadan activate() çağrısı yapın, ardından setIntegrationIdentifier() ve son olarak CUID ile identify() çağrısını gerçekleştirin.

do {
    let distinctId = PostHogSDK.shared.getDistinctId()

    try await Adapty.setIntegrationIdentifier(
        key: "posthog_distinct_user_id",
        value: distinctId
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier("posthog_distinct_user_id", PostHog.distinctId()) { error ->
    if (error != null) {
        // handle the error
    }

Adapty.setIntegrationIdentifier("posthog_distinct_user_id", PostHog.distinctId(), error -> {
    if (error != null) {
        // handle the error
    }
});

try {
    final distinctId = await Posthog().getDistinctId();

    await Adapty().setIntegrationIdentifier(
        key: "posthog_distinct_user_id",
        value: distinctId,
    );
} catch (e) {
    // handle the error
}


// ...
const posthog = usePostHog();

// ...
try {
  await adapty.setIntegrationIdentifier("posthog_distinct_user_id", posthog.getDistinctId());
} catch (error) {
  // handle `AdaptyError`
}

Adapty artık PostHog’a event gönderecek ve oradan attribution alacak.