Paywall'da etkileşimli bir kilo hedef grafiği göster
Kullanıcının mevcut ve hedef ağırlığını bir onboarding flow’unda girerek paywall flow’unda grafik olarak göstermek için bu tarifi takip edin. Kullanıcı her iki değeri onboarding’de girer, uygulamanız bu değerleri toplar. Grafik, kullanıcının uygulamanızla haftalık olarak bekleyebileceği ilerlemeyi bir değerden diğerine gösterir. Uygulamanız grafiği, bir özel element içinde native Swift Charts view’u olarak render eder.
Bu tarif yalnızca iOS uygulamaları kapsar. Diğer framework’lerle oluşturulan uygulamalar yalnızca özel öğelerin yedek içeriğini gösterir. Android ve platformlar arası framework desteği yakında gelecek.
Başlamadan önce
- Uygulamanızı Adapty iOS SDK 4.4 veya sonraki bir sürüme güncelleyin. Daha eski SDK sürümleri, her özel element için yedek içeriği gösterir.
- Uygulamanızı flow’ları çekmek ve görüntülemek için ayarlayın.
- İki ayrı flow oluşturun — biri onboarding için, diğeri paywall için. Her birini bir placement’a ekleyin. Bu tarifte paywall flow’u,
weight_paywallID’li placement’tan çekilir.
1. Onboarding flow’unda mevcut ve hedef kiloyu sorgula
Flow & Paywall Builder’da onboarding flow’una iki Number girişi ekle:
- Mevcut kilo için kilogram cinsinden, Element ID olarak
weightdeğeriyle. - Hedef kilo için kilogram cinsinden, Element ID olarak
goal_weightdeğeriyle.
Uygulamanızın ağırlıkları her yerel ayarda aynı şekilde okumasını sağlamak için her iki girdinin Format açılır menüsünden Integer seçeneğini belirleyin. Bir girdi, değerini kullanıcının yazdığı şekliyle metin olarak uygulamanıza gönderir. Bu tarifte yer alan kod “70.5” ve “70,5” değerlerini farklı biçimlerde okur. Tam sayılarda ondalık ayırıcı bulunmaz.
Uygulamanızın her iki değeri de almasını sağlamak için onboarding flow’unu hiç girdi içermeyen bir ekranla sonlandırın. O ekrana Close flow eylemiyle bir düğme ekleyin. Girdiler, odağı kaybettiklerinde veya kullanıcı başka bir ekrana geçtiğinde değerlerini gönderir.
2. Paywall ekranına özel öğeyi ekleyin
Paywall flow’unda, bir ekrana özel öğe ekleyin ve grafik için şu şekilde yapılandırın:
- Type:
line_chart. - ID:
weight_goal. - Height: Varsayılan Fixed yüksekliği koruyun. Grafik, özel öğeyi tamamen kaplar.
Özel öğeyi, carousel gibi dokunmaya tepki veren container’ların içine koymayın. Aksi takdirde grafik üzerinde yapılan bir sürükleme aynı zamanda carousel’i de hareket ettirir.
Özel öğenin içine, örnek bir ağırlık grafiği gösteren bir Görsel ekleyin. Uygulamanızın eski sürümlerini kullanan kullanıcılar, grafik görüntülenemediğinde bunu yedek olarak görür.
3. Mevcut ve hedef ağırlığı uygulamanıza kaydedin
Onboarding flow’unun flow_user_input olaylarından mevcut ve hedef ağırlığı toplayın; bunun için Flow’lardan veri işleme bölümüne bakın. Kullanıcının son ekrana ulaştığını anlamak için is_last_screen değeri true olan flow_screen_showed olayını takip edin. Bu ekranın ardından onboarding flow kapandığında her iki ağırlığı da showWeightPaywall metoduna iletin; bu metot özel öğeyle grafiği eşleştiren paywall flow’unu açar.
Aşağıdaki kod UIKit içindir. Bir view controller her iki flow’un da delegate’idir. Aynı zamanda AdaptyFlowControllerDelegate protokolünün satın alma ve geri yükleme metotlarını da uygulamalıdır. Bu örnekte bunlar dahil edilmemiştir. Görmek için UIKit’te flow ve paywall’ları gösterme sayfasına gidin.
SwiftUI’de delegate metodları yerine .flow modifier’ının didReceiveAnalyticEvent ve didDisappear closure’larını kullanın. Paywall flow’unu ikinci bir .flow modifier ile sunun.
4. Grafik görünümünü oluşturma
Bir kilo planı modeli ve grafikli bir SwiftUI görünümü oluşturun. Plan, mevcut kilodan hedef kiloya kadar haftada bir girdi içerir. Kullanıcı grafik üzerinde sürüklediğinde, görünüm dokunulan noktadaki haftayı işaretler ve o hafta için tahmini kiloyu gösterir:
Plan, haftada 0,5 kg değişim olduğunu varsayar. Farklı bir oran kullanmak için weeklyChange değerini düzenleyin.
Grafik üzerinde sürükleme özelliği iOS 17 veya sonrasını gerektirir. iOS 16’da kullanıcılar çizgiyi görebilir ancak üzerinde sürükleyemez.
5. Grafiği özel öğeyle eşleştirin
line_chart Türü ve weight_goal ID’si için grafik view’ını döndüren bir resolver yazın. Ağırlık planını resolver’ın bir özelliğinde saklayın:
Attach the resolver to the paywall flow when you fetch its configuration. Create the resolver with the weight plan from the current and goal weight:
Uygulamanız uygulama genelinde bir resolver belirliyorsa, bu resolver paywall flow’unda onu geçersiz kılar. WeightChartResolver, başka herhangi bir Tür ve ID için nil döndürür; çünkü bu tarif içindeki paywall flow’unda başka özel element bulunmamaktadır. Paywall flow’unuzda başka özel elementler varsa, uygulama genelindeki resolver’ı bu resolver’a aktarın. Ardından, Bir flow’a resolver ekleme bölümünde olduğu gibi, ilgili Tür ve ID’ler için uygulama genelindeki resolver’ı çağırın.
6. Cihazda test edin
Flow & Paywall Builder, uygulama kodunuzu çalıştıramaz; bu nedenle tuval yalnızca yedek içeriği gösterir. Grafiği önizlemek için:
- Her iki flow’u da yayınlayın. Önbelleğe alınmış sürümler yerine en son yayınlanan sürümleri görmek için cihazınızı bir test cihazı olarak kaydedin.
- iOS 17 veya sonraki bir sürümde resolver’ı içeren bir uygulama derlemesi çalıştırın. Mevcut ve hedef ağırlığı girerek onboarding flow’unu tamamlayın. Grafiğin çizgisinin mevcut ağırlıktan başlayıp hedef ağırlıkta bittiğini doğrulayın.
- Grafiğin üzerinde sürükleyin ve parmağınızın altındaki haftaya ait tahmini ağırlığın çizginin üzerinde göründüğünü doğrulayın.
Yedek paywall’ı test etmek için getFlowConfiguration çağrısından customElementsResolver argümanını kaldırın ve paywall flow’unu tekrar açın.
Yedek paywall’ın grafik yerine neden göründüğünü öğrenmek için iOS kılavuzunun Cihazda test etme bölümündeki talimatları izleyin.