Adapty flow'larını kendi ödeme sisteminizle kullanın

Adapty flow’larını kullanmak için satın alma işlemlerinizi Adapty’e taşımak zorunda değilsiniz. Observer mode kullanıldığında, her satın alma işlemini mevcut kodunuz yapar; Adapty ise paywall veya onboarding’i render eder, kimin göreceğine karar verir, A/B testi uygular ve sonuçları raporlar.

Bu kılavuzda nelerin değiştiği, nelerin değişmediği ve kurulumun ne gerektirdiği ele alınmaktadır.

Tip

Flow’lar hakkında yeni misiniz? Flow & Paywall Builder, bunları bağlamadan önce neler oluşturabileceğinizi anlatır.

Sizde kalan, Adapty’nin üstlendiği

Kodunuz şunları tutar:

  • Satın alma çağrısı
  • İşlemleri tamamlama ve onaylama
  • Erişim verme ve iptal etme
  • Yenilemeler ve ödeme yeniden denemeleri

Adapty şunları üstlenir:

Faturalandırmanızla ilgili hiçbir şey değişmez. Adapty flow’u render eder ve satın alma dokunuşunu ödemeyi gerçekleştiren kodunuza iletir.

Adapty’de ürünlerinizi oluşturun

Flow’unuzda fiyat gösteren veya satın alma işlemi yapan bir ekran yoksa bu bölümü atlayabilirsiniz — yalnızca onboarding ekranlarından oluşan bir flow için Adapty’de herhangi bir ürün tanımlamanıza gerek yoktur.

Bir ekran ürünleri göstermeye başladığı anda, sunduğu her abonelik veya tek seferlik satın alma için Adapty’de bir ürün oluşturun. Flow, karttaki fiyatı doğrudan üründen okur; bu sayede kart her zaman güncel mağaza fiyatını gösterir, fiyatı A/B testi ile deneyebilirsiniz ve Adapty geliri analitiklerde ürüne göre gruplar.

Adapty’deki bir ürün, zaten sattığınız mağaza ürününü işaret eder; dolayısıyla ürün oluşturmak ödeme akışını değiştirmez: her ücretlendirmeyi yine kodunuz yapar. Her ürün bir access level belirtir; Observer modunda Adapty bunu vermez — erişim yönetimi kodunuzda kalır — ama yine de bir access level gereklidir.

Adapty CLI, kontrol panelini açmadan ürün oluşturmanızı sağlar. Node.js 18 veya üstü ile yükleyin ve oturum açın:

npm install -g adapty
adapty auth login

Uygulama ID’nizi, ardından ekleyeceğiniz access level’ı alın — her yeni uygulama premium ile başlar:

adapty apps list
adapty access-levels list --app <app-id>

Ardından App Store Connect ve Google Play Console’dan ürün ID’lerini kullanarak sattığınız her mağaza ürünü için birer Adapty ürünü oluşturun:

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly --android-product-id com.example.monthly --android-base-plan-id monthly

--period lifetime seçeneğini tek seferlik satın almalar için, --stripe-product-id ve --stripe-price-id çiftini (ya da Paddle karşılığını) web üzerinden sattığınız şeyler için kullanın. products create tüm bayrakları listeler. Ürün ID’leri oluşturulduktan sonra değiştirilemez; dolayısıyla bir ürünü farklı bir mağaza ürününe bağlamak için yeni bir ürün oluşturmanız gerekir.

Warning

Ürün atanmamış bir ürün öğesi kaydetmeyi ve yayımlamayı engeller; bunu builder’da fark edersiniz. Ürün ayarlanmamış bir Purchase eylemi sorunsuz kaydedilir ancak cihazda çalışmaz — düğme hiçbir şey yapmaz. Her Purchase eylemine bir ürün atayın.

Ya da ürünleri atlayıp fiyatları statik metin olarak yazın

Ürün öğesi olmayan bir flow kaydedilir ve yayımlanır; böylece fiyatları metne yazabilir ve bir dokunuşun ne satın alacağına kendi kodunuz karar verebilir. Bunun size maliyeti:

  • Fiyatı iki yerde tutarsınız — mağazada ve flow’un metninde — ve birini değiştirdiğinizde ikisi birbirinden ayrışır.
  • Fiyat A/B testi yapılamaz; oysa bir flow’un asıl amacı budur.
  • Grafikler ve entegrasyonlar geliri daha az düzenli gruplar, çünkü Adapty ürünü yalnızca bildirdiğiniz işlemden öğrenir.
  • Kodunuz, flow’dan bir ürün almak yerine her tıklanan öğeyi bir ürünle eşleştirir.

