Toplama Hizmetine genel bakış

Attribution Reporting API veya Private Aggregation API için özet raporlar oluşturmak amacıyla bu hizmeti dağıtıp yönetin.

Toplanabilir verileri işlemek için bir Toplama Hizmeti'ni dağıtma ve yönetme Attribution Reporting API veya Private Aggregation API özet rapor oluşturabilirsiniz.

Uygulama durumu

Açıklayıcı, anahtar terimler, anlamanıza yardımcı olan bir belgedir.

Kullanılabilirlik

Teklif Durum
Attribution Reporting API ve Private Aggregation API genelinde Amazon Web Services (AWS) için Toplama Hizmeti desteği
Explainer		 Kullanılabilir
Attribution Reporting API genelinde Google Cloud için Toplama Hizmeti desteği, Private Aggregation API
Explainer		 Beta sürümde kullanılabilir
Toplama Hizmeti site kaydı ve bir sitenin bulut hesaplarına (AWS veya GCP) eşlenmesi
GitHub'da SSS		 Kullanılabilir
Toplama Hizmeti'nin epsilon değeri, deneme yapmayı ve farklı parametrelerle ilgili geri bildirimi kolaylaştırmak için 64'e kadar bir aralıkta tutulur.
ARA epsilon geri bildirimi gönderin.
PAA epsilon geri bildirimi gönderin.		 Mevcut. Epsilon aralık değerleri güncellenmeden önce ekosisteme önceden bildirimde bulunacağız.
Toplama Hizmeti sorguları için daha esnek katkı filtreleme
Açıklama		 2024'ün 2. çeyreği bekleniyor
Afet sonrasında bütçe kurtarma süreci (hatalar, yanlış yapılandırmalar vb.)
GitHub sorunu		 2024'ün 2. çeyreği bekleniyor
Accenture, AWS
Geliştirici Blogu'nda koordinatörlerden biri olarak çalışıyor.		 Kullanılabilir
Google Cloud
Geliştirici Blogu'nda koordinatörlerden biri olarak faaliyet gösteren bağımsız taraf		 2024'ün 3. çeyreği bekleniyor

Güvenli veri işleme

Toplama Hizmeti, toplanabilir raporlardan toplanan verilerin şifresini çözer ve birleştirir, gürültü ekler ve nihai özet raporu döndürür. Bu hizmet, verilerin korunması için gerekli güvenlik önlemlerini destekleyen bir bulut hizmetine dağıtılan güvenilir yürütme ortamında (TEE) çalışır.

TEE'nin kodu, Toplama Hizmeti'nde ham raporlar. Bu kod güvenlik araştırmacıları, gizlilik ve güvenlik destekçileri ve reklam teknolojileri kastedilmektedir. TEE'nin tam olarak onaylanan ve verilerin güvende kalmasını sağladığına karar verirken bir koordinatör onay alır.

Toplanabilir raporlar toplanır, toplu hale getirilir ve nihai bir özet rapora dönüştürülmek üzere TEE'ye gönderilir.
Toplanabilir raporlar bir TEE üzerinde çalıştırılarak toplanır, toplu hale getirilir ve Toplama Hizmeti'ne gönderilir. Toplama Hizmeti ortamı, verileri toplayan aynı tarafa ait ve aynı tarafça işletilir.

TEE'nin koordinatör onayı

Koordinatör, anahtar yönetiminden ve birleştirilebilir anahtardan sorumlu bir tüzel kişidir raporlamaz.

Koordinatörün birkaç sorumluluğu vardır:

  • Yetkilendirilmiş ikili görüntülerin listesini tutun. Bu resimler şifreleme karmaları genel olarak düzenli olarak düzenlediği Toplama Hizmeti yazılımı derlemelerinin kullanabilirsiniz. Taraflardan birinin resimleri doğrulayabilmesi için bu tekrar oluşturulabilir. toplama hizmeti derlemeleriyle aynıdır.
  • Anahtar yönetim sistemi işletmelisiniz. Chrome için şifreleme anahtarları gerekir şifrelemenin kullanıldığı bir etkinlik oluşturabilirsiniz. Şifre çözme anahtarları: Toplama Hizmeti kodunun ikili görüntülerle eşleştiğini kanıtlamak için gereklidir.
  • Özet için toplamada yeniden kullanımı önlemek üzere birleştirilebilir raporları takip etme yeniden kullanım, kişisel verileri ifşa edici bilgileri (PII) ortaya çıkarabilir.

