Sık karşılaşılan sorunlar
Bu makale, Flow & Paywall Builder’da bir flow oluştururken en sık karşılaşılan sorunları, her birinin nedeni ve çözümüyle birlikte derlemektedir.
Flow önizlenemiyor veya yayımlanamıyor
Flow’u önizlemeye veya yayımlamaya çalışırken aşağıdaki hatalarla karşılaşabilirsiniz:
| Mesaj | Neden ve Çözüm |
|---|---|
| No product selected | Bir ürün kartında ürün seçilmemiş. Bir ürün seçin ya da kartı silin. |
| This product no longer exists, This offer no longer exists | Ürün veya teklif kontrol panelinden silinmiş. Kullanıldığı yerde başka bir ürün/teklif seçin ya da sorunu tek seferde düzeltmek için Products panelindeki Missing girişinde Replace in N places seçeneğini kullanın. |
| This product is off this screen, This offer is off this screen | Bir metin değişkeni, koşul veya eylem, ekranın listesinde yer almayan bir ürüne atıfta bulunuyor; örneğin Products panelinden kaldırıldıktan sonra. Ürünü panele geri ekleyin ya da ilgili referansı düzenleyin. |
| Offer required | offer_price, offer_billing_period veya offer_full_duration, teklifi olmayan bir ürünle kullanılıyor. Ürün için bir teklif seçin ya da bunun yerine prod_* değişkeni kullanın. |
| Product reference is invalid | Ürün referansı hatalı biçimlendirilmiş. Ürünü yeniden seçin. |
| Purchase action has no product to buy | Bir Purchase eyleminde ürün yok; ya boş bırakılmış ya da silinmiş bir karta işaret ediyor. Öğenin Interactions sekmesinde Product alanını bir ürüne veya products.selectedProduct değerine ayarlayın. |
| Select product action has no product to select | Select product eyleminin işaret ettiği kart artık yok: silinmiş, ürün grubunun dışına taşınmış ya da başka bir ekranda. Öğenin Interactions sekmesinde eylemi bu ekrandaki bir karta yönlendirin. |
| Flow has no screens, Screen ”…” has no elements | Boş ekrana içerik ekleyin ya da ekranı silin. Yalnızca remote config içeriği taşıyan bir flow bu kuraldan muaftır. |
| Invalid interaction action | Bir eylem eksik: URL’siz Open URL, hedefsiz Navigate to screen, atama yapılmamış Set variable, Eylem ID’si olmayan Custom, ne başlık ne mesaj içeren Show alert, öğe belirtilmemiş Show veya Hide, Web Paywall URL’si olmayan web ödeme Purchase. Öğenin etkileşimlerini açıp eylemi tamamlayın ya da kaldırın. |
| Missing navigation target | Navigate to screen eylemi silinen bir ekrana işaret ediyor. Mevcut bir ekranı seçin ya da eylemi kaldırın. |
| Missing product target, Invalid product target, Product target on another screen, Ambiguous product target, Select Product inside a component | Select product eylemi; silinmiş, bir ürün grubunda yer almayan, başka bir ekranda bulunan, başka bir ekrandaki öğeyle aynı element ID’sini paylaşan ya da ekranlar arasında paylaşılan bir üstbilgi veya altbilgi içinde kalan bir kartı hedefliyor. Eylemi aynı ekrandaki bir ürün grubunda, benzersiz ID’ye sahip bir karta yönlendirin. |
| Missing selectable group | Bir öğe, artık mevcut olmayan bir seçilebilir gruba işaret ediyor. Bağlantıyı yeniden kurun ya da grubu yeniden oluşturun. |
| Invalid visibility condition | Koşullu görünürlük kuralı eksik. Koşul oluşturucuda tamamlayın. |
| Localized conditional text mismatch | Koşullu metin, farklı dillerde farklı dallar içeriyor. Tüm diller için aynı koşulları tanımlayın. |
| Missing product reference | Eski bir flow, ekranda kayıtlı olmayan bir ürün kullanıyor. Ekranı açın ve Products panelinde ürünü ekleyin. |
Flow’unuzu oluştururken Adapty uygulamasında önizleme yapın. Yayınlanamayan bir flow orada da yüklenmez ve hata mesajı sorunu belirtir.
Flow’unuzun üretime hazır olup olmadığını öğrenmek için flow-audit skill’i çalıştırın. Yayın hatalarının kontrol etmediği şeyleri denetler: çalışmayan butonlar, mağaza uyumluluğu, tamamlanmamış metinler ve çeviri kapsamı. Rapor, her sorun için ilgili öğeyi ve hangi ekranda olduğunu gösterir.
”Something went wrong” hatasıyla yayınlama başarısız oluyor

