Toplama Hizmeti

Toplama Hizmeti, birleştirilebilir ham raporlardan ayrıntılı dönüşüm verileri ve erişim ölçümleriyle ilgili özet raporlar oluşturur. Reklam teknolojisi sağlayıcı olarak, raporları toplama hizmetine yönlendirmek ve yanıt olarak özet bir rapor almak için istemci tarafındaki iki ana toplu giriş noktası olan Attribution Reporting API ve Private Aggregation API'yi kullanabilirsiniz.

Bu sayfada, deneyimli bir reklam teknolojisi uzmanı olduğunuz varsayılır. Bu sayfada şunlar ele alınır:

• Uygulama durumu
• Temel terimler ve kavramlar
• Toplama kullanım alanları
• Uçtan uca akış
• Toplanabilir raporları toplu olarak işleme
• Cloud bileşenleri

Uygulama durumu

• Toplama Hizmeti artık genel kullanıma sunuldu.
• Toplama Hizmeti, Protected Audience API ve Shared Storage API için Attribution Reporting API ve Private Aggregation API ile kullanılabilir.

Kullanılabilirlik

Teklif	Durum
Bulutlar Arası Gizlilik Bütçesi Hizmeti Açıklama	Kullanılabilir
Attribution Reporting API ve Private Aggregation API'de Amazon Web Services (AWS) için toplama hizmeti desteği Açıklama	Kullanılabilir
Attribution Reporting API, Private Aggregation API genelinde Google Cloud için toplama hizmeti desteği Açıklama	Kullanılabilir
Aggregation Service site kaydı ve çok kaynaklı toplama. Site kaydı, bir sitenin bulut hesaplarıyla (AWS veya GCP) eşlenmesini içerir. Birden fazla kaynağın veri toplamak için bu kaynakların aynı siteden olması gerekir. GitHub'daki SSS Site toplama API dokümanları	Kullanılabilir
Toplama Hizmeti'nin epsilon değeri, farklı parametrelerle ilgili denemeleri ve geri bildirimleri kolaylaştırmak için 64'e kadar bir aralık olarak tutulur. ARA epsilon geri bildirimi gönderin. PAA epsilon geri bildirimi gönderin.	Mevcut. Epsilon aralığı değerleri güncellenmeden önce ekosisteme önceden bildirim göndereceğiz.
Toplama Hizmeti sorguları için daha esnek katkı filtreleme Açıklama	Kullanılabilir
Olağanüstü durumlar (hatalar, yanlış yapılandırmalar vb.) sonrasında bütçeyi kurtarma işlemi Açıklama	Kullanılabilir Bütçe kurtarma özelliğini kullanarak bir reklam teknolojisi tarafından kurtarılan paylaşılan kimliklerin yüzdesini incelemek ve 2025'in ilk yarısı için planlanan aşırı kurtarmalar için gelecekteki kurtarmaları askıya almak için mekanizma
AWS'de Koordinatörlerden biri olarak faaliyet gösteren Accenture Geliştirici Blogu	Kullanılabilir
Google Cloud'da Koordinatörlerden biri olarak faaliyet gösteren bağımsız taraf Geliştirici blogu	Kullanılabilir
Attribution Reporting API'de toplu hata ayıklama raporlaması için Aggregation Service desteği Açıklama	Kullanılabilir

Temel terimler ve kavramlar

İş akışınız için Toplama Hizmeti'ni kullanmayı düşünüyorsanız aşağıdaki terimler ve kavramlar, bu yeni toplama akışının ekibiniz için neler sağlayabileceği hakkında bilgi verebilir.

Terimler sözlüğü

Toplanabilir Raporlar

可汇总的报告是从单个用户设备发送的经过加密的报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和相关指标由广告客户或广告技术平台定义。每个报告均已加密，以防止各方访问底层数据。

详细了解可汇总的报告。

Toplanabilir Rapor Muhasebesi

分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系。

Toplanabilir Rapor Muhasebe Bütçesi

Bağımsız raporların birden fazla kez işlenmediğinden emin olmak için bütçeye yapılan referanslar.

Aggregation Service

Özet rapor oluşturmak için birleştirilebilir raporları işleyen, reklam teknolojisi tarafından işletilen bir hizmet.

Toplama Hizmeti'nin geçmişi hakkında daha fazla bilgiyi açıklamamızda ve tüm şartlar listesinde bulabilirsiniz.

Onay

Genellikle kriptografik karma veya imzalarla yazılım kimliğini doğrulayan bir mekanizma. Toplama hizmeti teklifinde, doğrulama, reklam teknolojisi tarafından işletilen toplama hizmetinizde çalışan kodu açık kaynak kodla eşleştirir.

