Web ve mobil arasında satın almaları senkronize etme

Kullanıcılarınız ürünleri web siteniz üzerinden satın alabiliyorsa, access level’larını mobil uygulamanızla otomatik olarak senkronize edebilirsiniz.

Bu kılavuzda, bunu Adapty API ve SDK kullanarak nasıl yapacağınızı öğreneceksiniz.

Örnek kullanım senaryosu

Diyelim ki uygulamanızda kullanıcılar hem mobilde hem de web’de ücretsiz plana kaydolabiliyor. Web sitenizde Stripe veya Chargebee aracılığıyla Premium plana geçişe izin veriyorsunuz. Bir kullanıcı web’de abone olduğunda, onlara mobil uygulamada hemen Premium erişim vermek istiyorsunuz — bekleme ya da yeniden giriş yapmadan.

Adapty tam da bunu otomatikleştirmenize yardımcı olur.

1. Adım. Kullanıcıları tanımlayın

Adapty, platformlar arasında kullanıcıları tanımlamak için customer_user_id kullanır.

Bu ID’yi bir kez oluşturmanız ve hem mobil SDK’nıza hem de web backend’inize iletmeniz gerekir.

Kullanıcılarınız web sitenizde kayıt olduğunda, sunucu taraflı API kullanarak Adapty’de onlar için bir profil oluşturmanız gerekir.

Yöntem referansını buradan inceleyebilirsiniz.

curl --request POST \
  --url https://api.adapty.io/api/v2/server-side-api/profile/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'adapty-customer-user-id: YOUR_CUSTOMER_USER_ID'

Kullanıcılarınız uygulamadan ilk kez kayıt olduğunda, customer user ID’yi SDK aktivasyonu sırasında iletebilir ya da SDK’yı kayıt aşamasından önce aktive ettiyseniz yeni bir profil oluşturup customer user ID atamak için identify metodunu kullanabilirsiniz.

SDK aktivasyonundan sonra yeni kullanıcıları tanımlıyorsanız, SDK önce anonim bir profil oluşturur; çünkü herhangi bir profil olmadan çalışamaz. Ardından kullanıcıyı tanımlayıp yeni bir customer user ID atadığınızda yeni bir profil oluşturulur.

Bu davranış tamamen normaldir ve analitik doğruluğunu etkilemez. Daha fazla bilgi için buraya bakın.

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}

Adapty.identify("YOUR_USER_ID") { error -> // Unique for each user
    if (error == null) {
        // successful identify
    }
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID", error -> {
    if (error == null) {
        // successful identify
    }
});

try {
    await adapty.identify("YOUR_USER_ID"); // Unique for each user
    // successfully identified
} catch (error) {
    // handle the error
}

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

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

Adapty.identify("YOUR_USER_ID") // Unique for each user
    .onSuccess {
        // successful identify
    }
    .onError { error ->
        // handle the error
    }

try {
  await adapty.identify({ customerUserId: "YOUR_USER_ID" });
  // successfully identified
} catch (error) {
  // handle the error
}

2. Adım. API üzerinden abonelik durumunu kontrol edin

Kullanıcı web sitenizde oturum açtığında, API ile Adapty profilini çekin.

Kullanıcının aktif bir aboneliği yoksa paywall gösterebilirsiniz.

Yöntem referansını buradan inceleyebilirsiniz.

curl --request GET \
  --url https://api.adapty.io/api/v2/server-side-api/profile/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'adapty-customer-user-id: YOUR_USER_ID' \

3. Adım. Web sitenizde paywall gösterin

Web sitenizde ücretsiz plan kullanıcılarına paywall gösterin. Herhangi bir ödeme sağlayıcısı kullanabilirsiniz (Stripe, Chargebee, LemonSqueezy vb.).

4. Adım. Adapty’de abonelik durumunu güncelleyin

Web sitenizde ödeme tamamlandıktan sonra, Adapty API’ını çağırarak kullanıcının satın aldığı ürüne göre access level’ını güncelleyin.

Yöntem referansını buradan inceleyebilirsiniz.

curl --request POST \
  --url https://api.adapty.io/api/v2/server-side-api/purchase/profile/grant/access-level/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'adapty-customer-user-id: YOUR_USER_ID' \
  --data '{
  "access_level_id": "YOUR_ACCESS_LEVEL"
}'

5. Adım. Uygulamada durumu senkronize edin

Kullanıcı mobil uygulamanızı açtığında, güncel profili çekin ve ücretli özelliklerin kilidini açın.

Profillerini ya manuel olarak almanız ya da otomatik senkronize etmeniz gerekir. Ardından profilden access level’ı alın.

Aşağıda profili nasıl alacağınızı ve durumunu nasıl kontrol edeceğinizi görebilirsiniz. Daha fazla ayrıntı için buraya gidin.

do {
    let profile = try await Adapty.getProfile()

    if profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive ?? false {
        // grant access to premium features
    }
} catch {
// handle the error
}

Adapty.getProfile { result in
    if let profile = try? result.get() {
        // check the access
        if profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive ?? false {
            // grant access to premium features
        }
    }
}

Adapty.getProfile { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
            // check the access
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                // grant access to premium features
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getProfile(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        // check the access
        if (profile.getAccessLevels().get("YOUR_ACCESS_LEVEL") != null && profile.getAccessLevels().get("YOUR_ACCESS_LEVEL").getIsActive()) {
            // grant access to premium features
        }

    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

try {
    const profile = await adapty.getProfile();
    // check the access
    if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive) {
        // grant access to premium features
    }
} catch (error) {
  // handle the error
}

try {
  final profile = await Adapty().getProfile();
  // check the access
  if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive ?? false) {
      // grant access to premium features
  }
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Adapty.GetProfile((profile, error) => {
  if (error != null) {
    // handle the error
    return;
  }

  // check the access
  if (profile.AccessLevels["YOUR_ACCESS_LEVEL"]?.IsActive ?? false) {
      // grant access to premium features
  }
});

Adapty.getProfile()
    .onSuccess { profile ->
        // check the access
        if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // grant access to premium features
        }
    }
    .onError { error ->
        // handle the error
    }

try {
  const profile = await adapty.getProfile();
  // check the access
  if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive) {
      // grant access to premium features
  }
} catch (error) {
  // handle the error
}

Web ve mobil arasında satın almaları senkronize etme

Örnek kullanım senaryosu

1. Adım. Kullanıcıları tanımlayın

Web’den kayıt

Uygulamadan kayıt

2. Adım. API üzerinden abonelik durumunu kontrol edin

3. Adım. Web sitenizde paywall gösterin

4. Adım. Adapty’de abonelik durumunu güncelleyin

5. Adım. Uygulamada durumu senkronize edin