Yayınlama isteği, flow’unuzdan değil Adapty tarafından kaynaklanıyor. Canlı sürümünüz değişmeden kaldı. Birkaç dakika bekleyip tekrar yayınlamayı deneyin. Sorun devam ederse bildirimden Request ID’yi kopyalayın ve support@adapty.io adresine gönderin; ekip başarısız isteği bulabilsin.
Satın alma sırasında teklif uygulanmıyor
Builder yalnızca teklifin Adapty’de hâlâ mevcut olup olmadığını kontrol eder. İndirimin uygulanıp uygulanmayacağına satın alma anında mağaza karar verir: başlangıç teklifleri müşterinin uygunluk durumuna, App Store promosyon teklifleri ise geçerli bir In-App Purchase Key’e bağlıdır. Her iki durum da Ürün ve fiyat tutarsızlıkları bölümünde ele alınmıştır.
Önizlemede teklif fiyatı boş görünüyor
Builder önizlemesi mağazalara ulaşamadığından offer_price, offer_billing_period ve offer_full_duration değerleri yerine değişken adı süslü parantez içinde gösterilir. Bu değerler, SDK uygulamanızda flow’u render ettiğinde çözümlenir. Teklif türüne bağlı koşulları önizlemek için Ürünleri ve teklifleri önizleme bölümüne bakın.
Kısa hex renk girildiğinde yayınlama başarısız oluyor
Her rengi tam olarak altı hex basamaklı biçimde girin, örneğin #FFFFFF. Renk alanı daha kısa değerleri kabul eder ancak hiçbir zaman genişletmez; bu yüzden #FFF gibi bir kısaltma, SDK yapılandırmasına bozuk şekilde ulaşır ve yayınlama reddedilir. Opaklık bununla ilgisizdir — aynı değer %100 opaklıkta da başarısız olur. Dört basamaklı değer ise en maliyetli istisnadır: yayınlanır, ancak seçmediğiniz bir rengi görüntüler.
Tipografi düzenlemeleri bir element durumuna ulaşmıyor
Selected gibi bir durumun kendi tipografi ayarları olduğunda, Default durumunun tipografisinde yapılan düzenlemeler — farklı bir metin stili uygulamak da dahil olmak üzere — o durumu etkilemez. Durumun tipografisini doğrudan düzenleyin.
Bir metin stili silindiğinde öğeler biçimlendirmesini kaybeder
Bir metin stili silindiğinde, ayarları bu stili kullanan öğelere kopyalanmaz: söz konusu öğeler varsayılan tipografiye geri döner. Bir stili silmeden önce, etkilenen öğeleri başka bir stile atayın ya da tipografilerini manuel olarak ayarlayın.
Bir eleman ID’si değiştiğinde koşullar ve değişkenler bozulur
Koşullar ve metin değişkenleri, elemanlara Element ID ile başvurur; ID’yi değiştirmek mevcut başvuruları güncellemez — bunlar sessizce çözümsüz kalır. Element ID’yi, ona başvurmadan önce ayarlayın. Değiştirmeniz gerekiyorsa, her koşul ve değişken başvurusunu da güncelleyin. İstisna, ilerleme çubuğu segmentleridir: bir segmentin adını değiştirmek, ilgili başvuruları otomatik olarak günceller.
Bir koşul veya değişken boş bir değere çözümleniyor
Değişken seçici, her ekrandaki alanları listeler; bu nedenle bir koşul veya metin değişkeni, kullanıcının henüz doldurmadığı bir girişe başvurabilir. Çalışma zamanında böyle bir başvuru boş bir değere çözümlenir. Yalnızca flow’da daha önce toplanan alanlara başvurun.
Bir Set variable eylemi seçili ürünü değiştirmiyor
Hangi ürünün seçili olduğu, atayabileceğiniz bir değişken değildir; bu nedenle Set variable seçimi değiştiremez. Bunun yerine Select product eylemini kullanın.
Görsel veya video yüklenmiyor
Flow & Paywall Builder’ın medya sınırları dışındaki bir dosya yüklenemez. Dosyayı Görsel ve Video gereksinimlerine göre kontrol edin:
| Element | Formatlar | Maksimum dosya boyutu | Diğer sınırlar |
|---|---|---|---|
| Görsel | .JPG, .PNG, .WEBP | 20 MB | — |
| Video | .MP4, .WEBM | 50 MB | Maksimum 30 saniye; minimum 640×640 piksel |
Bu formatlar desteklenmemektedir:
- Animasyonlu GIF’ler ve animasyonlu WEBP’ler: Hareket eklemek için bunlar yerine bir Video öğesi kullanın.
- SVG: Dosyayı PNG veya WEBP olarak dışa aktarın. İkonlar için herhangi bir şey yüklemenize gerek yok — Icon öğesi, paketlenmiş Tabler Icons kütüphanesinden çizer.
Alt bilgi görüntülenmiyor
Alt bilgi yalnızca Vertical scroll etkin olan ekranlarda görüntülenir. Vertical scroll seçeneğini Screen settings > Scroll bölümünden etkinleştirin.