Onay hakkında daha fazla bilgi edinin.

Katkı Bağlama

Koordinatör

Anahtar yönetimi ve toplanabilir rapor muhasebesinden sorumlu tüzel kişiler. Koordinatör, onaylanmış toplama hizmeti yapılandırmalarının karma oluşturma işlemlerinin listesini tutar ve şifre çözme anahtarlarına erişimi yapılandırır.

Gürültü ve Ölçekleme

Gizliliği korumak ve nihai raporların anonimleştirilmiş ölçüm bilgileri sağlamasını sağlamak için toplama işlemi sırasında özet raporlara eklenen istatistiksel gürültü.

Laplace dağılımından alınan ek gürültü mekanizması hakkında daha fazla bilgi edinin.

Bildirim kaynağı

接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。

Paylaşılan kimlik

shared_info, reporting_origin, destination_site (yalnızca Attribution Reporting API için), source_registration-time (yalnızca Attribution Reporting API için), scheduled_report_time ve sürümden oluşan bir hesaplanmış değer.

shared_info alanında aynı özellikleri paylaşan birden fazla rapor aynı paylaşılan kimliğe sahip olmalıdır. Paylaşılan kimlikler, birleştirilebilir rapor muhasebesinde önemli bir rol oynar.

Güvenilir sunucular hakkında daha fazla bilgi edinin.

Özet Rapor

Attribution Reporting API ve Private Aggregation API rapor türü. Özet rapor, birleştirilmiş kullanıcı verilerini içerir ve gürültü eklenmiş ayrıntılı dönüşüm verileri içerebilir. Özet raporlar, toplu raporlardan oluşur. Özellikle dönüşüm değerleri gibi bazı kullanım alanları için etkinlik düzeyindeki raporlamaya kıyasla daha fazla esneklik sağlar ve daha zengin bir veri modeli sunar.

Güvenilir Yürütme Ortamı (TEE)

计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。

如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。

Toplama kullanım alanları

Reklam ölçümü ve ilgili ölçüm istemci kitaplıkları için aşağıdaki geliştirici yolculuklarını göz önünde bulundurun.

Kullanım alanı	Giriş noktası	Açıklama
Teklif optimizasyonu	Attribution Reporting API (Chrome ve Android)	Teklif optimizasyonu amacıyla dönüşüm sinyallerini beslemek için birleştirilmiş raporları kullanın.
Platformlar arası ölçüm	Attribution Reporting API (Chrome ve Android)	Chrome ve Android genelindeki performansı görmek için web ve uygulama genelinde ölçüm özelliklerini kullanın.
Dönüşüm raporlama	Attribution Reporting API (Chrome ve Android)	Müşterilerin kampanya ihtiyaçlarına göre özelleştirilmiş toplu dönüşüm raporları oluşturun (CTC'ler ve VTC'ler dahil).
Kampanya erişim ölçümü	Shared Storage API ve Private Aggregation API (Chrome)	Kampanya erişimini ölçmek için siteler arası reklam görüntüleme değişkenlerini kullanın.
Demografik grup raporları	Shared Storage API ve Private Aggregation API (Chrome)	Demografiye göre erişimi ölçmek için siteler arası reklam görüntüleme ve demografi bilgilerini kullanın.
Dönüşüm yolu analizi	Shared Storage API ve Private Aggregation API (Chrome)	Toplu dönüşüm yolu analizi yapmak için siteler arası reklam görüntüleme ve dönüşüm değişkenlerini saklayın.
Marka ve dönüşüm artışı	Shared Storage API ve Private Aggregation API (Chrome)	Brand Lift ve artımlılığı ölçmek için test/kontrol grupları ve anket bilgileri hakkında rapor oluşturma.
Açık artırmada hata ayıklama	Protected Audience API ve Private Aggregation API (Chrome)	Hata ayıklama için toplu raporları kullanın.
Tekliflerin dağılımı	Protected Audience API ve Private Aggregation API (Chrome)	Açık artırmalar için teklif değerlerinin dağılımını yakalamak üzere toplu raporları kullanın.

Uçtan uca akış

Aşağıdaki şemada, toplama hizmetinin işleyişi gösterilmektedir. Raporların web ve mobil cihazlardan alındığı andan Özet Rapor'un Toplama Hizmeti'nde oluşturulduğu ana kadar olan uçtan uca akışa odaklanacağız.

