Chrome Web Mağazası'nda Eklenti Yayınlama: Adım Adım Süreç

Chrome eklentisi yayınlama süreci; bir geliştirici hesabı açmak, eklenti paketini yüklemek, mağaza sayfasını doldurmak, izinlerin ve veri kullanımının gerekçesini açıklamak ve Google'ın incelemesinden geçmek adımlarından oluşur. Teknik olarak kısa bir süreçtir, ama izin gerekçeleri ve gizlilik beyanı özenle hazırlanmadığında eklenti reddedilebilir veya inceleme uzayabilir. Bu yazıda süreci adım adım ve sık yapılan hatalarla birlikte anlatıyoruz.

Yayın öncesi hazırlık

Mağazaya yüklemeden önce eklentinin kendisi kadar, onu anlatan materyallerin de hazır olması gerekir.

Teknik hazırlık

• Manifest V3 uyumu: Yeni eklentiler Manifest V3 ile yayınlanır. Uzaktan yüklenen JavaScript çalıştırılamaz; tüm mantık paketin içinde yer almalıdır.
• En az izin ilkesi: Yalnızca gerçekten kullandığınız izinleri isteyin. Tüm sitelere erişim gibi geniş izinler, incelemenin daha ayrıntılı yapılmasına yol açabilir. Mümkünse belirli alan adlarıyla sınırlayın veya kullanıcının tıklamasıyla verilen geçici erişimi tercih edin.
• Sürüm numarası: Manifest dosyasındaki sürüm, her güncellemede artırılmalıdır.
• Test: Eklentiyi temiz bir Chrome profilinde, paketlenmiş hâliyle kurup ana akışları deneyin.

Mağaza materyalleri

• Eklenti adı ve kısa açıklama,
• Ne yaptığını, kimin için olduğunu ve nasıl kullanıldığını anlatan ayrıntılı açıklama,
• Simge ve ekran görüntüleri (gerçek kullanımı gösteren),
• İsteğe bağlı tanıtım görselleri,
• Destek için iletişim adresi veya web sayfası,
• Gizlilik politikası bağlantısı (kullanıcı verisi işleniyorsa gereklidir).

Chrome eklentisi yayınlama adımları

1. Geliştirici hesabı açın

Chrome Web Mağazası Geliştirici Paneli'ne bir Google hesabıyla kaydolunur. Kayıt sırasında tek seferlik bir kayıt ücreti alınır ve hesap için iki adımlı doğrulamanın açık olması gerekir. Eklentiyi şirket adına yayınlayacaksanız, kişisel bir hesap yerine şirkete ait bir hesap kullanmak ileride erişim sorunlarını önler. Panel, birden fazla kişinin aynı yayıncı hesabını yönetebileceği grup yapısını da destekler.

2. Paketi yükleyin

Eklenti dosyaları ZIP olarak sıkıştırılıp panele yüklenir. Manifest dosyası ZIP'in kök dizininde olmalıdır. Yükleme sırasında manifest hataları varsa panel bunları gösterir.

3. Mağaza sayfasını doldurun

Açıklama, kategori, dil, görseller ve destek bilgilerini girin. Açıklamada eklentinin ne yaptığını abartısız ve net anlatın; gerçekte olmayan özellikleri vaat eden veya yanıltıcı anahtar kelime tekrarları içeren açıklamalar politikalarla çelişir.

4. Gizlilik uygulamalarını beyan edin

Bu adım en çok dikkat isteyen kısımdır. Panelde şunları belirtmeniz istenir:

• Tek amaç (single purpose): Eklentinin tek, dar ve anlaşılır bir amacı olmalıdır. Birbiriyle ilgisiz birçok işlevi tek eklentide toplamak politikaya aykırı sayılabilir.
• İzin gerekçeleri: İstediğiniz her izin için neden gerekli olduğunu kısa ve somut bir dille açıklayın.
• Uzaktan kod kullanımı: Uzaktan kod çalıştırıp çalıştırmadığınızı beyan edersiniz.
• Veri kullanımı: Hangi tür kullanıcı verilerini topladığınızı ve bu verileri satmadığınızı, eklentinin amacı dışında kullanmadığınızı taahhüt edersiniz.

Beyanlarınızın eklentinin gerçek davranışıyla ve gizlilik politikanızla birebir uyumlu olması gerekir.

5. Görünürlüğü seçin

Eklentinizi herkese açık, liste dışı (yalnızca bağlantıyı bilenlerin bulabildiği) veya belirli kişi ya da gruplara özel olarak yayınlayabilirsiniz. Şirket içi araçlar için liste dışı veya özel yayın genellikle yeterlidir. Kurumsal cihazlarda yöneticiler, eklentiyi politika yoluyla zorunlu kurulum olarak da dağıtabilir.

6. İncelemeye gönderin

Gönderimden sonra eklenti Google tarafından incelenir. İnceleme süresi sabit değildir; eklentinin istediği izinler, kodun yapısı ve ilk yayın olup olmadığı gibi etkenlere göre değişebilir. Lansman tarihinizi planlarken inceleme için pay bırakın.

