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:
| 术语 | 说明 |
|---|---|
| 汇总服务 | 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。 |
| 可汇总的报告 |
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. 详细了解可汇总的报告。 |
| 可汇总报告的会计核算 | 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。 |
| 可汇总报告的会计核算预算 | 对预算的引用，用于确保报告不会被处理多次。 |
| 可信执行环境 (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ö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. |
| 共享 ID |
计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。
这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。
详细了解可信服务器。
|
| 汇总报告 |
Ö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ğı, 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. |
| 贡献债券 | 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。 |
| 噪声和缩放 | 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。 |
| 证明 |
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. 详细了解证明。 |
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.