Toplama Hizmeti

Toplama Hizmeti, ayrıntılı dönüşüm verilerinin özet raporlarını ve toplanabilir ham raporlardan erişim ölçümleri oluşturur. Reklam teknolojilerinin istemci tarafında, Toplama Hizmeti'ne yönelik dönüşüm hunisi raporlarına giden iki ana giriş noktası bulunur. Bu giriş noktaları Attribution Reporting API veya Private Aggregation API üzerinden yapılır.

Uygulama durumu

Kullanılabilirlik

Teklif Durum
Attribution Reporting API ve Private Aggregation API genelinde Amazon Web Services (AWS) için Toplama Hizmeti desteği
Açıklayıcı		 Kullanılabilir
Attribution Reporting API ve Private Aggregation API genelinde Google Cloud için toplama hizmeti desteği
Açıklayıcı		 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'da SSS
Site Aggregate API belgeleri 		Kullanılabilir
Toplama Hizmeti'nin epsilon değeri, farklı parametrelerle ilgili deneme ve geri bildirim yapılmasını kolaylaştırmak için en fazla 64 olacak şekilde tutulacaktır.
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çıklayıcı		 Kullanılabilir
Olağanüstü durum (hatalar, yanlış yapılandırmalar vb.) sonrası bütçe kurtarma süreci
Açıklayıcı		 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'deki 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 Raporları için Toplama Hizmeti desteği
Açıklayıcı		 Kullanılabilir

Temel terimler ve kavramlar

Reklam teknolojisi iş akışınızda Toplama Hizmeti'ni kullanmayı düşünüyorsanız aşağıdaki şartlar ve kavramlar, bu yeni toplama akışının ekibinize sunabileceği avantajlar hakkında daha fazla bilgi edinmenizi sağlar:

Term Description
Aggregation Service An ad tech-operated service that processes aggregatable reports to create a summary report.
Aggregatable Reports

Aggregatable reports are encrypted reports sent from individual user devices. These reports contain data about cross-site user behavior and conversions. Conversions (sometimes called attribution trigger events) and associated metrics are defined by the advertiser or ad tech. Each report is encrypted to prevent various parties from accessing the underlying data.

Learn more about aggregatable reports.
Aggregatable Report Accounting A distributed ledger located in both coordinators that tracks allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures that no report passes through Aggregation Service beyond the allocated privacy budget. Read more on batching strategies on how it relates to aggregatable reports.
Aggregatable Report Accounting Budget References to the budget that ensures reports are not processed more than once.
Trusted Execution Environment (TEE)

A trusted execution environment is a special configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the computer. TEEs allow external parties to verify that the software does exactly what the software manufacturer claims it does—nothing more or less.

To learn more about TEEs used for the Privacy Sandbox proposals, read the Protected Audience API services explainer and the Aggregation Service explainer.
Coordinators

A coordinator is an entity responsible for key management and aggregatable report accounting. The coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.
Shared ID Computed value that consists of: shared_info, reporting_origin, destination_site (available for Attribution Reporting API only), source_registration-time (available for Attribution Reporting API only), scheduled_report_time, version. This means that multiple reports belong to the same shared ID should they share the same attributes of the shared_info field. This plays an important role within Aggregatable Report Accounting. Read more about Trusted Servers.
Summary Report

A summary report is an Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data and can contain detailed conversion data, with noise added. Summary reports are made up of aggregate reports. Summary reports allow for greater flexibility and a richer data model than event-level reporting, particularly for some use-cases like conversion values.
Reporting Origin

The reporting origin is the entity that receives aggregatable reports—in other words, the ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. This reporting origin should be designated during enrollment.
Contribution Bonding Aggregatable reports may contain an arbitrary number of counter increments. For example, a report may contain a count of products that a user has viewed on an advertiser's site. The sum of increments in all aggregatable reports related to a single source event must not exceed a given limit, `L1=2^16`. Learn more in the aggregatable reports explainer.
Noise & Scaling A certain amount of statistical noise is added to summary reports as a part of the aggregation process that also functions to preserve privacy and ensure the final reports provide anonymized measurement information. Read more about additive noise mechanism, which is drawn from Laplace distribution.
Attestation

Attestation is a mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in the ad tech-operated aggregation service with the open source code.