Sık görülen red sebepleri

• Kullanılmayan veya amacına göre fazla geniş izin istemek,
• İzin gerekçelerinin belirsiz veya eksik olması,
• Gizlilik politikasının olmaması ya da eklentinin davranışıyla çelişmesi,
• Birden fazla ilgisiz işlevi tek eklentide toplamak,
• Açıklamada yanıltıcı ifadeler veya anahtar kelime doldurma,
• Kodun okunamayacak şekilde karartılması (obfuscation). Küçültme (minification) kabul edilir, ama kodun anlaşılmasını engelleyen karartma kabul edilmez.

Red durumunda panelde genellikle ilgili politika belirtilir. Sorunu düzeltip yeniden gönderebilirsiniz.

Güncellemeler nasıl yayınlanır?

Yeni bir sürüm yayınlamak için sürüm numarasını artırıp yeni paketi yüklersiniz. Güncellemeler de incelemeden geçer. Yeni bir izin eklediğinizde, kullanıcılar bu izni onaylayana kadar eklentinin devre dışı kalabileceğini unutmayın. Bu nedenle izin değişikliklerini dikkatli planlamak ve mümkünse isteğe bağlı izinleri kullanmak iyi bir uygulamadır.

Ayrıca yüzde olarak kademeli yayın imkânı, büyük güncellemeleri önce kullanıcıların bir kısmına açarak riski azaltmanıza yardımcı olabilir.

Yayından sonra takip edilmesi gerekenler

Eklenti yayına girdikten sonra iş bitmez. Düzenli olarak şunlara bakmak gerekir:

• Kullanıcı değerlendirmeleri ve destek talepleri: Mağazadaki yorumlar, çoğu zaman hataları ilk bildiren kaynaktır. Yorumlara kısa ve somut cevaplar vermek, diğer kullanıcılara da güven verir.
• Hata kayıtları: Eklentinin arka planında oluşan hataları bir izleme servisine göndermek, kullanıcı bildirmeden sorunları fark etmenizi sağlar. Bu servise hangi verinin gittiğini gizlilik beyanınıza dahil etmeyi unutmayın.
• Politika güncellemeleri: Chrome Web Mağazası politikaları ve Chrome'un eklenti API'leri zaman içinde değişir. Geliştirici panelindeki bildirimleri ve e-postaları takip etmek, eklentinin uyarı almadan kaldırılmasını önler.
• Bağımlı olduğunuz siteler: Eklenti başka sitelerin sayfa yapısına dayanıyorsa, o sitelerdeki değişiklikleri düzenli olarak kontrol edin.

Bu takibin kimin sorumluluğunda olduğu, eklenti projesinin başında bakım planıyla birlikte netleştirilmelidir.

Yayın kontrol listesi

• Manifest V3 kullanılıyor ve sürüm numarası güncel.
• Yalnızca gerekli izinler isteniyor, her birinin gerekçesi yazılı.
• Uzaktan kod çalıştırılmıyor.
• Gizlilik politikası yayında ve eklentinin davranışıyla uyumlu.
• Mağaza açıklaması net, ekran görüntüleri gerçek kullanımı gösteriyor.
• Destek iletişim bilgisi doğru.
• Görünürlük ayarı (herkese açık, liste dışı, özel) bilinçli seçildi.
• Temiz bir tarayıcı profilinde paketlenmiş sürüm test edildi.
• Lansman takviminde inceleme süresi için pay bırakıldı.

Mağaza açıklaması için kısa şablon

Mağaza sayfasının ayrıntılı açıklamasını yazarken şu yapıyı kullanabilirsiniz:

1. Tek cümlelik değer önerisi: Eklenti kimin için, hangi işi kolaylaştırıyor?
2. Nasıl çalışır: Üç dört adımda kullanım akışı.
3. Öne çıkan özellikler: Kısa bir madde listesi, yalnızca gerçekten var olan özellikler.
4. İzinler hakkında not: Eklentinin hangi sitelerde çalıştığı ve neden bu erişime ihtiyaç duyduğu, sade bir dille.
5. Gizlilik: Hangi verilerin işlendiği ve gizlilik politikasının bağlantısı.
6. Destek: Sorun bildirmek için iletişim yolu.

İzinler hakkında kullanıcıya açık bir not düşmek, kurulum sırasında görülen izin uyarısının yarattığı tereddüdü azaltır.

Sonuç

Chrome eklentisi yayınlama süreci, hazırlığı iyi yapılmış bir eklenti için uzun değildir; asıl belirleyici olan, izinlerin ve veri kullanımının dürüst ve net bir şekilde açıklanmasıdır. En az izinle çalışan, tek amacı belli ve gizlilik beyanı tutarlı bir eklenti incelemeden çok daha rahat geçer. Weras Labs, eklenti projelerinde geliştirmenin yanında mağaza hazırlığını ve yayın sürecini de üstleniyor; ayrıntılar hizmetler sayfamızda.