Kurun

  1. SDK’yı Observer modunda etkinleştirin. SDK’yı yapılandırırken observerMode seçeneğini açın: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

  2. Ürünlerinizi Adapty’de oluşturun; flow’da hiçbir yerde fiyat gösterilmeyecekse buna gerek yoktur. Her ürün için tek bir CLI komutu yeterlidir — bkz. Adapty’de ürünlerinizi oluşturun.

  3. Flow’u oluşturun. Ekranlar için Flow & Paywall Builder belgesine, paywall ekranındaki ürünler için satın almaları ayarlama belgesine ve flow’un uygulamanızda nerede görüneceğini belirlemek için placement oluşturma belgesine bakın.

  4. Flow’u gösterin ve satın almayı kendi kodunuzla gerçekleştirin. Adapty, satın alma dokunuşunu kaydettiğiniz bir handler’a iletir.

  5. İşlemi bildirin; satın alınan ürünün paywall varyasyon kimliğiyle birlikte, böylece satın alma işlemi onu satan paywall’a atfedilerek analize ulaşır.

  6. ve 5. adımlar platforma göre farklılık gösterir. Her kod parçacığında flow, placement için çektiğiniz AdaptyFlow’dur; product, kullanıcının dokunduğu AdaptyPaywallProduct’tır; myPurchaseApi veya yourBillingClient ise halihazırda sahip olduğunuz satın alma kodunun yerini tutar.

Observer mode sınırlamaları

  • Adapty erişim vermez: Satın alma olaylarına karşılık ücretli erişim sağlamaz veya kısıtlamaz; yenilemeleri veya ödeme tekrarlarını yönetmez. Erişim kontrolü tamamen sizin kodunuza aittir.
  • Kendi işlemlerinizi siz kapatırsınız: Adapty, kodunuzun gerçekleştirdiği satın almaları bitirmez veya onaylamaz; her işlemi kapatmak sizin sorumluluğunuzdadır.
  • Raporlama zorunludur: Bir raporla birlikte ilettiğiniz variationId, bir satın alma ile onu üreten flow arasındaki tek bağlantıdır. Her işlemi raporlamazsanız flow metrikleriniz ve A/B testi sonuçlarınız yanlış olur.

Başka bir satıcı kullanıyorsanız

Observer mode yalnızca satın alma işlemini kodunuzun gerçekleştirmesini gerektirir — bunu hangi SDK’nın yaptığı önemli değildir. Flow’lar, RevenueCat, Superwall veya Qonversion üzerinde de kendi StoreKit ya da Billing Library kodunuz üzerinde çalıştığı gibi sorunsuz çalışır.

Yayına almadan önce almanız gereken üç karar:

  • Her işlemi yalnızca bir sistem tamamlar: En sık karşılaşılan sorun, iki SDK’nın aynı satın almayı birlikte tamamlamaya çalışmasıdır.
  • Erişimi yalnızca bir sistem yönetir: Observer modunda Adapty hiçbir şey vermez, dolayısıyla access level’lar olduğu yerde kalır.
  • Her satın almayı yalnızca bir kez raporlayın: Aynı işlemi iki yerden raporlamak analizlerinizi bozar.

Diğer sağlayıcıdan tamamen geçiş yapmak için bkz. RevenueCat’ten Geçiş veya Superwall’dan Geçiş.

Satın almayı Adapty’ye bırakın

Tip

Uygulamanız burada Adapty üzerinden satın alma yapıyor; bu nedenle kod tarafı standart bir Adapty entegrasyonudur. Hızlı başlangıç ya da RevenueCat’ten geçiş rehberini takip edin ya da SDK entegrasyon skill’ine devredin.

Observer modu, hızlı bir başlangıç yoludur. RevenueCat’in analizlerini korumak ancak Observer mode sınırlamalarından kaçınmak istiyorsanız ikisini ters çevirin: Adapty tam modda çalışır ve tüm satın alma işlemlerini tamamlar; RevenueCat ise kendi observer modunda çalışarak Adapty’nin gerçekleştirdiği satın almaları kaydeder.

Böylece Adapty, her bir ödemenin hangi flow, placement ve A/B testi varyantından kaynaklandığını bilir; access level yönetimini üstlenir, yenilemeleri, ödeme yeniden denemelerini ve iadeleri yönetir.

RevenueCat tarafında, SDK’yı yapılandırırken purchasesAreCompletedBy değerini uygulamanıza ayarlayın — iOS’ta .myApp, Android’de MY_APP. RevenueCat’in Using the SDK with your own IAP code sayfasında her platform için yapılandırma, iOS’un gerektirdiği StoreKit sürümü ve müşterinin önceden yaptığı satın almaları çeken syncPurchases() çağrısı yer almaktadır. Her iki SDK’ya da aynı kullanıcı kimliğini verin — Adapty’nin customer user ID ve RevenueCat’in appUserID değerleri aynı olmalıdır, aksi takdirde iki kontrol paneli farklı kişileri tanımlar.

Warning

Bu düzenleme, RevenueCat entitlement’larını doğruluk kaynağı olmaktan çıkarır ve bu rolü Adapty access level’ları üstlenir. RevenueCat izlemeye devam eder, kontrol paneli raporlamayı sürdürür; ancak artık her satın alma bilgisini dolaylı yoldan ve kendi dokümantasyonunda belirtilen kapsam sınırları dahilinde öğrenir. Bugün RevenueCat entitlement’larını okuyan her şey — uygulamanız, backend’iniz, bir web veya masaüstü yapısı — ya Adapty’e geçer ya da bir kopyayı okur. Yayına almadan önce bunu netleştirin. Başka hiçbir şey değişmez: RevenueCat hesabı, geçmişi ve entegrasyonları olduğu yerde kalır.