1. Şifrelenmiş raporlar oluşturmak için herkese açık anahtarı alın.
2. Şifrelenmiş birleştirilebilir raporlar, toplanması, dönüştürülmesi ve toplu olarak işlenmesi için reklam teknolojisi sunucularına gönderilir.
3. Reklam teknolojisi sunucusu, raporları (avro biçiminde) gruplandırır ve Toplama Hizmeti'ne gönderir. (Bu formu doldurmanız gerekir.)
4. Toplama İşleyici, şifresinin çözülmesi için toplu raporları alır.
5. Toplama Çalışanı, şifre çözme anahtarlarını bir Koordinatör'den alır.
6. Toplama İşleyici, raporların şifresini çözerek raporları toplar ve gürültü ekler.
7. Toplanabilir Rapor Muhasebe Hizmeti, belirli toplanabilir raporlar için özet rapor oluşturmak üzere yeterli gizlilik bütçesi olup olmadığını kontrol eder.
8. Nihai özet raporu gönderin.

Diyagramda, Toplama Hizmeti'nin ana istemci ölçüm API'leriyle (Attribution Reporting API, Private Aggregation API ve Koordinatörler) olan üst düzey ilişkiler gösterilmektedir.

Akış, Attribution Reporting API veya Private Aggregation API gibi ölçüm API'leriyle başlar ve birden fazla tarayıcı örneğinden rapor oluşturur. Chrome, raporları reklam teknolojisi raporlama kaynağınıza göndermeden önce şifrelemek için Koordinatör'deki Anahtar Barındırma Hizmeti'nden herkese açık anahtarı alır. Ortak anahtarlar yedi günde bir döndürülür.

Reklam teknolojisi raporlama kaynağınız, gelen raporları toplayıp avro biçimine dönüştürecek ve toplu raporlama stratejilerinde açıklandığı şekilde toplama hizmetinize gönderecek şekilde yapılandırılmalıdır.

Hazır bir toplu işleme grubunuz olduğunda Toplama Hizmeti'ne bir toplu işleme isteği gönderirsiniz. Toplama Hizmeti, Anahtar Barındırma Hizmeti'nden şifre çözme anahtarlarını alır, raporların şifresini çözer ve özet rapor oluşturmak için raporları toplar ve gürültü ekler. Bu, bunları oluşturmak için yeterli gizlilik bütçesinin bulunmasına bağlıdır.

Raporların toplandığı reklam teknolojisi raporlama kaynak uç noktasını barındırırsınız ve Toplama Hizmeti, reklam teknolojisi bulutunuzda dağıtılır.

Toplanabilir raporları gruplandırma

Raporlama akışı, belirlenen raporlama kaynak sunucusunun yardımı olmadan tamamlanamaz. Bu, kayıt sürecinde gönderdiğiniz kaynaktır. Raporlama kaynağı, aldığı birleştirilebilir raporları toplamaktan, dönüştürmekten, toplu olarak paketlemekten ve Google Cloud veya Amazon Web Services'deki toplama hizmetinize gönderilmeye hazırlamaktan sorumludur. Toplanabilir raporlarınızı hazırlama hakkında daha fazla bilgi edinin.

Genel konsepti anladığınıza göre, toplama hizmetinizde dağıtılan bileşenlere daha yakından bakabiliriz.

Cloud bileşenleri

Toplama Hizmeti, çeşitli bulut hizmeti bileşenlerinden oluşur. Gerekli tüm bulut hizmeti bileşenlerini sağlamak ve yapılandırmak için sağlanan Terraform komut dosyalarını kullanırsınız.

Ön Uç Hizmeti

Yönetilen Bulut Hizmeti: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

Ön uç hizmeti, iş oluşturma ve iş durumu alma için Aggregation API çağrılarının birincil giriş noktası olan sunucusuz bir ağ geçididir. Toplama Hizmeti kullanıcılarından gelen istekleri alma, giriş parametrelerini doğrulama ve toplama işi planlama sürecini başlatma işlemlerinden sorumludur.

Ön uç hizmetinde iki API kullanılabilir:

Uç nokta	Açıklama
createJob	Bu API, bir Aggregation Service işini tetikler. İşi tetiklemek için iş kimliği, giriş depolama alanı ayrıntıları, çıkış depolama alanı ayrıntıları, raporlama kaynağı ve daha fazlası gibi bilgiler gerekir.
getJob	Bu API, belirtilen iş kimliğine sahip işin durumunu döndürür. İşin durumuyla ilgili bilgi sağlar (ör. "Alındı", "Devam Ediyor" veya "Bitti"). İş tamamlandıysa iş yürütme sırasında karşılaşılan hata mesajları da dahil olmak üzere iş sonucunu da döndürür.

Aggregation Service API dokümanlarına göz atın.

İş Sırası

Yönetilen Bulut Hizmeti: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

