Toplama Hizmeti, toplu olarak derlenebilen ham raporlardan ayrıntılı dönüşüm verileri ve erişim ölçümleri içeren özet raporlar oluşturur. Reklam teknolojilerinin, raporları Attribution Reporting API veya Private Aggregation API aracılığıyla toplama hizmetine yönlendirmek için istemci tarafında iki ana toplu giriş noktası vardır.
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 |
|---|---|
| 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 terimler ve kavramlar, bu yeni toplama akışının ekibiniz için neler sağlayabileceği hakkında daha fazla bilgi verebilir:
| Term | Description |
|---|---|
| Aggregation Service | An ad tech-operated service that processes aggregatable reports to create a summary report. |
| Aggregatable Reports |
Birleştirilebilir raporlar, kullanıcıların cihazlarından tek tek gönderilen şifrelenmiş raporlardır. Bu raporlar, siteler arası kullanıcı davranışı ve dönüşümlerle ilgili veriler içerir. Dönüşümler (bazen ilişkilendirme tetikleyici etkinlikleri de denir) ve ilişkili metrikler, reklamveren veya reklam teknolojisi tarafından tanımlanır. Her bir rapor, çeşitli tarafların temel verilere erişmesini engellemek için şifrelenir. 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 |
Koordinatör, kilit yönetiminden ve birleştirilebilir rapor muhasebesinden sorumlu bir tüzel kişidir. Koordinatör, onaylanmış toplama hizmeti yapılandırmalarının karmalarının listesini tutar ve şifre çözme anahtarlarına erişimi yapılandırır. |
| 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 |
Özet raporu, Attribution Reporting API ve Private Aggregation API rapor türüdür. Özet raporu, birleştirilmiş kullanıcı verilerini içerir ve gürültü eklenmiş olarak ayrıntılı dönüşüm verileri içerebilir. Özet raporlar, toplu raporlardan oluşur. Özet raporlar, özellikle dönüşüm değerleri gibi bazı kullanım durumlarında, etkinlik düzeyindeki raporlamaya göre daha fazla esneklik ve daha zengin bir veri modeli sağlar. |
| Reporting Origin |
Raporlama kaynağı, toplanabilir raporları alan varlık, yani reklam teknolojisidir. API'yi kullanmaya başladım. Toplanabilir raporlar, kullanıcı cihazlarından raporlama kaynağıyla ilişkili bir tanınmış URL'ye gönderilir. Bu raporlama kaynağı kayıt sırasında belirtilmelidir. |
| 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 |
Onay, genellikle şifreleme karmaları veya imzalarla yazılım kimliğini doğrulamak için kullanılan bir mekanizmadır. Toplama hizmet teklifi için onay, reklam teknolojisi tarafından işletilen toplama hizmetinde çalışan kodu açık kaynak koduyla eşleştirir. 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 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) | Erişimi demografiye göre ö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. 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.
- Şifrelenmiş raporlar oluşturmak için herkese açık anahtarı alın.
- Toplanacak, dönüştürülecek ve toplu olarak gönderilecek şekilde reklam teknolojisi sunucularına gönderilen şifrelenmiş, birleştirilebilir raporlar.
- Reklam teknolojisi sunucusu raporları (avro biçiminde) gruplandırır ve dağıtılan toplama hizmetine gönderir. (Reklam teknolojisi tarafından doldurulmalıdır).
- Şifre çözmek için toplu raporları alın.
- Şifre çözme anahtarlarını koordinatörlerden alma.
- Aggregation Service, raporların şifresini çözerek raporları toplar ve gürültü ekler.
- Toplanabilir rapor muhasebe hizmeti, belirli toplanabilir raporlar için özet rapor oluşturmak üzere kalan gizlilik bütçesi olup olmadığını kontrol eder.
- 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ör'deki 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. Bunun, 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 kaynak 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ışı, belirlenen raporlama kaynak sunucusunun yardımı olmadan tamamlanamaz. 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.
Ö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 giriş noktası olarak hizmet veren 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. 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 bir işin durumunu döndürür. İşin durumuyla ilgili bilgi sağlar (ör. "Alındı", "Devam Ediyor" veya "Bitti"). Ayrıca, iş tamamlandıysa iş yürütme sırasında karşılaşılan hata mesajları da dahil olmak üzere iş sonucunu gösterir. |
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 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) Bulut depolama alanı, Toplama Hizmeti tarafından kullanılan giriş ve çıkış dosyalarını (ör. şifrelenmiş rapor dosyaları, çıkış özeti raporları vb.) 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 İşleyici, iş 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 İş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 Güvenilir Yürütme Ortamı (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ı paralel olarak iş işlenecek ş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ı aracılığıyla 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 muhasebesi 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. ("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 İşleyici, kısmi raporlama hataları olması durumunda uygun iş döndürme kodları ve rapor hata sayaçları da dahil olmak üzere İş Meta Verileri 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 ayrıntılı açıklamamızı inceleyin.
Sonraki adımlar
Toplama Hizmeti'nin öne çıkan özelliklerini öğrendiniz. Şimdi Google Cloud veya Amazon Web Services üzerinden kendi Toplama Hizmeti örneğinizi dağıtma zamanı. Başlangıç bölümüne göz atın. Dağıtılmış bir Toplama Hizmeti'ni nasıl çalıştıracağınız 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ı takip edin.
Sorun giderme
Hata mesajlarının daha ayrıntılı açıklamaları, karşılaştığınız hataya neyin neden olmuş olabileceği ve sorunu azaltmaya yönelik sonraki adımlar için Yaygın hata kodları ve azaltma yöntemleri dokümanımıza 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, bakımını yaparken veya ç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.