Adapty, her kullanıcı için dahili bir profil ID’si oluşturur. Ancak kendi kimlik doğrulama sisteminiz varsa, kendi Customer User ID’nizi belirlemeniz gerekir. Kullanıcıları Customer User ID’leriyle Profiles bölümünde bulabilir ve tüm entegrasyonlara gönderilecek olan sunucu taraflı API’de kullanabilirsiniz.

Yapılandırma sırasında Customer User ID belirleme

Yapılandırma sırasında bir kullanıcı ID’niz varsa, .activate() metoduna customerUserId parametresi olarak doğrudan geçirebilirsiniz:

   try {
       await Adapty().activate(
           configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
             ..withCustomerUserId(YOUR_CUSTOMER_USER_ID)
       );
   } catch (e) {
       // handle the error
   }

Yapılandırma sonrasında Customer User ID belirleme

SDK yapılandırması sırasında kullanıcı ID’niz yoksa, daha sonra istediğiniz zaman .identify() metoduyla ayarlayabilirsiniz. Bu metodun en yaygın kullanım senaryoları; kayıt veya oturum açma sonrasında kullanıcı anonim kullanıcıdan kimliği doğrulanmış kullanıcıya geçtiğinde ortaya çıkar.

try {
  await Adapty().identify(customerUserId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

İstek parametreleri:

• Customer User ID (zorunlu): string formatında kullanıcı tanımlayıcısı.

Oturum kapatma ve açma

.logout() metodunu çağırarak istediğiniz zaman kullanıcının oturumunu kapatabilirsiniz:

try {
  await Adapty().logout();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle unknown error
}

Ardından .identify() metoduyla kullanıcıyı tekrar oturum açtırabilirsiniz.

appAccountToken atama (iOS)

appAccountToken, App Store işlemlerini dahili kullanıcı kimliğinizle ilişkilendirmenizi sağlayan bir UUID’dir.
StoreKit bu token’ı her işlemle birlikte kaydeder, böylece backend’iniz App Store verilerini kullanıcılarınızla eşleştirebilir.

Kullanıcı başına oluşturulmuş, kararlı bir UUID kullanın ve aynı hesap için cihazlar arasında aynı UUID’yi tekrar kullanın. Bu sayede satın almalar ve App Store bildirimleri doğru şekilde ilişkilendirilmiş olur.

Token’ı iki şekilde belirleyebilirsiniz: SDK aktivasyonu sırasında veya kullanıcıyı tanımlarken.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

Gizlenmiş hesap ID’lerini belirleme (Android)

Google Play, kullanıcı gizliliğini ve güvenliğini artırmak amacıyla belirli kullanım senaryolarında gizlenmiş hesap ID’leri gerektirir. Bu ID’ler, Google Play’in satın almaları tanımlamasına yardımcı olurken kullanıcı bilgilerini anonim tutar; bu özellikle dolandırıcılığı önleme ve analitik açısından önemlidir.

Uygulamanız hassas kullanıcı verileri işliyorsa veya belirli gizlilik düzenlemelerine uymak zorundaysanız bu ID’leri belirlemeniz gerekebilir. Gizlenmiş ID’ler, Google Play’in gerçek kullanıcı tanımlayıcılarını açığa çıkarmadan satın almaları takip etmesini sağlar.

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

Cihazlar arası kullanıcı tespiti

SDK etkinleştirildiğinde, StoreKit (iOS) veya Google Play Billing (Android) üzerinden kullanıcının mevcut haklarını otomatik olarak okur ve bunları Adapty backend’iyle senkronize eder. Aktif bir abonelik, uygulamanın restorePurchases çağrısı yapmadan Adapty profilinde görünür.

Otomatik olarak gerçekleşmeyen şey, yeni bir cihazdaki profilin orijinal cihazdaki profille aynı kullanıcıya ait olduğunun tanınmasıdır. Adapty, profilleri Customer User ID ile eşleştirir; dolayısıyla kimlik sürekliliği CUID olarak ne kullandığınıza bağlıdır.

Adapty’nin cihazlar arasında neleri algılayabildiği

Kurulumunuz	Adapty’nin algıladığı	Yapmanız gereken
Customer User ID = device_id (uygulama girişi yok)	Yeni cihaz farklı bir CUID ve dolayısıyla farklı bir profil alır. Abonelik, Access level updated olayı aracılığıyla yeni profile senkronize edilir; ancak subscription_started tetiklenmez — yeni profil, orijinal satın almanın devralıcısı olarak değerlendirilir. subscription_started üzerine kurulu analizler, geri dönen kullanıcıları eksik sayar.	Geri dönen bir kullanıcının cihazlar arasında mevcut profille eşleşmesi için Customer User ID olarak kararlı bir hesap kimliği kullanın.
Customer User ID = kararlı hesap kimliği (her cihazda oturum açma)	SDK, activate() sırasında aboneliği otomatik olarak senkronize eder ve identify(), CUID ile mevcut profili eşleştirir.	Ek kurulum gerekmez — hem kimlik hem de abonelik otomatik olarak çözümlenir.
Apple Family Sharing devralıcısı	Aile üyesi, aboneliği yalnızca Access level updated olayı aracılığıyla alır — subscription_started tetiklenmez.	Access level updated olayını dinleyin. Tam olay matrisi için Apple Family Sharing sayfasına bakın.
Aynı Apple/Google hesabı, farklı uygulama içi kullanıcılar	Satın almayı kaydeden ilk profil üst profil olur. Sonraki profiller, tek bir Access level updated olayıyla bir devralıcı zinciri aracılığıyla aboneliği görür.	Oturum açmayı zorunlu kılın, ardından modelinize uygun bir paylaşım modu seçin.

Yeni bir cihazda satın almaları geri yükleme

Paywallınızda kullanıcı tarafından başlatılan bir “Satın almaları geri yükle” butonu gösterin. Apple App Review (kural 3.1.1) bunu zorunlu kılar ve otomatik senkronizasyonun uç bir durumu kaçırması halinde yedek olarak işlev görür. Buton, SDK’nızda restorePurchases çağrısı yapmalıdır.

İlk açılışta programatik bir restorePurchases çağrısı normal kullanım için gerekli değildir — SDK, activate() sırasında zaten eşdeğerini çalıştırır. Programatik çağrıları yalnızca zorunlu bir güncel makbuz kontrolü için ayırın; örneğin activate() tamamlandıktan sonra eksik erişimi hata ayıklarken.