Analitik araçlarınızın gördüğü ID'lere isim verin

Adapty SDK, her ekran görüntülemeyi ve her yanıtı uygulamanıza bildirir. Her olay, geldiği ekran veya öğenin ID’sini içerir ve bu ID’ler kendi analitiğinizde görüntülenir. Varsayılan olarak bir ekranın ID’si scr_oAPBHPa7 gibi görünür; bu yüzden Amplitude veya Mixpanel’deki bir dönüşüm hunisi, yalnızca kodlardan oluşan bir sütun olarak görünür ve birinin kod-isim eşleştirmesini elle tutması gerekir.

Bu ID’leri kendiniz adlandırabilirsiniz. Giriş alanları ve seçilebilir gruplar Flow Builder’da adlandırılır. Ekran ID’leri ise flow-generator skill aracılığıyla ayarlanır; bu skill, bir ekranı flow’un her yerinde yeniden adlandırır.

Important

Ekranları yeniden adlandırma, flow oluşturucu skill’inin bir parçasıdır; bu nedenle ekstra bir kurulum gerekmez — flow oluşturucu kurulum adımlarını izlemeniz yeterlidir. Değişiklikleri kontrol panelinizde flow’lara kaydeder; bu nedenle önce bir taslak üzerinde çalıştırın ve yayımlamadan önce sonucu Flow Builder’da inceleyin.

Ne İçin Kullanılır

Ekibinizin okuyabileceği bir huni: welcome → signup → paywall sırası ne olduğunu anlatır. Üç tane üretilmiş kod bunu yapmaz.
Kendi araçlarınızda tek bir kelime dağarcığı: Uygulamanızın ilettiği her event, ekranı aynı şekilde adlandırır; böylece bir huni, bir kohort ve bir kontrol paneli filtresi bir arama tablosuna gerek kalmadan birbiriyle uyum sağlar.
Sorgulayabileceğiniz yanıtlar: beginner adlı bir sınav seçeneği, bir analistin filtreleyebileceği bir değerdir. Üretilmiş bir ID’nin önce çözümlenmesi gerekir.

Analitiğinizin gördüğü ID’ler

İki event ID taşır. flow_screen_showed kullanıcı bir ekranı açtığında, flow_user_input ise kullanıcı bir girdi doldurduğunda, bir quiz yanıtı seçtiğinde ya da bir toggle’ı çevirdiğinde tetiklenir. Her kılavuz, kendi event’inin tüm parametrelerini belgeler. Bu tablo yalnızca bir ekranı veya öğeyi tanımlayan parametreleri kapsar.

Olay parametresi	İçeriği	Nereden ayarlanır
`instanceId`	Ekranın kimliği	Flow oluşturucu skill’i
`element_id`	Bir girişin Element ID’si veya seçilebilir bir grubun Group ID’si	Flow Builder
`item_ids`	Seçilen seçeneklerin Element ID’leri	Flow Builder

Giriş alanları ve quiz seçeneklerini adlandırma

Giriş alanları ve seçilebilir grupların builder’da ID alanları bulunur. Bir giriş alanının Element ID’si Input settings bölümündedir ve flow’un başka yerlerinde bu değere başvurmak için kullandığınız ID’nin aynısıdır — bkz. Giriş alanları ve formlar. Bir grubun Group ID’si Screen settings > Selectable groups bölümündedir; içindeki her seçenek de kendi Element ID’sini alır.

Her birine, tek başına anlamlı bir isim verin; çünkü analitiğinizde görünen değer tam da bu string’dir. birthday ve beginner için açıklamaya gerek yoktur. el_024F ise bir eşleştirme tablosu gerektirir.

Elementi eklerken ID’yi hemen belirleyin, sonradan değil. Koşullar ve metin değişkenleri bir Element ID’ye işaret eder; bu ID’yi değiştirmek onları güncellemez — herhangi bir hata vermeden çalışmayı durdururlar. Halihazırda çalışan bir flow’da yeniden adlandırma yapacaksanız, onu kullanan tüm koşulları ve değişkenleri de güncellemeniz gerekir. Bkz. Element ID değişikliğinden sonra koşullar ve değişkenler bozulur.

Flow oluşturucu skill’i, oluşturduğu her flow’da bunları sizin için adlandırır. Flow denetim skill’i eksik olanları raporlar.

Ekranları yeniden adlandırma

Flow Builder’da ekranın kimliği için bir alan bulunmaz, bu yüzden skill’e şunu sorun:

Give the screens in my onboarding flow readable IDs.

Skill her ekran için bir isim önerir, ardından flow’un o ekrana işaret ettiği her yerde yeniden adlandırır — ekranın kendisi, oraya yönlendiren her navigasyon eylemi ve ekrana bağlı ürünler. Hepsini birlikte yeniden adlandırır; çünkü bir yerde yeniden adlandırılıp diğerinde adlandırılmamış bir ekran, yayınlanamayan bir flow anlamına gelir.

Hangi isimleri değiştirdiğini ve kaç referansın taşındığını söyler; ayrıca zaten var olan bir ekranla çakışacak bir yeniden adlandırma işlemini çalıştırmaz. Ekran kimliğini, halihazırda çalışan bir flow üzerinde yeniden adlandırmak güvenlidir; ancak Element kimliğinde durum böyle değildir: skill her referansı kendisiyle birlikte taşır.

Neye bakmalısınız

Flow yayına girmeden önce yeniden adlandırın: Önceden toplanan olaylar eski ID’yi korur. Değişikliği kapsayan bir dönüşüm hunisi iki yarım dolu ekran gösterir ve geri adlandırma bunları birleştirmez. Adapty’nin flow metrikleri de aynı şekilde bölünür; çünkü ekran satırlarını ID’ye göre gruplar — yeniden adlandırılan ekran, birincisiyle aynı etiket altında ikinci bir satır oluşturur.
Bir gruptaki her seçeneğin kendi Element ID’si olması gerekir: Bir seçenekte ID eksikse, iki seçenek aynı ID’yi paylaşıyorsa veya Group ID başka bir ekranda yeniden kullanılıyorsa, tüm grup hiçbir şey raporlamaz — yalnızca o seçenek değil. Builder bunu işaretlemez; bu nedenle bir gruba seçenek ekledikten sonra grubu gözden geçirin.
ID’ler analizlerinize tam olarak yazdığınız şekilde ulaşır: plan_selection veya planSelection gibi tek bir stil seçin ve bunu flow genelinde tutarlı kullanın. Karışık stiller, otomatik oluşturulmuş kodlardan sorgulamayı daha zor hale getirir.

Sınırlamalar

Ekran ID’leri yalnızca skill aracılığıyla yeniden adlandırılabilir: Flow Builder’da bunlar için bir alan yoktur.
Adapty’nin flow metrikleri bu adları göstermez: Flow metrikleri, bir ekranı flow’un yayınlanmış versiyonundan alınan <position>. <caption> şeklinde etiketler; dolayısıyla ekran ID’si ne olursa olsun 9. Paywall A olarak görünür. Buradaki ID’ler yalnızca kendi analitiğinize ulaşır.
Yeniden adlandırma geçmiş verileri taşımaz: Eski olaylar eski ID’yi korur.
Bazı öğeler input olayı göndermez: Şifre alanları, ürün seçimleri ve sekme geçişleri hiçbir zaman rapor oluşturmaz. Bunlardan birini adlandırmak flow’u etkiler, analitiğinizi değil.