Flow'lara geçiş

Adapty’de bir flow, onboarding ve paywall’ı tek bir placement arkasında tek bir varlık olarak birleştirir. Flow, ayrı ayrı oluşturup sunduğunuz onboarding ve paywall’ın yerini alır.

Warning

1 Ekim 2026’dan itibaren eski builder’larda paywall ve onboarding oluşturup düzenleyemezsiniz; destek de o tarihte sona eriyor. Mevcut her şey çalışmaya devam eder — o tarihte nelerin değişeceğine bakın.

Bu kılavuz, flow’lara geçtiğinizde nelerin değiştiğini ve eski uygulama sürümlerindeki kullanıcıları etkilemeden bu geçişi nasıl yapacağınızı açıklar.

Important

Flow’lar, Adapty SDK v4.0 veya üzerini gerektirir.

Flow’lar ile onboarding’ler ve paywall’lar

Ayrı onboarding’ler ve paywall’larla iki ayrı builder ve iki ayrı placement yönetirsiniz. Kullanıcıyı onboarding’den paywall’a geçirmek için de kendi kodunuzu yazmanız gerekir.

Bir flow ise her ikisinin yerini alır; giriş ekranları, bir quiz ve satın alma ekranı tek bir editörde oluşturulur ve tek bir placement üzerinden sunulur.

Aşağıdaki tablo her seçeneğin size neler sunduğunu karşılaştırır:

FlowPaywall Builder paywallOnboarding
Çoklu ekranEvetHayır — tek ekranEvet
RenderNativeNativeWebView
Ürünler ve placementTek placement; ürünleri doğrudan flow’a eklersinizTek placement; ürünleri doğrudan paywall’a eklersinizTek placement, ancak kendine ait ürün yok — satış yapmak için ayrı bir paywall oluşturup kendi placement’ından sunmanız gerekir

Geçiş yapmalı mısınız?

Uzun vadeli düşünüyorsanız, flow’lar daha sağlam bir temeldir — sürüm takviminize uyduğunda geçişi yapın.

Nasıl taşınır

Taşıma işlemi dört adımdan oluşur. Çabanın büyük kısmı tek seferlik bir SDK yükseltmesidir — flow oluşturma ve önizleme kodsuz yapılır.

  1. Flow’unuzu oluşturun: Mevcut bir paywall’ı tek tıklamayla dönüştürün ya da şablondan bir flow oluşturun; geliştirici gerekmez.
  2. Cihazda önizleyin: Flow’u Adapty mobil uygulaması aracılığıyla gerçek bir cihazda kontrol edin; uygulama derlemesi gerekmez.
  3. Flow’unuz için yeni bir placement oluşturun: Kendine özgü bir ID’ye sahip yeni bir flow placement’ı oluşturun ve mevcut placement’larınızla nasıl bir arada var olacağına karar verin.
  4. SDK’yı güncelleyin: Adapty SDK v4’e yükseltin, flow’u kendi placement’ından çekin ve sandbox satın alımını doğrulayın. Bu, geliştiricinin üstlendiği ana görevdir.

Flow’unuzu oluşturun

Paywallınız eski Paywall Builder’da oluşturulduysa, manuel olarak yeniden oluşturmak yerine onu bir flow’a dönüştürebilirsiniz. Aksi takdirde, başlangıç şablonu kullanabilir veya flow’u sıfırdan oluşturabilirsiniz. Flow ve paywall builder hakkında daha fazla bilgi edinin:

  • Flow builder dokümantasyonu: Builder’ı ve neler oluşturabileceğinizi adım adım anlatır.
  • Yaygın flow tarifleri: En yaygın ekranlar için adım adım kılavuzlar.
  • AI’ya sorun: Takıldığınızda herhangi bir dokümantasyon sayfasındaki sohbeti kullanın.

Cihazda önizleme

Flow’u, uygulamaya dokunmadan gerçek bir cihazda önizleyebilirsiniz. Adapty mobil uygulamasını iOS veya Android için indirin. Ardından flow builder’da Test on device seçeneğine tıklayın, bir dil seçin ve cihazınızla QR kodu tarayın. Bu işlem; gerçek ekranları, dallanmaları, metinleri ve tasarımı gösterir.

