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:
| 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 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.