Shared Storage'a genel bakış

Gizliliği koruyan okuma erişimiyle siteler arası sınırsız depolama alanına yazma erişimine izin verin.

Uygulama durumu

Bu belgede, bölümlendirilmemiş, siteler arası bir depolama alanı teklifi özetlenmektedir: Paylaşılan Depolama API'si.

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

Neden bu API'ye 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ümlendirir. Bununla birlikte, bölümlendirilmemiş depolamaya dayanan bazı geçerli kullanım alanları, yeni web API'lerinin yardımı olmadan imkansızdır. Örneğin, bir içerik üreticisi, siteler arası tanımlayıcılara dayanarak farklı sitelerdeki erişimi ölçmek isteyebilir.

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

Paylaşılan Depolama Alanı verilerini iki şekilde kullanabilirsiniz:

Bu kimin için?

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

  • Reklam teknolojileri şu anda üçüncü taraf çerezlerini temel alan kampanya erişimini ölçebilir, sıklık sınırları ayarlayabilir ve reklam öğelerini dönüşümlü yayınlayabilir.
  • Ödeme sağlayıcılar, bir kullanıcının mevcut müşteri olup olmadığını belirleyip ödeme deneyimini uyarlayabilir.
  • Web güvenliği şirketleri, şüpheli veya tehlikeli davranışları işaretlemek için özel bir 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'nin birçok kullanım alanını desteklemesi amaçlanarak, üçüncü taraf çerezleri için mevcut olan çeşitli kullanımların yerini alır. Bu hizmet ve özellikler arasında aşağıdakiler bulunmaktadır:

Kullanım alanı Açıklama Çıkış kapısı
Reklam öğelerini dönüşümlü yayınlama Kullanıcıların farklı sitelerde hangi reklam öğesini gördüğünü belirlemek için reklam öğesi kimliği, görüntüleme sayıları ve kullanıcı etkileşimi gibi verileri depolayabilirsiniz. Bu sayede görüntülemeler arasında denge kurabilir ve belirli içeriklerin aşırı doygunluğunu önleyebilirsiniz. Bu da olumsuz kullanıcı deneyimini önlemenize yardımcı olabilir. URL seçimi
A/B testini çalıştırma Bir deneme grubuna kullanıcı atayabilir, ardından bu grubu siteler arasında erişmek üzere paylaşılan bir depolama alanında saklayabilirsiniz. URL seçimi
Bilinen müşteriler için kullanıcı deneyimini özelleştirme Bir kullanıcının kayıt durumuna veya diğer kullanıcı durumlarına göre özel içerik ve harekete geçirici mesaj paylaşabilirsiniz. URL seçimi
Kötüye kullanım karşıtı çözümler Kötüye kullanımla mücadele, sahtekarlıkla mücadele ve web güvenliği kuruluşları, kötü amaçlı kullanıcıları (otomatik botlar veya zarar vermeye çalışan gerçek kişiler) tespit etmek için genellikle tescilli tekniklerden yararlanır. Burada, kullanıcı güvenilirliği derecelendirmesini kodlamak için URL Seçim çıkış kapısı veya anormallik algılama için veri kümeleri oluşturmak amacıyla Özel Toplama çıkış kapısı gibi 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 üreticisi 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üğünü rapor etmek ve aynı kullanıcının farklı bir sitede yinelenen şekilde sayılmasını önlemek için Paylaşılan Depolama Alanı'nı kullanabilirsiniz. Böylece, yaklaşık tekil erişiminiz hakkında toplu, gürültülü bir rapor elde edersiniz. Private Aggregation API
Kullanıcı demografisini ölçme İçerik üreticileri genellikle kitlelerinin demografisini anlamak isterler. Paylaşılan depolama alanını, kullanıcı demografik verilerini sahip olduğunuz bir bağlamda (ör. birinci taraf siteniz) kaydetmek için paylaşılan depolama alanını kullanabilir ve yerleşik içerik gibi diğer birçok sitede bu veriler hakkında rapor oluşturmak için toplu raporlardan yararlanabilirsiniz. Private Aggregation API
K+ sıklık erişimini ölçme Bazen "etkili sıklık" olarak tarif edilerek, bir kullanıcının belirli içeriği (genellikle reklam görüntülemeleri bağlamında) tanıması veya hatırlaması için genellikle bir minimum görüntüleme sayısı söz konusudur. Bir içeriği en az K kez gören benzersiz kullanıcılarla ilgili raporlar oluşturmak için Paylaşılan Depolama'yı kullanabilirsiniz. Private Aggregation API

Teklif, gelecekte ortaya çıkabilecek birçok kullanım alanını destekleyen genel amaçlı bir API oluşturmayı amaçlamaktadır. Bu sayede, daha fazla deneme ve değişiklik yaparak web ekosistemiyle birlikte büyüyebiliyoruz.

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

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

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

İş akışları, iş mantığınızı eklediğiniz yerdir. İş uygulamasının içinde, Shared Storage'daki bir değeri okumanıza ve işlemenize izin verilir ancak tam değeri doğrudan iş akışı çağrısına döndüremezsiniz. İş akışından faydalı bilgileri çıkarmak için bir dizi "kapı" bulunur. Şu anda iki kapı mevcuttur ancak ileride daha fazlası eklenebilir.

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

  • Siteler arası URL seçimi: Sağlanan listeden bir URL'yi, depolanan verilere dayanarak seçmek için bir iş uygulaması komut dosyası çalıştırabilir, ardından bu içeriği sınırlı bir çerçevede oluşturabilirsiniz.
  • Private Aggregation API ile gürültülü toplama: Private Aggregation API üzerinden siteler arası veri göndermek ve özet raporu döndürmek için bir iş uygulaması çalıştırabilirsiniz.

Shared Storage API'yi deneyin

URL seçimi çıkış kapısı için Paylaşılan Depolama API'si ve Özel Toplama çıkış kapısı test için kullanılabilir. İç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://flags/#privacy-sandbox-ads-apis adresinde Özel Korumalı Alan Reklamları API'leri denemesi işareti etkinleştirilerek test edilebilir.

Bu API'leri kullanmak için Özel Korumalı Alan Reklamları API'leri denemesini etkin olarak ayarlayın.

Demoyu kullan

Bir demo mevcuttur ve kodu GitHub'da inceleyebilirsiniz.

Bu demo, bilgileri farklı yayıncıların sitelerinde depolamak isteyen bir reklamveren, reklam teknolojisi, içerik distribütörü veya başka bir üçüncü taraf hizmeti açısından oluşturulmuştur. Demoda, her kullanım alanı için hem Yayıncı A hem de Yayıncı B sitesinde aynı üçüncü tarafın kodu ç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 gizli toplama için kullanım alanları 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.

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

Geliştirici Araçları ile Paylaşılan Depolama İş Yüklerinde hata ayıklama

Bulunduğunuz sayfadan başlatılan Paylaşılan Depolama iş akışlarını incelemek için DevTools panelindeki "Kaynaklar" sekmesini ziyaret edip "Paylaşılan Depolama İş Akışı / Komut Dosyası İlk İfadesi" etkinlik işleyici kesme noktasını ekleyebilirsiniz. Bu ayrılma noktası, başlangıçta ilk modül komut dosyası yürütme işlemini 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.
Paylaşılan Depolama iş akışına bir ayrılma noktası eklenebilir.

Buna ek olarak, chrome://inspect/#shared-storage-worklets sayfasında tüm sayfalardaki etkin durumdaki tüm Paylaşılan Depolama iş uygulamaları 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.