Toplama Hizmeti, toplu olarak derlenebilen ham raporlardan ayrıntılı dönüşüm verileri ve erişim ölçümlerinin özet raporlarını 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 |
|---|---|
| Yeniden sorgu, reklam teknolojilerinin Toplama Hizmeti raporlarını birden çok kez işlemesine olanak tanır. Böylece farklı ölçüm ihtiyaçları için esnek analizler desteklenir.
GitHub sorunu |
2025'in ikinci yarısında kullanıma sunulacak |
| 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 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'daki SSS Site toplama API dokümanları |
Kullanılabilir |
| Toplama Hizmeti'nin epsilon değeri, farklı parametrelerle ilgili denemeleri ve geri bildirimi 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ı bütçe 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 kurtarma işlemlerini 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 |
| Bulutlar arası şifreleme anahtarı hizmetleri
Açıklayıcı |
2025'in ilk yarısında kullanıma sunulması bekleniyor |
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 raporlar, kullanıcı 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 olarak adlandırılır) ve ilişkili metrikler reklamveren veya reklam teknolojisi tarafından tanımlanır. Her rapor, çeşitli tarafların temel verilere erişmesini önlemek için şifrelenir.
- Toplanabilir Rapor Muhasebesi
-
分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。
- Toplanabilir Rapor Muhasebe Bütçesi
-
对预算的引用，用于确保不会对单个报告进行多次处理。
- 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
-
一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务提案，认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。
- 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
-
在汇总过程中向摘要报告添加的统计噪声，用于保护隐私并确保最终报告提供匿名化衡量信息。
- Bildirim kaynağı
-
接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。
- Paylaşılan kimlik
-
计算值，由
shared_info、reporting_origin、destination_site（仅限 Attribution Reporting API）、source_registration-time（仅限 Attribution Reporting API）、scheduled_report_time和版本组成。如果多个报告在
shared_info字段中具有相同的属性，则应具有相同的共享 ID。共享 ID 在可汇总报告的会计核算中发挥着重要作用。 - Özet Rapor
-
Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。
- Güvenilir Yürütme Ortamı (TEE)
-
Bilgisayar donanımı ve yazılımının güvenli bir yapılandırması. Bu yapılandırma, harici tarafların makinede çalışan yazılımların tam sürümlerini, açığa çıkma korkusu olmadan doğrulamasına olanak tanır. 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.
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 toplama hizmetinde özet raporun oluşturulduğu ana kadar olan uçtan uca akışa odaklanacağız.
- Şifrelenmiş raporlar oluşturmak için herkese açık anahtarı alın.
- Şifrelenmiş toplanabilir raporlar, toplanması, dönüştürülmesi ve toplu olarak işlenmesi için reklam teknolojisi sunucularına gönderilir.
- Reklam teknolojisi sunucusu, raporları (avro biçiminde) gruplandırır ve Toplama Hizmeti'ne gönderir. (Bu formu doldurmanız gerekir.)
- Toplama İşleyici, şifresini çözmek için toplu raporları alır.
- Toplama Çalışanı, şifre çözme anahtarlarını bir Koordinatör'den alır.
- Toplama İşleyici, 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 yeterli gizlilik bütçesi olup olmadığını kontrol eder.
- Nihai özet raporu gönderin.
Şemada, 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 ortak 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 toplama 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ç hizmetinin iki API'si vardır:
| 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ğı 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 İşçileri, 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.
Toplama ç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ına 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 hatalarla karşılaşırsanız teknik sorun giderme desteği almak için bu Teknik Destek Formu'nu kullanın.
- Bilinen sorunlar için Herkese Açık Durum Kontrol Paneli'ne bakın.