Note

Önizleme modunda Adapty, mağazalardaki ürünlerinize ulaşamaz; bu nedenle önizlemede gösterilen fiyatlar gerçek değildir. Gerçek satın almalar daha sonra, sandbox hesabıyla v4 derlemesinde doğrulanır — bkz. SDK’yı Güncelle.

Test on device button in the flow builder

Flow’unuz için yeni bir placement oluşturun

Bir placement yalnızca tek bir içerik türüne hizmet eder — flow, paywall veya onboarding. Mevcut bir onboarding ya da paywall placement’ını flow placement’ına dönüştüremezsiniz (bkz. placement türleri). Flow için ayrı, yeni bir placement oluşturmanız gerekir.

Yeni flow placement’ına tamamen yeni ve benzersiz bir placement ID verin. Bu ID, mevcut herhangi bir paywall veya onboarding placement’ının ID’siyle aynı olamaz ya da onu yeniden kullanamazsınız.

Warning

Geçiş süresince eski placement’larınızı aktif tutun Eski uygulama sürümlerindeki kullanıcılar, onboarding ve paywall placement ID’lerinizi uygulamaya derlenmiş şekilde kullanmaya devam eder. Bu kullanıcılar onboarding ve paywall metodlarını çağırmayı sürdürür ve güncelleme yapana kadar mevcut onboarding ile paywall’ı görür. Eski placement’ları yalnızca SDK v4 benimseme oranınız yeterince yükseldiğinde devre dışı bırakın.

Ayrı Flow'lar, Paywall'lar ve Onboarding'ler sekmeleri içeren placement listesi

SDK v4’te her location’ı aynı anda flow’a taşımak zorunda değilsiniz. getFlow metodu hem flow placement’lardan hem de paywall placement’lardan veri çektiği için uygulamanız her yerde aynı metodu çağırır. Paywall Builder paywall’larını istediğiniz placement’larda bırakın, geri kalanlar için flow kullanın. Geçiş sürecinde her placement türü kendi metriklerini takip eder. Hem eski hem yeni uygulama sürümleri aktifken, verileriniz iki placement grubu arasında bölünür. Eski onboarding ve paywall placement’ları daha eski sürümleri; yeni flow placement’ı ise SDK v4+‘ı kapsar. Bunları ayrı kohortlar olarak karşılaştırın ve kullanıcılar güncelleme yaptıkça flow placement’ının payının büyümesini bekleyin. Flow varyantları üzerinde bir flow placement’ta Normal A/B testi çalıştırarak A/B testine devam edebilirsiniz. Placement’lar arası A/B testleri şu an yalnızca paywall’lar için kullanılabilir, dolayısıyla flow placement’lar arasında henüz çalıştıramazsınız. Yeni bir flow’u eski paywall’ınızla karşılaştırmak, tek bir test değil kohort karşılaştırmasıdır — bunlar farklı placement türlerinde yer alır.

SDK’yı Güncelleyin

Flow placement’ınız hazır olduğunda, uygulamayı ona yönlendirin. Flow’lar yalnızca Adapty SDK v4 ve sonrasında render edilir. SDK’yı yükseltin ve yeni placement’ınızdan flow’u getFlow ile alın. Platforma özel yükseltme adımları için v4 migration kılavuzuna bakın — iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform veya Capacitor.

Flow bağlandıktan sonra, diğer satın alma flow’larında yaptığınız gibi doğrulayın: bir cihaz veya simülatörde çalıştırın ve ürünlerin, satın almanın ve access level’ın düzgün çalıştığını doğrulamak için sandbox satın alması yapın. Platformunuza ait test kılavuzuna bakın: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform veya Capacitor.

Note

Kullanıcılar flow’ları yalnızca SDK v4+ ile oluşturulmuş uygulamayı yükledikten sonra görür. Daha eski bir uygulama sürümündeki kullanıcılar mevcut onboarding ve paywall’ı görmeye devam eder; bu nedenle geçiş süresince eski placement’lar aktif kalmaya devam eder.

flow_sdk_diagram.png