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 Dashboard’unuzdan silinmiş. Kullanıldığı yerde başka bir ürün/teklif seçin ya da Products panelindeki Missing girişinde Replace in N places seçeneğini kullanarak ekrandaki tüm kullanımları tek seferde düzeltin.
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 başvuruyor; örneğin Products panelinden kaldırılmış bir ürün. Ürünü panele geri ekleyin ya da 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şkenini kullanın.
Product reference is invalid	Ürün referansı hatalı biçimde oluşturulmuş. Ürünü yeniden seçin.
Purchase action has no product to buy	Bir Purchase eyleminin ürünü yok; ya boş bırakılmış ya da silinmiş bir karta işaret ediyor. Elementin Interactions sekmesinde Product alanını bir ürüne veya products.selectedProduct değerine ayarlayın.
Select product action has no product to select	Bir Select product eyleminin işaret ettiği kart yok: silinmiş, ürün grubunun dışına taşınmış veya başka bir ekranda. Elementin 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, Action ID olmayan Custom, ne başlığı ne de mesajı olan Show alert, element belirtilmemiş Show veya Hide, Web Paywall URL’si olmayan web ödeme Purchase. Elementin interactions bölümünü açıp eylemi tamamlayın ya da kaldırın.
Missing navigation target	Bir Navigate to screen eylemi silinmiş 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	Bir Select product eylemi; silinmiş, ürün grubunda olmayan, başka bir ekranda bulunan, element kimliği başka bir ekrandaki bir elementle çakışan veya ekranlar arasında paylaşılan bir üst bilgi ya da alt bilginin içinde yer alan bir karta işaret ediyor. Eylemi, benzersiz bir kimliğe sahip aynı ekrandaki ürün grubundaki bir karta yönlendirin.
Missing selectable group	Bir element, artık var olmayan bir seçilebilir gruba işaret ediyor. Yeniden bağlayın ya da grubu yeniden oluşturun.
Invalid visibility condition	Koşullu görünürlük kuralı eksik. Koşul oluşturucuda tamamlayın.
Missing Default Locale Content	Bir Open URL eyleminin başka bir dilde URL’si var ama varsayılan dilde URL’si yok. Varsayılan URL’yi Localizations panelinde ekleyin.
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.

”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 öğe için konum, boyut ve aralık kontrolleri eksik

Öğe ve kapsayıcısının ikisi de Free yönünü kullanıyor. Bu durumda yalnızca bir konum ve boyut seçeneği kalır: sabit genişlik ve yüksekliğe sahip Absolute. Adapty, diğer tüm kontrolleri gizler — Position geçişi, Spacing bölümü ve Fill ile Hug seçenekleri. Kontrolleri geri almak için öğenin Direction ayarını Vertical veya Horizontal olarak değiştirin.

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.

Kullanıcılar uygulamanızın değeri yerine özel etiketin Başlangıç değerini görüyor

Kullanıcıların bir özel etiketin Başlangıç değerini görmesi aşağıdaki durumlarda gerçekleşir:

• Uygulamanız hiçbir değer geçirmiyor: Flow’u açan kod, etiket için bir değer geçirmiyor ya da kullanıcı uygulamanızı bunu yapan sürüme güncellememiş.
• Ad eşleşmiyor: Uygulamanızın kodundaki ad, builder’daki etiket adıyla farklı. Adlar büyük/küçük harf duyarlıdır ve grubu da içerir. Örneğin, user grubu bir streak etiketi içeriyorsa etiketin tam adı user.streak olur.
• Aynı metin öğesindeki başka bir etiketin değeri yok: Bir metin öğesindeki özel etiketlerden birinin değeri yoksa, o öğedeki tüm etiketler Başlangıç değerlerini gösterir. Metin öğesindeki her özel etiket için bir değer geçirin.

Adapty mobil uygulaması özel tag’ler için herhangi bir değer iletmez, bu nedenle önizlemede yalnızca Başlangıç değerleri görüntülenir. Uygulamanızın ilettiği değerleri görmek için flow’u uygulamanızın bir derlemesinde açın.

Kullanıcılar özel etiket yerine hiçbir şey görmüyor

Kullanıcılar bir özel etiket yerine hiçbir şey görmüyor olabilir. Bunun nedenleri şunlardır:

• Uygulamanız boş bir string gönderiyor: Adapty, boş bir string’i geçerli bir değer olarak değerlendirdiğinden Başlangıç değeri yedek olarak gösterilmez. Bunun yerine Başlangıç değerinin gösterilmesi için etikete hiç değer göndermeyin.
• Etiketin Başlangıç değeri yok: Uygulamanız değer göndermediğinde yedek bir içerik göstermek için etikete bir Başlangıç değeri girin.

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.