İş sırası, toplama hizmeti için iş isteklerini içeren bir mesaj sırasıdır. Kullanıcı Arayüzü Hizmeti, iş isteklerini sıraya ekler. Bu istekler daha sonra bunları işleyen Toplama Çalışanları tarafından kullanılır.

Cloud Storage

Yönetilen Bulut Hizmeti: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

Toplama Hizmeti tarafından kullanılan giriş ve çıkış dosyaları (ör. şifrelenmiş rapor dosyaları ve çıkış özeti raporları) bulut depolama alanında tutulur.

İş Meta Verileri Veritabanı

Yönetilen Bulut Hizmeti: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

İş Meta Verileri Veritabanı, toplama işlerinin durumunu depolamak ve izlemek için kullanılır. Oluşturma zamanı, istenen zaman, güncellenen zaman gibi meta verileri ve Alındı, Devam Ediyor veya Bitti gibi durumları kaydeder. Toplama çalışanları, işler ilerledikçe İş Meta Verileri Veritabanı'nı günceller.

Toplama Çalışanı

Yönetilen Bulut Hizmeti: Gizli alan içeren Compute Engine (Google Cloud) / Nitro Enclave içeren Amazon Web Services EC2 (Amazon Web Services)

Toplama İşleyicisi, İş Sırası'ndaki iş isteklerini işler ve Koordinatörlerdeki Anahtar Oluşturma ve Dağıtım Hizmeti'nden (KGDS) aldığı anahtarları kullanarak şifrelenmiş girişlerin şifresini çözer. Toplama çalışanları, iş işleme gecikmesini en aza indirmek için şifre çözme anahtarlarını 8 saat boyunca önbelleğe alır ve işledikleri işlerde kullanır.

Toplama işçileri, bir Güvenilir Yürütme Ortamı (TEE) örneğinde çalışır. Çalışanlar aynı anda yalnızca bir işi işler. Otomatik ölçeklendirme yapılandırmasını ayarlayarak birden fazla çalışanı işleri paralel olarak işlemesi için yapılandırabilirsiniz. Kullanılırsa otomatik ölçeklendirme, çalışan sayısını iş kuyruğundaki mesaj sayısına göre dinamik olarak ayarlar. Terraform ortam dosyası üzerinden otomatik ölçeklendirme için minimum ve maksimum çalışan sayısını yapılandırabilirsiniz. Otomatik ölçeklendirme hakkında daha fazla bilgiyi şu Terraform komut dosyalarında bulabilirsiniz: Amazon Web Services veya Google Cloud.

Toplayıcı çalışanlar, birleştirilebilir rapor muhasebesi için birleştirilebilir rapor muhasebe hizmetini çağırır. Bu hizmet, işlerin yalnızca gizlilik bütçesi sınırı aşılmışsa çalıştırılmasını sağlar. ("Kopya yok" kuralı bölümüne bakın.) Bütçe mevcutsa gürültülü toplamlar kullanılarak bir özet raporu oluşturulur. Toplanabilir rapor muhasebesi ile ilgili ek bilgileri okuyun.

Toplama işleyicileri, iş meta verilerini İş Meta Verileri Veritabanı'nda günceller. Bu bilgiler arasında, kısmi rapor hataları durumunda iş döndürme kodları ve rapor hata sayaçları yer alır. Kullanıcılar, getJob iş durumu alma API'sini kullanarak durumu getirebilir.

Toplama Hizmeti'nin daha ayrıntılı bir açıklaması için bu açıklamayı inceleyin.

Sonraki adımlar

Toplama Hizmeti'nin öne çıkan özelliklerini gördünüz. Şimdi Google Cloud veya Amazon Web Services üzerinden kendi Toplama Hizmeti örneğinizi dağıtma zamanı. Toplama Hizmeti'ni kullanma hakkında daha fazla bilgi edinmek için başlangıç bölümüne göz atın veya bu bağlantıyı takip edin.

Sorun giderme

Hata mesajlarının ayrıntılı açıklamaları, karşılaştığınız hataya neyin neden olmuş olabileceği ve azaltmaya yönelik sonraki adımlar için Yaygın hata kodları ve azaltma yöntemleri belgesine bakın.

Destek alma ve geri bildirim sağlama

• Ürünle ilgili sorular, geri bildirimler ve özellik istekleri için GitHub depomuzda bir sorun kaydı oluşturun.
• Toplama Hizmeti ile iş dağıtırken, işlerde çalışırken veya işler çalıştırırken hata alıyorsanız teknik sorun giderme desteği istemek için bu Teknik Destek Formu'nu kullanın.
• Bilinen sorunlar için Herkese Açık Durum Kontrol Paneli'ni kontrol edin.