Flow'lara geçiş
Adapty’de bir flow, tek bir placement arkasında onboarding ve paywall’ı tek bir varlık olarak birleştirir. Flow, ayrı ayrı oluşturup sunduğunuz onboarding ve paywall’ın yerini alır.
1 Ekim 2026’dan itibaren eski builder’larda yeni paywall ve onboarding oluşturamazsınız ve bu builder’ların desteği sona erer. Halihazırda sahip olduklarınız çalışmaya ve düzenlenebilir olmaya devam eder — o tarihte nelerin değiştiğ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 hayata geçirebileceğinizi açıklar.
Flow’lar Adapty SDK v4.0 veya daha yenisini gerektirir.
Flow’lar ile onboarding’ler ve paywall’lar karşılaştırması
Ayrı onboarding’ler ve paywall’lar kullandığınızda iki ayrı builder ve iki ayrı placement yönetmeniz gerekir. Ayrıca kullanıcıları onboarding’den paywall’a geçişi kendi kodunuzda sağlamanız gerekir.
Bir flow, ikisini birden tek bir deneyimle değiştirir; giriş ekranları, bir quiz ve satın alma ekranı tek bir editörde oluşturulur ve tek bir placement üzerinden sunulur. Bu placement yeni bir placement’tır: flow kendine özgü bir içerik türüdür, dolayısıyla yerini aldığı onboarding veya paywall placement’ı üzerinde çalışamaz.
Aşağıdaki tablo her seçeneğin size neler sunduğunu karşılaştırır:
| Flow | Paywall Builder paywall | Onboarding | |
|---|---|---|---|
| Çoklu ekran | Evet | Hayır — tek ekran | Evet |
| Render | Native | Native | WebView |
| Ürünler ve placement | Tek placement; ürünleri doğrudan flow’a eklersiniz | Tek placement; ürünleri doğrudan paywall’a eklersiniz | Tek 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.
- 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.
- Cihazda önizleyin: Flow’u Adapty mobil uygulaması aracılığıyla gerçek bir cihazda kontrol edin; uygulama derlemesi gerekmez.
- 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.
- 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 ile oluşturulduysa, yeniden inşa etmek yerine dönüştürün. Move to new builder eylemi, tek tıklamayla onu taslak bir flow olarak yeniden oluşturur — her yerel ayardaki düzen, metin ve fiyatları değişken olarak içeren ürünler — orijinaliniz siz düzenleyip test ederken yayında kalmaya devam eder. Bkz. Bir paywallı flow’a dönüştürme.
Bunun yerine sıfırdan bir şey oluşturmak için size uygun yolu seçin:
- Şablondan başlayın: Flow & Paywall Builder’da başlangıç şablonu veya boş bir flow, kod gerektirmez.
- Ajan becerisini kullanın: Kendi AI kodlama aracınız, terminalden flow’lar yazar ve düzenler — sınavlar, dallanma ve toplu yerel ayar ekleme için kullanışlıdır.
Oluştururken başvurun:
- Flow & Paywall Builder belgeleri: Builder’ı ve neler oluşturabileceğinizi adım adım anlatır.
- Yaygın flow tarifleri: En sık kullanılan ekranlar için adım adım kılavuzlar.
- AI’ya sor: Takıldığınızda herhangi bir doküman sayfasındaki sohbet arayüzünü kullanın.
Cihazda önizleme
Uygulamaya dokunmadan flow’u gerçek bir cihazda önizleyebilirsiniz. iOS veya Android için Adapty mobil uygulamasını indirin. Ardından Flow & Paywall Builder’da Test on device seçeneğine tıklayın, bir yerel ayar seçin ve QR kodu cihazınızla tarayın. Bu işlem gerçek ekranları, dallanmaları, metinleri ve tasarımı gösterir.
Önizleme modunda Adapty, mağazalardaki ürünlerinize erişemez; 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.
Flow’unuz için yeni bir placement oluşturun
Flow’lar, paywall’lar ve onboarding’ler birbirinden farklı üç içerik türüdür ve her biri kendi metrik setiyle ölçülür; bu nedenle bir placement yalnızca tek bir türe hizmet eder. Placement’ın türü oluşturulduğunda sabitlenir, dolayısıyla mevcut bir onboarding veya paywall placement’ını flow placement’ına dönüştürmenin yolu yoktur (bkz. placement türleri). Sunacağınız her flow için ayrı bir placement oluşturmanız gerekir.
Yeni flow placement’ına tamamen yeni ve benzersiz bir placement ID verin.
Placement ID’leri, uygulama genelinde benzersizdir; tür bazında değil. Bu nedenle bir flow placement’ı, bir paywall veya onboarding placement’ının ID’sini yeniden kullanamaz — hatta flow’un değiştirdiği içeriğin ID’sini bile. ID’yi yeniden kullanmak tercih meselesi değildir: Kontrol Paneli bunu reddeder.
Geçiş süresince eski placement’larınızı aktif tutun
Eski uygulama sürümlerindeki kullanıcıların onboarding ve paywall placement ID’leri uygulamaya derlenmiş durumdadır. Bu kullanıcılar, güncelleme yapana kadar onboarding ve paywall metodlarını çağırmaya ve mevcut onboarding ile paywall’u görmeye devam eder. Eski placement’ları yalnızca SDK v4 benimseme oranınız yeterince yükseldiğinde kullanımdan kaldırın.
Her konumu aynı anda flow’lara taşımak zorunda değilsiniz. SDK v4’te getFlow metodu hem flow placement’larından hem de paywall placement’larından veri çeker; bu sayede uygulama her yerde aynı metodu çağırır. Paywall Builder paywall’larını istedikleri placement’larda bırakın ve geri kalanında flow’ları 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ıyla A/B testi yapmaya devam edebilirsiniz: bir flow placement üzerinde flow varyantları arasında Regular A/B testi çalıştırın. Çapraz placement A/B testleri şu an yalnızca paywall’lar için kullanılabilir, bu nedenle henüz flow placement’ları arasında ç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 — çünkü farklı placement türlerinde yer alırlar.
Placement’ları bir agent skill ile oluşturun
Taşımanız gereken birden fazla placement varsa, migrate-placements skill bunları kendi AI kodlama aracınız üzerinden oluşturur. Adapty CLI aracılığıyla uygulamanızdaki her placement’ı okur, her birinin hangi paywall’a hizmet ettiğine göre gruplar, her paywall için flow’un nereden geldiğini sorar, ardından kapsam dahilindeki her paywall placement’ı için bir flow placement’ı oluşturur ve eski-yeni ID eşlemesini ile uygulamanızın göndermesi gereken getFlow çağrısını geri döndürür.
Paywall placement’larınız yalnızca okunur ve hiçbir zaman düzenlenmez; bu sayede siz çalışırken kesintisiz çalışmaya devam ederler. Skill’in önerdiği her placement ID ise onayınız beklenir.
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.
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.
