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 izinleri iste. 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ırla veya kullanıcının tıklamasıyla verilen geçici erişimi tercih et.
• 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ı dene.

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ç

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, 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ükle

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ı doldur

Açıklama, kategori, dil, görseller ve destek bilgilerini gir. Açıklamada eklentinin ne yaptığını abartısız ve net anlat; 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 et

Bu adım en çok dikkat isteyen kısımdır. Panelde şunları belirtmen 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ğin her izin için neden gerekli olduğunu kısa ve somut bir dille açıkla.
• Uzaktan kod kullanımı: Uzaktan kod çalıştırıp çalıştırmadığını beyan edersin.
• Veri kullanımı: Hangi tür kullanıcı verilerini topladığını ve bu verileri satmadığını, eklentinin amacı dışında kullanmadığını taahhüt edersin.

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

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

Eklentini herkese açık, liste dışı (yalnızca bağlantıyı bilenlerin bulabildiği) veya belirli kişi ya da gruplara özel olarak yayınlayabilirsin. Ş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önder

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 tarihini planlarken inceleme için pay bırak.

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önderebilirsin.

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üklersin. Güncellemeler de incelemeden geçer. Yeni bir izin eklediğinde, kullanıcılar bu izni onaylayana kadar eklentinin devre dışı kalabileceğini unutma. 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 azaltmana 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 etmeni sağlar. Bu servise hangi verinin gittiğini gizlilik beyanına dahil etmeyi unutma.
• 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ğun siteler: Eklenti başka sitelerin sayfa yapısına dayanıyorsa, o sitelerdeki değişiklikleri düzenli olarak kontrol et.

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ı kullanabilirsin:

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.