Read more about attestation.

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

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'deki performansı görmek için web'deki ve uygulamalar arası ö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 raporlama Shared Storage API ve Private Aggregation API (Chrome) Demografiye göre erişimi ölçmek için siteler arası reklam görünümünü ve demografik bilgileri 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. Web ve mobilden raporların alınmasından Toplama Hizmeti'nde özet raporların oluşturulmasına kadar olan uçtan uca akışa odaklanacağız.

Uçtan Uca Toplama Hizmeti akışı

  1. Şifrelenmiş raporlar oluşturmak için herkese açık anahtarı alın.
  2. Toplanacak, dönüştürülecek ve toplu olarak gönderilecek şekilde reklam teknolojisi sunucularına gönderilen şifrelenmiş, birleştirilebilir raporlar.
  3. Reklam teknolojisi sunucusu, raporları toplu olarak (avro biçimi) ve dağıtılan toplama hizmetine gönderir. (Reklam teknolojisi tarafından doldurulmalıdır).
  4. Şifre çözmek için toplu raporları alın.
  5. Şifre çözme anahtarlarını koordinatörlerden alın.
  6. Aggregation Service, 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 kalan gizlilik bütçesi olup olmadığını kontrol eder.
  8. Nihai özet raporunu gönderin.

Diyagramda, toplama hizmetinin ana istemci ölçüm API'leri Attribution Reporting API, Private Aggregation API ve koordinatörlerle olan genel ilişkisini görebilirsiniz.

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

Reklam teknolojisinin raporlama kaynağı bu raporları aldıktan sonra, raporlama kaynağı bu raporları toplayıp avro biçimine dönüştürecek ve dağıtılan toplama hizmeti örneğine gönderecek şekilde yapılandırılmalıdır. Gruplandırma stratejilerine göz atın.

Reklam teknolojisi toplu işlem yapmaya hazır olduğunda, raporların şifresi Anahtar Barındırma Hizmeti'nden şifre çözme anahtarları alınarak çözüldükten sonra, bir özet rapor oluşturmak için birleştirilir ve gürültü eklenir. Bu işlemin, nihai özet raporları oluşturmak için yeterli gizlilik bütçesi olup olmadığına bağlı olduğunu unutmayın.

Raporların toplandığı reklam teknolojisi raporlama kaynağı uç noktası reklam teknolojisi tarafından barındırılır ve Toplama Hizmeti, reklam teknolojisinin bulutunda dağıtılır.

Toplanabilir raporları toplu olarak işleme

Raporlama akışı, belirtilen raporlama kaynak sunucusunun yardımı olmadan tamamlanmaz. Bu, reklam teknolojisinin kayıt sürecinde gönderdiği kaynaktır. Raporlama kaynağının sorumlu olduğu temel işlemler, alınan birleştirilebilir raporları toplama, dönüştürme ve toplu olarak bir araya getirme ve bunları reklam teknolojisinin Google Cloud veya Amazon Web Services'de dağıtılan Toplama Hizmeti'ne gönderilmeye hazırlamaktır. Toplanabilir raporlarınızı hazırlama hakkında daha fazla bilgi edinin.

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

Cloud bileşenleri

Toplama Hizmeti, çeşitli bulut hizmeti bileşenlerinden oluşur. Sağlanan Terraform komut dosyaları, gerekli tüm bulut hizmeti bileşenlerini sağlar ve yapılandırır.

Toplama Hizmeti bulut bileşenleri

Ön Uç Hizmeti

Yönetilen Bulut Hizmeti: Cloud Functions İşlevi (Google Cloud) / API Ağ Geçidi (Amazon Web Services)

Ön Uç Hizmeti, iş oluşturma ve iş durumu alma için Aggregation API çağrılarının giriş noktası olarak işlev gören sunucusuz bir ağ geçididir. Toplama Hizmeti kullanıcılarından istek almak, giriş parametrelerini doğrulamak ve toplama işi planlama sürecini başlatmaktan sorumludur.

Ön Uç Hizmeti'nde iki API kullanılabilir:

Uç nokta Açıklama
createJob Bu API, bir Aggregation Service işini tetikler. Bir iş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 bir iş kimliği için işin durumunu döndürür. İşin durumuyla ilgili "Alındı", "Devam Ediyor" veya "Tamamlandı" gibi bilgiler sağlar. Ayrıca, iş tamamlanırsa işin yürütülmesi sırasında karşılaşılan hata mesajlarıyla birlikte işin sonucu gösterilir.

