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 becerisinin 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 işe yarar

Ekibinizin anlayabileceği bir huni: welcome → signup → paywall dizisi ne olduğunu açıkça anlatır. Otomatik oluşturulmuş üç kod bunu yapamaz.
Araçlar arasında ortak bir dil: Bir ekrana verdiğiniz isim, Adapty’nin flow metriklerinde ve kendi analitiğinizde aynı isimdir; dolayısıyla ikisini eşleştirmek için bir referans tablosuna gerek kalmaz.
Sorgulanabilir yanıtlar: beginner adı verilen bir quiz seçeneği, bir analistin filtreleyebileceği bir değerdir. Otomatik oluşturulmuş 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 becerisi, oluşturduğu her flow’da bunları sizin için adlandırır. Flow denetim becerisi 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: beceri her referansı kendisiyle birlikte taşır.

Neye bakmalısınız

Flow yayına girmeden önce yeniden adlandırın: Zaten toplanan etkinlikler, Adapty’nin flow metriklerinde ve kendi analizlerinizde eski ID’yi korur. Değişikliği kapsayan bir huni, iki yarım dolu ekran gösterir ve geri yeniden adlandırma bunları birleştirmez.
Bir gruptaki her seçeneğin kendi Element ID’si olmalıdır: 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’da bunu işaretleyen hiçbir şey yoktur, 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 flow genelinde tutarlı kullanın. Karışık stiller, otomatik oluşturulan kodlardan daha zor sorgulanır.

Sınırlamalar

Ekran ID’leri yalnızca skill aracılığıyla yeniden adlandırılır: Flow Builder’da bunlar için herhangi bir alan bulunmaz.
Yeniden adlandırma geçmişi 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 raporlanmaz. Bunlardan birini adlandırmak flow’u etkiler, analitiğinizi değil.