Uygulamanızı Shopify App Store'da Yayınlama

Shopify App Store, satıcıların ilgisini çekmek için yarışan 10.000'den fazla uygulamaya ev sahipliği yapıyor, ancak bir uygulamanın onaylanması ve keşfedilmesi deneyimli geliştiricileri bile şaşırtan bir süreç. Shopify'ın inceleme ekibi, ilk gönderimlerin yaklaşık %40'ını reddediyor; bunların çoğu, iyi belgelenmiş ancak geniş çapta göz ardı edilen önlenebilir nedenlerden kaynaklanıyor.

Bu kılavuz, başvuru kılavuzunun tamamını sağlar: teknik gereksinimler, tasarım standartları, listeleme optimizasyonu ve uygulamaları sıfır yüklemeden tutarlı aylık yinelenen gelire taşıyan büyüme stratejileri.

Önemli Çıkarımlar

• Shopify'ın inceleme süreci ortalama 10-15 iş günü sürer; lansman zaman çizelgenizi buna göre planlayın
• Gömülü uygulama bölümleri için Polaris tasarım sistemi uyumluluğu tartışılamaz
• Uygulama listeleme kalitesi, arama sonuçlarından yüklemelere dönüşümü doğrudan etkiler; buna yatırım yapın
• İlk katılım akışı kalitesi bir inceleme kriteridir — ilk çalıştırma deneyimi Shopify personelinin yardımı olmadan sezgisel olmalıdır
• Fiyatlandırma şeffaflığı gereklilikleri: tüm ödemelerde Shopify Billing API kullanılmalıdır, platform dışı ödeme yapılmaz
• Gizlilik uyumluluğu (GDPR, CCPA) belgeleri doğru ve eksiksiz olmalıdır
• İlk 6 ayda 4,0'ın üzerinde yorum puanı almak, App Store görünürlüğünün devamlılığı açısından kritik öneme sahiptir
• İş Ortağı Kontrol Paneli analizleri, satıcıların yükleme dönüşüm huninizi tam olarak nerede terk ettiğini ortaya koyuyor

---

Ortak Hesabı ve Uygulama Kurulumu Ön Koşulları

Göndermeden önce Shopify İş Ortağı hesabınızın ve uygulama yapılandırmanızın tamamlanması gerekir.

İş ortağı hesabı gereksinimleri:

1. partners.shopify.com adresinde doğrulanmış Shopify İş Ortağı hesabı
2. Gelir ödemeleri için bağlanan banka hesabı
3. İki faktörlü kimlik doğrulama etkin
4. İş ortağı sözleşmesi kabul edildi (gelir paylaşımı dahil: Shopify, gelir paylaşımının yeniden yapılandırılması kapsamında abonelik ücretlerinin %20'sini, sonsuza kadar ücretsiz uygulamalardan veya yıllık 1 milyon ABD dolarının üzerindeki gelirlerden %0'ını alır)

İş Ortağı Kontrol Panelinde uygulama yapılandırması:

Uygulamalar > Uygulama oluştur'a gidin. Yapılandır:

• Uygulama adı: Benzersiz, açıklayıcı, adında "Shopify" yok (ticari marka politikası)
• Uygulama URL'si: Üretim uygulamanızın URL'si (HTTPS kullanılmalıdır)
• İzin verilen yönlendirme URL'leri: OAuth akışınızda kullanılan tüm geri arama URL'lerini ekleyin
• Kapsamlar: Yalnızca gerekli minimum kapsamları isteyin — aşırı kapsam istekleri inceleme reddini tetikler
• Uygulama proxy'si (varsa): URL yolunu ve hedef URL'yi yapılandırın

GDPR uyumluluğu web kancaları (tüm uygulamalar için gereklidir):

# shopify.app.toml
[[webhooks.subscriptions]]
topics = ["customers/data_request"]
uri = "/webhooks/gdpr/customers-data-request"

[[webhooks.subscriptions]]
topics = ["customers/redact"]
uri = "/webhooks/gdpr/customers-redact"

[[webhooks.subscriptions]]
topics = ["shop/redact"]
uri = "/webhooks/gdpr/shop-redact"

Bu üç uç noktanın 5 saniye içinde 200 döndürmesi ve veri silme/dışa aktarma isteklerini fiilen işlemesi gerekir. İnceleme ekibi bu uç noktaları test eder. İşlevselliği uygulamadan 200 değerini döndürmek, onay sonrası kaldırmaya neden olur.

---

Teknik İnceleme Gereksinimleri

