Shopify Embedded App Gerekli mi? App Bridge Karar Rehberi

Mağaza sahibi bir uygulamayı kurduğunda iki deneyim yaşayabilir: Shopify admin içinde sorunsuz açılan gömülü uygulama, veya ayrı bir siteye yönlendirilmiş gibi hissettiren standalone uygulama. Geliştirici tarafında bu ayrım App Bridge, OAuth ve UI tutarlılığı kararlarını doğrudan etkiler.

Bu yazı kimler için?

Mağaza sahibi: App Store’da uygulama seçerken “admin’den çıkmadan çalışıyor mu?” beklentiniz varsa; embedded deneyim sizin için kalite göstergesidir.

Ajans / teknik danışman: Müşteri için özel uygulama veya entegrasyon planlıyorsunuz; admin deneyiminin Shopify standartlarına uyup uymayacağını değerlendirmeniz gerekiyor.

Uygulama geliştiricisi veya kurucu: Public app mi, custom app mi; standalone mı embedded mı — mimari kararı erken verilmeli.

Karar problemi: Uygulamanızın birincil kullanım yeri Shopify admin mi, yoksa kendi domain’inizde bağımsız bir panel mi?

Somut karar problemi

Embedded (gömülü) uygulama genelde şu ihtiyaçlarda mantıklıdır:

• Mağaza sahibi ürün, koleksiyon veya sipariş seçerken Resource Picker kullanacak
• Ayarlar ve günlük operasyon admin içinde yapılacak
• App Store’a public uygulama olarak çıkılacak (Shopify embedded deneyimi bekler)
• OAuth ve session token ile güvenli, cookie’den bağımsız auth isteniyor

Standalone (kendi domain’inde) uygulama şu durumlarda tercih edilebilir:

• B2B portal, harici dashboard veya çok sayfalı karmaşık arayüz admin iframe’ine sığmıyor
• Kullanıcı kitlesi yalnızca Shopify admin değil (ör. lojistik operatörü)
• Mevcut SaaS ürününüz zaten kendi UI’ına sahip; Shopify entegrasyonu yan kanal

“App Bridge şart mı?” sorusu aslında “Kullanıcı admin bağlamında mı kalacak?” sorusudur.

Karar çerçevesi ve kontrol listesi

Kullanıcı deneyimi

• Mağaza sahibi günde admin’de onlarca kez uygulamaya giriyor → embedded tercih
• Uygulama ayda bir kurulum/migration aracı → standalone kabul edilebilir
• Ürün/koleksiyon seçimi sık → Resource Picker (App Bridge) büyük kolaylık

App Store ve politika

• Public App Store listesi hedefleniyor → embedded + tutarlı UX (Polaris önerilir)
• Yalnızca tek mağazaya custom app → embedded zorunlu değil ama admin entegrasyonu hâlâ değerli

Teknik kapasite

• Session token doğrulaması backend’de yapılabilir → embedded için hazırsınız
• Local geliştirme tüneli (Shopify CLI, ngrok vb.) kurulabilir
• App Bridge sürümü (günümüzde App Remix / App Bridge 4.x hattı) takip edilebilir

Güvenlik

• Third-party cookie kısıtlamalarından etkilenmemek → session token yolu
• Her API çağrısında kısa ömürlü token yenileme → App Bridge otomatikleştirir

Polaris UI

• Admin ile görsel tutarlılık önemli → Polaris bileşenleri (Page, Card, DataTable)
• Tamamen özel marka UI şart → standalone veya hibrit; review sürecinde ek açıklama gerekebilir

Özet: Günlük operasyon aracı + App Store → embedded App Bridge. Harici portal veya nadir kullanım → standalone değerlendirin.

Geliştirme ortamı: embedded seçtiyseniz

Embedded kararını verdiyseniz teknik hazırlık da buna göre şekillenir:

1. Shopify Partner hesabı ve development store
2. Uygulamayı embedded olarak işaretleme
3. App Bridge ve (tercihen) Polaris bağımlılıkları
4. Shopify CLI (shopify app dev) ile local geliştirme
5. Backend’de session token doğrulama katmanı

Local geliştirmede tünel (ngrok, Cloudflare Tunnel veya CLI proxy) olmadan admin iframe’i uygulamanıza erişemez. Bu adım atlanırsa “lokalde çalışıyor, production’da bozuk” senaryosu sık görülür.

Mağaza sahibi olarak embedded uygulama değerlendirirken kurulum sonrası admin içinden açılıp açılmadığına, ürün seçim ekranlarının native hissedip hissetmediğine bakmanız yeterlidir. Teknik detayı bilmeniz gerekmez; deneyim kalitesi seçim kriteriniz olabilir.

Public app hedefliyorsanız App Store review sürecinde tutarlı navigasyon, açık hata mesajları ve OAuth izin açıklamaları da embedded kararınızın parçası sayılır. Standalone panel ile admin deneyimini koparmak, review geri bildirimlerinde sık görülen bir konudur.

Sık yapılan hatalar

Embedded işaretleyip standalone gibi geliştirmek. Uygulama iframe dışında açılıyorsa mağaza sahibi kopuk deneyim yaşar; App Store review’da sorun çıkabilir.

Session token’ı doğrulamadan API çağrısı yapmak. Cookie tabanlı auth modern tarayıcılarda güvenilir değil; backend her istekte token doğrulamalı.

Polaris’siz tutarsız arayüz. Zorunlu olmasa da admin’den kopuk görünen UI destek taleplerini ve review sürtünmesini artırır.

Resource Picker yerine manuel ID girişi. Mağaza sahibi için operasyonel yük; embedded uygulamanın ana avantajını boşa harcar.

App Bridge sürümünü güncellememek. Eski sürümler çalışsa da yeni uygulamalarda güncel Shopify app template’i (App Remix) başlangıç maliyetini düşürür.

Sık sorulan sorular

App Bridge olmadan Shopify uygulaması yayınlanır mı?

Teknik olarak standalone uygulama mümkündür. Public App Store uygulamalarında ise embedded deneyim fiilen standarttır; admin içi kullanım hedefliyorsanız App Bridge planlamalısınız.

Polaris kullanmak zorunlu mu?

Hayır, ancak Shopify admin ile görsel uyum ve review süreci açısından strongly recommended kabul edilir. Özel UI kullanıyorsanız erişilebilirlik ve navigasyon tutarlılığını özellikle test edin.

Custom app için de embedded gerekir mi?

Hayır. Tek mağazaya özel uygulamada standalone panel yaygındır. Yine de mağaza sahibi admin’den çıkmadan ayar yapacaksa embedded hâlâ iyi bir tercihtir.

Session token neden kısa ömürlü?

Güvenlik. Token yaklaşık bir dakika geçerlidir; App Bridge yenilemeyi yönetir. Backend her API isteğinde güncel token beklemelidir; uzun ömürlü token saklamak yerine doğrulama katmanı kurun.

Sonraki adım

Embedded app mi standalone mı sorusu projenin UX ve maliyetini doğrudan belirler. Mimariyi netleştirmek için info@murattanriover.com.tr adresine kısa bir ihtiyaç özeti gönderebilirsiniz; admin içi mi harici panel mi daha uygun, birlikte değerlendirebiliriz.