Shared Storage'a genel bakış

Gizliliği korumaya yönelik okuma erişimiyle siteler arası sınırsız, yazma erişimine izin verin.

Uygulama durumu

Bu belgede bölümlendirilmemiş, siteler arası depolama alanı olan Shared Storage API'ye yönelik bir teklif özetlenmektedir.

Teklif Durum
İçerik Seçimi için etkinlik düzeyinde raporlama (selectURL()) En az 2026'ya kadar kullanılabilir
Site başına bütçe oluşturma
Açıklama		 M119 sürümünde kullanılabilir
Yanıt başlıklarından yazmaya izin ver
Açıklama
GitHub Sorunu		 M124 sürümünde kullanılabilir. M119-M123'te manuel olarak etkinleştirilebilir
Özel Toplama katkısı zaman aşımı
Açıklayıcı		 M119 sürümünde kullanılabilir
Geliştirici Araçları ile Paylaşılan Depolama Alanı iş akışlarında hata ayıklama
Bölüm		 M120 sürümünde kullanılabilir
Paylaşılan depolama alanı veri depolama sınırını 5 MB olarak güncelleyin
Açıklama		 M124 sürümünde kullanılabilir

Bu API'ye neden ihtiyacımız var?

Siteler arası kullanıcı takibini önlemek için tarayıcılar tüm depolama biçimlerini (çerezler, localStorage, önbellekler vb.) bölümlere ayırır. Bununla birlikte, bölümlendirilmemiş depolamaya dayalı bazı geçerli kullanım alanları vardır. Bu da yeni web API'lerinin yardımı olmadan mümkün olmazdı. Örneğin, bir içerik üreticisi, siteler arası tanımlayıcılara dayanmadan farklı sitelerdeki erişimi ölçmek isteyebilir.

Shared Storage API, sitelerin bölümlendirilmemiş siteler arası verileri depolamasına ve bunlara erişmesine olanak tanır. Bu veriler, sızıntıları önlemek için güvenli bir ortamda okunmalıdır.

Ortak Depolama Alanı verilerini iki şekilde kullanabilirsiniz:

Kimler kullanabilir?

Shared Storage API'den yararlanabilecek birçok farklı şirket türü vardır. Örneğin:

  • Reklam teknolojileri, şu anda üçüncü taraf çerezlerine dayanan kampanya erişimini ölçebilir, sıklık sınırları ayarlayabilir ve reklam öğelerini dönüşümlü olarak yayınlayabilir.
  • Ödeme sağlayıcıları, kullanıcının mevcut bir müşteri olup olmadığını belirleyip ödeme deneyimini uyarlayabilir.
  • Web güvenliği şirketleri, şüpheli veya tehlikeli davranışları işaretlemek için özel mantık oluşturabilir.

Şirketiniz, henüz ele alınmamış siteler arası depolama çözümleri mi arıyor? Kullanım alanınızı paylaşın.

Kullanım alanları

Shared Storage API, üçüncü taraf çerezlerine yönelik mevcut birkaç kullanım alanının yerini alarak birçok kullanım alanını desteklemeyi amaçlamaktadır. Bu tür içerikler aşağıdakini kapsar:

Kullanım alanı Açıklama Çıkış kapısı
Reklam öğelerini dönüşümlü yayınlama Farklı sitelerde hangi reklam öğesi kullanıcılarının göreceğini belirlemek için reklam öğesi kimliği, görüntüleme sayısı ve kullanıcı etkileşimi gibi verileri depolayabilirsiniz. Böylece görüntüleme sayısını dengeleyebilir ve belirli içeriklerin aşırı doygunluğundan kaçınabilirsiniz. Bu da olumsuz bir kullanıcı deneyiminden kaçınmanıza yardımcı olabilir. URL seçimi
A/B testi yürütme Bir deneme grubuna kullanıcı atayabilir ve ardından siteler arası erişilebilmesi için bu grubu paylaşılan depolama alanında saklayabilirsiniz. URL seçimi
Kullanıcı deneyimini bilinen müşteriler için özelleştirme Kullanıcının kayıt durumuna veya diğer kullanıcı durumlarına göre özel içerik ve harekete geçirici mesajlar paylaşabilirsiniz. URL seçimi
Kötüye kullanıma karşı çözümler Kötüye kullanımla, sahtekarlıkla mücadele ve web güvenliği kuruluşları, kötü amaçlı kullanıcıları tespit etmek için genellikle otomatik botlar ya da zarar vermeye çalışan gerçek insanlar gibi özel teknikler kullanır. İster kullanıcı güvenilirlik derecelendirmesini kodlamak için URL Seçimi çıkış kapısı, ister anormallik algılaması için veri kümeleri oluşturmak amacıyla Özel Toplama çıkış kapısı kullanmak olsun, burada birçok farklı stratejiyi test etmek mümkündür. URL seçimi, Private Aggregation API
Tekil erişimi ölçme Birçok içerik yapımcısı ve reklamveren, genellikle içeriklerini kaç benzersiz kişinin gördüğünü bilmek ister. Bir kullanıcının reklamınızı, yerleştirilmiş videonuzu, yayınınızı ilk kez gördüğünde rapor oluşturmak ve aynı kullanıcının farklı bir sitede yinelenen bir şekilde sayılmasını önlemek için Paylaşılan Depolama Alanı'nı kullanabilirsiniz. Böylece, yaklaşık tekil erişiminiz hakkında toplu ve gürültülü bir rapor elde edebilirsiniz. Private Aggregation API
Kullanıcı demografisini ölçme İçerik üreticiler genellikle kitlelerinin demografisini anlamak ister. Paylaşılan depolama alanını, örneğin birinci taraf siteniz gibi bir bağlamda kullanıcının demografik verilerini kaydetmek için kullanabilir ve diğer birçok sitede (ör. yerleştirilmiş içerik) bu verilerle ilgili rapor oluşturmak için toplu raporlamayı kullanabilirsiniz. Private Aggregation API
K+ sıklık erişimini ölçme Bazen "etkili sıklık" olarak tanımlandıklarında, kullanıcının belirli içeriği tanıması veya geri çağırması için belirli bir minimum görüntüleme sayısı vardır (genellikle reklam görüntülemeleri bağlamında). Bir içeriği en az K kez gören tekil kullanıcıların raporlarını oluşturmak için Paylaşılan Depolama Alanı'nı kullanabilirsiniz. Private Aggregation API