"Yinelenen yok" kural

Belirli bir özetlenebilir raporun içeriğiyle ilgili bilgi edinmek için saldırganların bu raporun birden çok kopyasını oluşturabilir ve bu kopyaları bir veya daha fazla grup oluşturabilirsiniz. Bu nedenle, Toplama Hizmeti, verileri toplamak için "yinelenen yok" kural:

  • Grupta: Toplanabilir rapor grup içinde yalnızca bir kez görünebilir.
  • Gruplar genelinde: Toplanabilir raporlar birden fazla grupta gösterilemez veya birden fazla özet raporuna katkıda bulunamaz.

Tarayıcı bunu yapmak için her bir toplanabilir rapora paylaşılan bir kimlik atar. Tarayıcı, paylaşılan kimliği aşağıdakileri de içeren çeşitli veri noktalarından oluşturur: API sürüm, raporlama kaynağı, hedef site, kaynak kayıt zamanı ve planlanmış rapor zamanı. Bu veriler, Google Ads'in shared_info alanına sahip olursunuz.

Toplama Hizmeti, paylaşılan kimlikler aynı grupta yer alır ve paylaşılan kimlikler Kimlik işlendi. Aynı kimlikle birden fazla grup oluşturulursa yalnızca bir grubu toplama için kabul edilebilir ancak diğer gruplar reddedilir.

Hata ayıklama çalıştırması yaptığınızda, “yineleme yok” kuralı gruplarda zorunlu kılınmaz. Başka bir deyişle, önceki gruplardaki raporlar hata ayıklama çalıştırmasında görünebilir. Ancak kural, ancak grup içinde uygulanmaya devam eder. Bu sayede hizmetle denemeler yapabilirsiniz. ve çeşitli toplu işleme stratejilerini bir araya getirerek üretim ortamıyla ilgili.

Gürültü ve ölçeklendirme

Kullanıcı gizliliğini korumak için, Toplama Hizmeti, ekleme gürültü mekanizması verileri toplayabilirsiniz. Bu da projenizin belirli bir İstatistiksel gürültü, her bir toplam değere Özet raporu.

Gürültünün eklenme yöntemleri üzerinde doğrudan kontrol sahibi olmasanız da gürültünün ölçüm verileri üzerindeki etkisini etkileyebilir.

Gürültü, toplam değerden bağımsız olarak sabittir.

Gürültü değeri, rastgele bir değerden Gecikme olasılığı dağılımı, ve aynı verileri topladığımız veri miktarı ne olursa olsun toplu e-tablo kullanabilirsiniz. Ne kadar çok veri toplarsanız gürültünün etkisi o kadar az olur temel bilgileri ele alacağız. Birleştirilebilir raporu kullanarak bir ölçeklendirme faktörüne göre derecelendirilir ve bu da gürültünün etkisini azaltır.

Gürültünün nasıl eklendiğini, kontrollerinizi ve daha fazla bilgi için Gürültüyle çalışma başlıklı makaledeki katkı bütçesi ve katkı bütçesine göre ölçekleme başlıklı makaleyi inceleyin.

Özet raporlar oluşturma

Özet rapor oluşturma işlemi API kullanımınıza bağlıdır. Daha fazla bilgi: Private Aggregation API ve Attribution Reporting API.

Toplama Hizmeti'ni test etme

Test ettiğiniz her API için ilgili kılavuzu okumanızı öneririz:

Toplama Hizmeti'ni test etmek için codelab'lerimizi deneyin:

Attribution Reporting ve Private Aggregation API için toplanabilir raporları işlemek amacıyla bir yerel test aracı da mevcuttur.

Toplama Hizmeti Yük Testi Çerçevesi, önerilen bir test çerçevesi sağlar.

Etkileşimde bulunun ve geri bildirim paylaşın

Toplama Hizmeti, Özel Korumalı Alan ölçüm API'lerinin temel bir parçasıdır. Diğer Özel Korumalı Alan API'lerinde olduğu gibi bu da GitHub'da herkese açık olarak belgelenip tartışılır.