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:

Terim Açıklama
Aggregation Service Özet rapor oluşturmak için toplanabilir raporları işleyen, reklam teknolojisi tarafından işletilen bir hizmet.
Toplanabilir Raporlar

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.

Birleştirilebilir raporlar hakkında daha fazla bilgi edinin.
Toplanabilir Rapor Muhasebesi Her iki koordinatörde bulunan ve gizlilik bütçesini takip eden dağıtılmış bir defter ve "Yinelenen Yok"u kuralı ekleyin. Bu, koordinatörler içinde bulunan ve çalıştırılan gizliliği korumaya yönelik mekanizmadır ve hiçbir raporun Toplama Hizmeti'nden ayrılan gizlilik bütçesinden geçmesini önler. Toplanabilir raporlarla ilişkili olarak gruplandırma stratejileri hakkında daha fazla bilgi edinin.
Toplanabilir Rapor Muhasebe Bütçesi Raporların birden fazla kez işlenmediğinden emin olmak için bütçeye yapılan referanslar.
Güvenilir Yürütme Ortamı (TEE)

Güvenilir yürütme ortamı, bilgisayar donanımı ve yazılımının özel bir yapılandırmasıdır. tarafların bilgisayarınızda çalışan yazılımın tam sürümlerini doğrulamasına izin verir. TEE'ler, harici tarafların, yazılımın tam olarak yazılım üreticisinin iddia ettiği şekilde çalıştığını (daha fazla veya daha az değil) doğrulamasına olanak tanır.

Özel Korumalı Alan teklifleri için kullanılan TEE'ler hakkında daha fazla bilgi edinmek için Protected Audience API hizmetleri açıklamalı kılavuzunu ve Toplama Hizmeti açıklamalı kılavuzunu okuyun.
Koordinatörler

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.
Paylaşılan kimlik Aşağıdakilerden oluşan hesaplanmış değer: shared_info, reporting_origin, destination_site (yalnızca Attribution Reporting API için kullanılabilir), source_registration-time (yalnızca Attribution Reporting API için kullanılabilir), scheduled_report_time, version. Yani, shared_info alanında aynı özellikleri paylaşan birden fazla rapor aynı paylaşılan kimliğe ait olur. Bu, birleştirilebilir rapor muhasebesinde önemli bir rol oynar. Güvenilir Sunucular hakkında daha fazla bilgi edinin.
Özet Rapor

Ö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.
Raporlama Kaynağı

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.
Katkı Bağlama Toplanabilir raporlar, isteğe bağlı sayıda sayaç artışı içerebilir. Örneğin bir rapor, kullanıcının bir reklamverenin sitesinde görüntülediği ürünlerin sayısını içerebilir. Tek bir kaynak etkinlikle ilgili olarak toplanabilir tüm raporlardaki artışların toplamı, belirtilen sınırı ("L1=2^16") aşmamalıdır. Toplanabilir raporlar açıklayıcıdan daha fazla bilgi edinebilirsiniz.
Gürültü ve Ölçeklendirme Toplama işleminin bir parçası olarak özet raporlarına belirli bir miktarda istatistiksel gürültü eklenir. Bu gürültü, gizliliği korumak ve nihai raporların anonimleştirilmiş ölçüm bilgileri vermesini sağlamak için de kullanılabilir. Laplace dağılımından alınan ek gürültü mekanizması hakkında daha fazla bilgi edinin.
Onay

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.

Onay hakkında daha fazla bilgi edinin.

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