Bu teklifin amacı, gelecekte uygulanabilecek birçok kullanım alanını destekleyen genel amaçlı bir API oluşturmaktır. Bu da web ekosistemiyle birlikte daha fazla deneme ve değişiklik yapılmasını sağlar.

Paylaşılan Depolama Alanı nasıl çalışır?

Paylaşılan Depolama, kullanıcı bilgilerini (tarayıcı geçmişi veya diğer kişisel ayrıntılar gibi) yerleştirilmiş bir siteyle paylaşmadan veya verileri kendi sunucularınıza çalmadan siteler arası verilere dayanarak bilinçli kararlar vermenizi sağlar.

localStorage veya indexDB gibi diğer JavaScript depolama API'leri gibi paylaşılan depolama alanına istediğiniz zaman yazabilirsiniz. Diğer depolama API'lerinden farklı olarak, paylaşılan depolama alanı değerlerini yalnızca paylaşılan depolama iş akışı olarak bilinen güvenli bir ortamda okuyabilirsiniz.

İş mantığınızı iş mantığına eklersiniz. İş akışında, Paylaşılan Depolama alanındaki bir değeri okuyup işlemenize izin verilir ancak tam değeri iş akışı çağrısına doğrudan döndüremezsiniz. İş akışından yararlı bilgileri ayıklamak için bir dizi "kapı" bulunur. Şu anda iki kapı olsa da gelecekte bunlara daha fazla kapı eklenebilir.

Kullanılabilir Shared Storage API çıkış kapıları şunlardır:

  • Siteler arası URL seçimi: Depolanan verilere göre, sağlanan listeden bir URL seçmek için iş uygulaması komut dosyası çalıştırabilir ve bu içeriği sınırlanmış bir çerçevede oluşturabilirsiniz.
  • Private Aggregation API ile gürültülü toplama: Private Aggregation API aracılığıyla siteler arası veriler göndermek ve bir özet rapor döndürmek için bir iş akışı çalıştırabilirsiniz.

Shared Storage API'yi deneyin

URL seçimi çıkış kapısı ve Özel Toplama çıkış kapısı için Shared Storage API test edilebilir. İçerik seçimi Chrome Canary/Dev/Beta M105+ sürümünde test edilebilir. Private Aggregation API ise Chrome M107+ Canary ve Dev sürümlerinde test edilebilir. API, chrome://settings/adPrivacy kapsamındaki tüm Reklam gizliliği API'leri etkinleştirilerek test edilebilir.

Demoyu kullanın

Demo mevcuttur. Kodu GitHub'da inceleyebilirsiniz.

Bu demo, farklı yayıncıların sitelerinde bilgi depolamak isteyen bir reklamveren, reklam teknolojisi, içerik distribütörü veya başka bir üçüncü taraf hizmetinin bakış açısından oluşturulmuştur. Demoda, aynı üçüncü tarafın kodu her kullanım alanı için hem Yayıncı A hem de Yayıncı B sitelerinde çalışır. Verilerin siteler arası bağlamda nasıl paylaşıldığını görmek için yayıncının sayfalarını ziyaret edin.

Demo, içerik seçimi ve Özel Toplama ile ilgili kullanım alanlarını içerir.

İçerik seçimi demosu için Reklam öğelerini dönüşümlü yayınlama, Bilinen müşteriler için kullanım deneyimini özelleştirme ve A/B testi çalıştırma kullanım alanları mevcuttur.

Özel Toplama demosu için benzersiz Tekil erişimi ölçme ve K+ sıklık erişimini ölçme özelliklerini önizleyebilirsiniz. Kullanıcı demografisini ölçün ve

Geliştirici Araçları ile paylaşılan depolama iş akışlarında hata ayıklama

Bulunduğunuz sayfadan başlatılan Paylaşılan Depolama iş akışlarını incelemek için Geliştirici Araçları panelinde "Kaynaklar" sekmesini ziyaret edip "Paylaşılan Depolama İş Akışı / Komut Dosyası İlk İfadesi" etkinlik işleyicisi ayrılma noktasını ekleyebilirsiniz. Bu ayrılma noktası, başlangıçta modül komut dosyası yürütmesini veya kısa ömürlü iş uygulamalarını duraklatır.

Etkinlik düzeyinde işleyici ekleyerek Paylaşılan Depolama iş akışında hata ayıklama.
Ortak Depolama iş akışına bir ayrılma noktası eklenebilir.

Ayrıca chrome://inspect/#shared-storage-worklets sayfasında, tüm sayfalardaki etkin durumdaki tüm Paylaşılan Depolama iş programları gösterilir.

Etkileşimde bulunun ve geri bildirim paylaşın

Paylaşılan Depolama alanı teklifi şu anda etkin bir şekilde tartışılmaktadır ve gelecekte değiştirilebilir. Bu API'yi deneyip geri bildirimde bulunursanız memnuniyet duyarız.