Unity SDK'da kullanıcıları tanımlama

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, bunu .activate() metoduna customerUserId parametresi olarak geçin:

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID");

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek bir örnekle görmek ister misiniz? Tam kurulumu, paywall’ların gösterimini, satın alma işlemlerini ve diğer temel işlevleri içeren örnek uygulamalarımıza göz atın.

Yapılandırma sonrasında customer user ID belirleme

SDK yapılandırması sırasında kullanıcı ID’niz yoksa, .identify() metodunu kullanarak bunu istediğiniz zaman sonradan ayarlayabilirsiniz. Bu metodun en yaygın kullanım senaryoları; kayıt veya oturum açma sonrasında kullanıcının anonim kullanıcıdan kimliği doğrulanmış kullanıcıya geçiş yaptığı durumlardır.

Adapty.Identify("YOUR_USER_ID", (error) => {
  if(error == null) {
    // successful identify
  }
});

İstek parametreleri:

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

Önemli kullanıcı verilerinin yeniden gönderilmesi

Kullanıcının hesabına yeniden giriş yapması gibi bazı durumlarda, Adapty’nin sunucuları söz konusu kullanıcı hakkında zaten bilgiye sahiptir. Bu senaryolarda Adapty SDK, yeni kullanıcıyla çalışmaya otomatik olarak geçiş yapar. Anonim kullanıcıya özel nitelikler veya üçüncü taraf ağlardan attribution verileri gibi herhangi bir veri aktardıysanız, bu verileri tanımlanan kullanıcı için yeniden göndermeniz gerekir.

Ayrıca, yeni kullanıcının verileri farklı olabileceğinden, kullanıcıyı tanımladıktan sonra tüm paywall’ları ve ürünleri yeniden talep etmeniz gerektiğini unutmayın.

Oturum kapatma ve açma

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

Adapty.Logout((error) => {
  if(error == null) {
    // successful logout
  }
});

Ardından .identify() metodunu kullanarak kullanıcının oturumunu açabilirsiniz.

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 ilişkilendirir; böylece arka ucunuz App Store verilerini kullanıcılarınızla eşleştirebilir.

Kullanıcı başına oluşturulan kararlı bir UUID kullanın ve aynı hesap için farklı cihazlarda bu UUID’yi yeniden kullanın. Bu sayede satın almalar ve App Store bildirimleri doğru şekilde ilişkilendirilmiş kalır.

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

appAccountToken’ı her zaman customerUserId ile birlikte geçirmelisiniz. Yalnızca token’ı geçerseniz, bu işleme dahil edilmez.

using UnityEngine;
using AdaptySDK;
using System;

// During configuration:
var appAccountToken = new Guid("YOUR_APP_ACCOUNT_TOKEN");
var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID", appAccountToken);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
}); 

// Or when identifying users
Adapty.Identify("YOUR_USER_ID", appAccountToken, (error) => {
    if (error == null) {
        // successful identify
    }
});

Gizlenmiş hesap ID’lerini ayarlama (Android)

Google Play, kullanıcı gizliliğini ve güvenliğini artırmak amacıyla belirli kullanım senaryoları için gizlenmiş hesap ID’leri gerektirir. Bu ID’ler, Google Play’in kullanıcı bilgilerini anonim tutarken satın almaları tanımlamasına yardımcı olur; bu özellikle dolandırıcılığın önlenmesi 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 ayarlamanız gerekebilir. Gizlenmiş ID’ler, Google Play’in gerçek kullanıcı tanımlayıcılarını açığa çıkarmadan satın almaları takip etmesine olanak tanır.

using UnityEngine;
using AdaptySDK;

// During configuration:
var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetCustomerUserId("YOUR_USER_ID", null, "YOUR_OBFUSCATED_ACCOUNT_ID");

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});

// Or when identifying users
Adapty.Identify("YOUR_USER_ID", null, "YOUR_OBFUSCATED_ACCOUNT_ID", (error) => {
    if (error == null) {
        // successful identify
    }
});