Aggregation Service API Belgeleri'ni inceleyin.

İş Sırası

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

İş Sırası, Toplama Hizmeti için iş isteklerini depolayan bir mesaj sırasıdır. Görsel Katman Hizmeti, iş isteği mesajlarını sıraya ekler. Bu mesajlar daha sonra iş isteğini işlemek için Toplama Çalışanı tarafından kullanılır.

Cloud Storage

Yönetilen Bulut Hizmeti: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) Cloud Storage, Toplama Hizmeti tarafından kullanılan giriş ve çıkış dosyalarını (ör. şifrelenmiş rapor dosyaları, çıkış özeti raporları) depolamak için kullanılır.

İş Meta Verileri Veritabanı

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

İş Meta Verileri Veritabanı, toplama işlerinin durumunu depolar ve izler. Veritabanı, oluşturma zamanı, istenen zaman, güncellenme zamanı ve durum (ör. Alındı, Devam Ediyor, Bitti vb.) gibi meta verileri kaydeder. Toplama Çalışanı, iş ilerledikçe İş Meta Veri 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 İşleyici, İş Sırası'ndaki bir iş isteği tarafından başlatılan iş isteklerini işler ve koordinatörlerdeki Anahtar Oluşturma ve Dağıtım Hizmeti'nden (KGDS) alınan anahtarları kullanarak şifrelenmiş girişlerin şifresini çözer. İş işleme gecikmesini en aza indirmek için şifre çözme anahtarları, Aggregation Worker'da 8 saat boyunca önbelleğe alınır ve bu çalışan örneği tarafından işlenen işlerde kullanılabilir.

Çalışan, bir Trusted Execution Environment (TEE) örneğinde çalışır. Her çalışan aynı anda yalnızca bir işi işler. Reklam teknolojisi, otomatik ölçeklendirme yapılandırmasını ayarlayarak birden fazla çalışanı işleri paralel olarak işleyecek şekilde yapılandırabilir. Otomatik ölçeklendirme sayesinde çalışan sayısı, iş kuyruğunda kalan mesaj sayısına göre dinamik olarak ayarlanır. Otomatik ölçeklendirme için minimum ve maksimum çalışan sayısı Terraform ortam dosyası üzerinden yapılandırılabilir. Otomatik ölçeklendirme hakkında daha fazla bilgiyi aşağıdaki terraform komut dosyalarında bulabilirsiniz. [Amazon Web Services / Google Cloud]

Toplama Çalışanı, toplanabilir rapor hesabı için Toplanabilir Rapor Muhasebesi hizmetini çağırır. Toplanabilir rapor muhasebe hizmeti, işlerin yalnızca gizlilik bütçesi sınırını aşmadığı sürece çalıştırılmasını sağlar. ("Yinelenen yok" kuralı bölümüne bakın). Bütçe varsa gürültülü toplamalar kullanılarak bir özet rapor oluşturulur. Toplanabilir rapor muhasebesi ile ilgili ek bilgileri okuyun.

Toplama Çalışanı, uygun iş dönüş kodları ve kısmi rapor hataları durumunda rapor hata sayaçları dahil olmak üzere İş Meta Veri Veritabanı'ndaki iş meta verilerini günceller. Kullanıcılar, iş durumu alma API'sini (getJob) kullanarak durumu getirebilir.

Toplama Hizmeti hakkında daha ayrıntılı bilgi için açıklamamıza başvurun.

Sonraki adımlar

Toplama Hizmeti'yle ilgili önemli bilgileri edindiğinize göre artık Google Cloud veya Amazon Web Services aracılığıyla size ait Toplama Hizmeti örneğinizi dağıtmanın zamanı geldi. Başlangıç bölümüne göz atın. Dağıtılmış bir Toplama Hizmeti'nin nasıl çalıştırılacağı hakkında daha fazla bilgiye ihtiyacınız varsa Toplama Hizmeti'ni çalıştırma hakkında daha fazla bilgi edinmek için bu bağlantıyı izleyin.

Sorun giderme

Hata mesajlarıyla ilgili daha ayrıntılı açıklamalar, karşılaştığınız hatanın nedeni ve sorunun çözümüne yönelik sonraki adımlar için Sık karşılaşılan hata kodları ve çözümleri dokümanımıza göz atın.

Destek alma ve geri bildirim sağlama