Shopify'ın inceleme ekibi manuel ve otomatik teknik kontroller gerçekleştirir. Göndermeden önce bunların hepsini geçin.

Kimlik doğrulama ve güvenlik:

API kullanım gereksinimleri:

• Hiçbir zaman kullanımdan kaldırılmış API sürümlerini kullanmayın; her zaman son 12 aya ait bir sürümü kullanın
• API hızı sınırlamasını dikkatli bir şekilde ele alın (satıcılara gösterilen hatalar değil, 429 yanıt yeniden denemeyi tetiklemelidir)
• Kaldırma işleminden sonra asla satıcılar adına API çağrıları yapmayın
• shop/redact web kancasını aldıktan sonraki 48 saat içinde tüm satıcı verilerini temizleyin

Uygulama performansı karşılaştırmaları:

• Gömülü uygulamanın ilk yüklenmesi: ortalama ticari donanımda 3 saniyenin altında
• Normal kullanım sırasında tarayıcı konsolunda JavaScript hatası yok
• Tüm sayfalar Chrome, Firefox, Safari ve Edge'de doğru şekilde işleniyor
• Uygulamanızda müşteriye yönelik herhangi bir bileşen varsa mobil uyumlu

İlk katılım akışı incelemesi:

İnceleme ekibi uygulamanızı yükler ve ilk çalıştırma deneyimini belgeleme olmadan değerlendirir. İlk katılımınız şunları sağlamalıdır:

1. İlk ekranda uygulamanın ne yaptığını net bir şekilde açıklayın
2. Yeni kullanıcılara gerekli kurulum adımları konusunda rehberlik edin
3. İlk yapılandırmayı tamamlamak için desteğe başvurmanıza gerek yok
4. Katılım istemleri için Polaris CalloutCard veya Banner bileşenlerini kullanın

---

Tasarım ve Kullanıcı Deneyimi Standartları

Yönetici genelinde satıcı deneyimi tutarlılığı temel bir platform değeri olduğundan Shopify'ın tasarım gereksinimleri sıkı bir şekilde uygulanır.

Zorunlu Polaris kullanımı:

Gömülü uygulamadaki (Shopify yönetici iframe'inde oluşturulan) tüm kullanıcı arayüzü öğelerinin Polaris bileşenlerini kullanması gerekir. Özellikle yasaklanmıştır:

• Polaris Button stillerine uymayan özel düğme bileşenleri
• Polaris TextField, Select, Checkbox stilleri ile eşleşmeyen özel form girişleri
• Polaris tasarım belirteçlerinden farklı olan özel renk şemaları
• Polaris Spinner veya SkeletonPage kullanmayan özel yükleme durumları

Uygulama Köprüsü navigasyonu:

Gömülü uygulamalar, gezinme eylemleri için Uygulama Köprüsü'nü kullanmalıdır. Gömülü içerik içinde gezinmek için window.location.href veya <a> etiketlerinin kullanılması satıcı deneyimini bozar. Kullanımı:

import { useNavigate } from "@remix-run/react";

// For in-app navigation
const navigate = useNavigate();
navigate("/app/settings");

// For external links (opens in new tab, respecting embedded context)
import { useAppBridge } from "@shopify/app-bridge-react";
const app = useAppBridge();
// Use Redirect action for external URLs

Hata durumları:

İnceleme ekibi özellikle hata koşullarını test eder. Her formun şunları işlemesi gerekir:

• Ağ hataları (Banner öğesini boş bir sayfa değil, hata mesajıyla birlikte gösterin)
• Doğrulama hataları (satır içi, ilgili alanın yanında)
• Boş durumlar (bir eylemle Polaris EmptyState bileşenini kullanın)
• Yükleme durumları (ilk yüklemeler için SkeletonPage, eylemler için Spinner kullanın)

Erişilebilirlik gereksinimleri:

• Tüm görsellerin açıklayıcı alternatif metni olmalıdır
• Etkileşimli öğeler klavyede gezinilebilir olmalıdır
• Renk kontrastı WCAG AA standartlarını karşılamalıdır (doğru kullanıldığında Polaris tarafından işlenir)
• Yalnızca simge içeren tüm düğmelerde ekran okuyucu etiketleri

---

App Store Discovery için Listeleme Optimizasyonu

Uygulama listeniz bir satış sayfasıdır. Uygulamanızı arama veya kategoriye göz atma yoluyla bulan satıcılar, saniyeler içinde listelemenizin kalitesine göre yükleme kararlarını verir.

Uygulama adı optimizasyonu:

Uygulama adınız arama sonuçlarında görünür ve birincil faydayı iletmelidir. "E-posta Pazarlama Otomasyonu", alakalı aramalarda "MailBooster Pro"ya göre daha iyi sıralamaya sahiptir. Arama sonuçlarında temiz bir görünüm için adları 30 karakterin altında tutun.

Uygulama sloganı:

Bir cümle, maksimum 60 karakter. Özelliklere değil, faydaya öncülük edin. "Terk edilmiş sepetleri %15 daha fazla kurtarma", "Otomatik sepet kurtarma e-postalarından" daha iyi performans gösteriyor.

Uygulama açıklama yapısı:

Paragraph 1 (above the fold): Core value proposition and primary use case.
What problem does your app solve? For whom? What is the primary outcome?

Paragraph 2: Key features and how they deliver the benefit.

Paragraph 3: Social proof — merchants using the app, notable results, reviews.

Feature list (bullet points): 5-8 specific features with brief descriptions.

Paragraph 4: Integration information, compatibility notes.

Paragraph 5: Support and documentation resources.

Ekran görüntüsü gereksinimleri:

• Minimum 3 ekran görüntüsü, maksimum 8
• Çözünürlük: minimum 1600x900 piksel
• Pazarlama grafikleri veya özellik şemalarını değil, uygulamanızı kullanımda gösterin
• İlk ekran görüntüsü en önemlisidir; arama sonuçlarında görünür
• Temel özellikleri vurgulamak için ekran görüntülerine açıklama ekleyin
• Bir video açıklaması ekleyin (30-90 saniye) — videolu uygulamalar %40 daha iyi dönüşüm sağlar

Kategori ve anahtar kelime seçimi:

Uygulamanızı doğru şekilde tanımlayan en spesifik kategoriyi seçin. Yanlış kategorize edilen uygulamalar arama sıralamasında cezalandırılır. Anahtar kelimeler için: Satıcıların gerçekte aradığı eşanlamlıları, kullanım senaryosu açıklamalarını ve sorun ifadelerini ekleyin. Açıklamanızı anahtar kelimelerle doldurmayın — Shopify'ın algoritması karmaşıktır ve doğal olmayan yoğunluğu cezalandırır.

---

Fiyatlandırma Sayfası Stratejisi

Fiyatlandırma mimarisi, yükleme dönüşüm oranlarını ve kaybı önemli ölçüde etkiler.

Ücretsiz model performansı:

Ücretsiz katmana sahip uygulamaların yükleme oranları, yalnızca ücretli uygulamalara göre 3-5 kat daha yüksektir. Ücretsiz katmanlar bir dönüşüm hunisi oluşturur: satıcı ücretsiz olarak yükler → deneyim değeri → gelişmiş özellikler için yükseltmeler. Ücretsiz seviyenizi gerçekten kullanışlı ancak yükseltmeyi doğal hale getirecek şekilde sınırlı olacak şekilde tasarlayın (kullanım sınırları, özellik kapıları, satıcı sayısı sınırları).

Fiyatlandırma sayfasındaki en iyi uygulamalar:

• Net özellik karşılaştırma tablosuyla tüm planları gösterin
• Önerilen planı vurgulayın (çoğu uygulama orta seviyeyi "Popüler" yapar)
• Ücretli planlar sunuyorsanız para iade garantisi ekleyin
• Yıllık fiyatlandırma mevcut olsa bile birincil gösterim olarak aylık fiyatlandırmayı kullanın
• Hiçbir zaman Faturalandırma API'sinin ücretlendirdiğinden farklı fiyatlandırma gösterme; incelemenin reddedilmesi otomatiktir

Shopify Billing API uygulaması:

Tüm ödemeler Shopify'ın Faturalandırma API'si üzerinden yapılmalıdır. Uygulama içi özellikler için platform dışı ödeme bağlantıları (Stripe, PayPal) yasaktır. Profesyonel hizmetler için platform dışı ödemeleriniz olabilir, ancak uygulama özelliklerinin Faturalandırma API'si planlarının arkasında yer alması gerekir.

// billing configuration example for tiered pricing
billing: {
  "Starter": {
    amount: 9.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Professional": {
    amount: 29.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Enterprise": {
    amount: 99.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
  }
}

---

İnceleme Gönderme Süreci

Gönderim öncesi kontrol listesi:

• Uygulama yeni bir geliştirme mağazasına temiz bir şekilde yükleniyor
• OAuth akışı hatasız tamamlanıyor
• Tüm GDPR web kancaları 200 değerini döndürür ve doğru şekilde işlenir
• Uygulama temiz bir şekilde kaldırılıyor (oturum silindi, artık veri yok)
• İlk katılım akışı, yeni kullanıcılara harici yardıma gerek kalmadan kurulum boyunca rehberlik eder
• Gömülü kullanıcı arayüzü için kullanılan tüm Polaris bileşenleri
• Kısıtlanmış bir bağlantıda uygulama 3 saniyeden kısa sürede yüklenir
• Gizlilik politikası URL'si güncel ve doğrudur
• Uygulama listeleme ekran görüntüleri gerçek uygulama kullanıcı arayüzünü gösterir
• Fiyatlandırma sayfası tamamlandı ve Faturalandırma API'si yapılandırmasıyla eşleşiyor
• Normal uygulama çalışması sırasında konsol hatası yok
• Hız sınırlaması incelikli bir şekilde gerçekleştirildi
• Birden fazla tarayıcıda test yapın (Chrome, Firefox, Safari, Edge)

İncelenmeye gönderiliyor:

İş Ortağı Kontrol Panelinde uygulamanız > Dağıtım > İncelemeye gönder seçeneğine gidin. Sağlayın:

1. Test talimatları: inceleme ekibinin her özelliği yüklemesi ve kullanması için tam adımlar
2. Kimlik bilgilerini test edin: uygulamanızın bağlandığı tüm üçüncü taraf entegrasyonlarına ilişkin oturum açma ayrıntıları
3. Videolu anlatım (isteğe bağlı ancak karmaşık uygulamalar için önerilir): 2-5 dakikalık demo
4. Değişiklik günlüğü notları (güncellemeler için): ne değişti ve neden

Gönderimden sonra:

• İnceleme, gönderimden sonraki 3 iş günü içinde başlar
• İlk inceleme geri bildirimi genellikle 10-15 iş günü içinde ulaşır
• Reddedilirse özel geri bildirim alırsınız; yeniden göndermeden önce tüm noktaları ele alın
• Yeniden gönderim sırası daha hızlıdır (genellikle 5-7 iş günü)

---

Lansman Sonrası Büyüme Stratejileri

Onay, bitiş çizgisi değil, ilk gündür. Sürdürülebilir App Store büyümesi aktif yönetim gerektirir.

İnceleme oluşturma:

10'dan az yorumu olan uygulamaların dönüşüm oranları, 50'den az yorumu olan uygulamalara göre önemli ölçüde daha düşüktür. Satıcı anlamlı bir aşamaya (gönderilen ilk 100 e-posta, kurtarılan ilk alışveriş sepeti, senkronize edilen ilk sipariş) ulaştıktan sonra uygulama içi inceleme isteği uygulayın. Shopify'ın yerel inceleme isteği akışını kullanın:

// Trigger in-app review prompt via App Bridge
import { Modal, TitleBar } from "@shopify/app-bridge/actions";

// Display after user achieves milestone
const modal = Modal.create(app, {
  title: "Leave a review",
  url: `https://apps.shopify.com/your-app/reviews`,
});
modal.dispatch(Modal.Action.OPEN);

Özellik yayın temposu:

Güncelleme yayınlayan uygulamalar, Shopify'ın "Yeni ve güncellenmiş" filtresinde sıklıkla daha üst sıralarda yer alır ve satıcılar için önemli bir satın alma sinyali olan aktif bakımı gösterir. Her 4-6 haftada en az bir anlamlı güncelleme hedefleyin.

Destek kalitesi:

Shopify monitörleri yanıt sürelerini ve çözüm oranlarını destekler. Destek yanıt süreleri 48 saatin üzerinde olan uygulamalarda inceleme puanının düştüğü görülür. Karmaşık sorunlar için e-postaya/Slack'e yükseltme ile 1. kademe destek için Shopify'ın yerleşik destek gelen kutusunu (İş Ortağı Kontrol Panelinden erişilebilir) kullanın.

Uygulama Mağazası optimizasyonu (ASO):

Aylık olarak App Store aramasındaki anahtar kelime sıralamanızı takip edin. Hangi arama terimlerinin gösterimleri ve yüklemeleri artırdığını belirlemek için İş Ortağı Kontrol Paneli analizlerini kullanın. Uygulamanızın listeleme başlığını ve sloganını A/B testiyle değerlendirin; dönüşüm oranındaki küçük iyileştirmeler bile önemli ölçüde birleşir.

---

Sıkça Sorulan Sorular

Shopify App Store incelemesi ne kadar sürer?

İlk incelemeler genellikle 10-15 iş günü (2-3 hafta) sürer. Reddetme geri bildirimi ele alındıktan sonra yeniden gönderimler 5-7 iş günü sürer. Üçüncü taraf entegrasyonları veya alışılmadık izin kapsamları içeren karmaşık uygulamalar, incelemecilerin işlevselliği doğrulamak için daha fazla zamana ihtiyaç duyması nedeniyle daha uzun sürebilir. Lansman zaman çizelgenizi, gönderimden genel kullanıma sunulmaya kadar 8 haftalık bir ara süre ile planlayın: ilk inceleme için 2 hafta, geri bildirimin ele alınması için 2 hafta, yeniden gönderim incelemesi için 1 hafta ve beklenmeyen sorunlar için 3 haftalık ara süre.

App Store'un reddedilmesinin en yaygın nedenleri nelerdir?

En yaygın beş reddedilme nedeni şunlardır: (1) Polaris tasarım standartlarının yerleşik bölümlerde takip edilmemesi, (2) GDPR web kancalarının düzgün şekilde uygulanmaması, (3) Uygulama işlevselliği tarafından gerekçelendirilmeyen aşırı API kapsamı istekleri, (4) İlk katılım akışının tamamlanması için harici belgelere ihtiyaç duyulması, (5) Fiyatlandırma yapısının, uygulama içi özellikler için platform dışı ödeme seçeneklerini içermesi. Reddedilme olasılığını önemli ölçüde azaltmak için göndermeden önce beşinin tamamını proaktif bir şekilde ele alın.

Uygulamamı ücretsiz olarak listeleyip daha sonra ücretli planlar ekleyebilir miyim?

Evet ve bu önerilen bir stratejidir. İlk yükleme hacmini ve incelemeleri oluşturmak için ücretsiz olarak başlatın, ardından 50'den fazla aktif satıcıya ve 4'ten fazla yıldız derecelendirmesine sahip olduğunuzda ücretli planları uygulamaya koyun. Mevcut kullanıcıların istenirse ücretsiz erişime sahip olmalarını sağlamak için Shopify'ın Faturalandırma API'sinin büyükbaba tahsisi özelliklerini kullanın. Ücretsiz lansman, ücretli planlar yayına girdiğinde dönüşüm oranlarını önemli ölçüde artıran incelemeler ve sosyal kanıtlar oluşturur.

Uygulamam onaylandıktan sonra politikaları ihlal ederse ne olur?

Shopify, yayınlanan uygulamaları politika uyumluluğu açısından izler. İhlaller şunlarla sonuçlanabilir: gerekli düzeltme son tarihi ile uyarı, App Store'dan askıya alma (mevcut yüklemeler devam eder ancak yeni yüklemeler yapılmaz) veya App Store'dan kaldırılma (tüm yüklemeler erişimi kaybeder). Onay sonrası yaygın ihlaller şunları içerir: Güvenlik denetimleri yoluyla keşfedilen API kimlik bilgisi sabit kodlaması, uygulama kullanıcı arayüzünde bulunan platform dışı ödeme bağlantıları ve veri saklama ihlalleri (kaldırma sonrasında satıcı verilerinin saklanması).

Uygulamanın keşfedilebilirlik derecesi ne kadar önemli?

Derecelendirme, Shopify'ın App Store sıralama algoritmasındaki en önemli faktörlerden biridir. 4.0'ın altındaki uygulamalar, arama sonuçlarında ve kategori taramada önemli ölçüde bastırılır. 4,7'den fazla derecelendirmeye sahip uygulamalar, seçilmiş "En çok tercih edilenler" bölümlerinde görünür. İncelemelerinizi aktif olarak izleyin, olumsuz yorumlara profesyonelce ve çözümlerle yanıt verin ve zaman içinde sağlıklı bir derecelendirmeyi korumak için sistematik bir inceleme isteği akışı uygulayın.

---

Sonraki Adımlar

Shopify incelemesini geçen ve sürdürülebilir MRR'ye ulaşan bir uygulama oluşturmak, Shopify'ın teknik standartları, App Store listeleme optimizasyonu ve satıcı edinme stratejisinde uzmanlık gerektirir.

ECOSIRE'ın Shopify uygulama geliştirme hizmetleri mimariden App Store onayına kadar olan yolculuğun tamamını kapsar: teknik geliştirme, inceleme hazırlığı, listeleme optimizasyonu ve lansman sonrası büyüme desteği. Uygulamalarımızın ilk gönderim onay oranı %92'dir.

Shopify uygulamanızı ECOSIRE ile oluşturmaya başlayın — uygulama konseptiniz hakkında geliştirme ekibimizle konuşun.