Toplama Hizmeti

Toplama Hizmeti, birleştirilebilir ham raporlardan ayrıntılı dönüşüm verileri ve erişim ölçümleriyle ilgili özet raporlar 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
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, Private Aggregation API genelinde Google Cloud için toplama hizmeti desteği Açıklama	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 bildirimleri 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ında bütçeyi 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 kurtarmaları 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

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 raporlar hakkında daha fazla bilgi edinin.

Toplanabilir Rapor Muhasebesi

Her iki koordinatörde de bulunan, ayrılan gizlilik bütçesini izleyen ve "Yinelenen yok" kuralını uygulayan dağıtılmış bir defter. Bu, koordinatörlerde bulunan ve çalıştırılan, gizlilik bütçesinin ötesinde hiçbir raporun Toplama Hizmeti'nden geçmemesini sağlayan gizliliği koruma mekanizmasıdır.

Gruplandırma stratejilerinin toplanabilir raporlarla ilişkisi hakkında daha fazla bilgi edinin.

Toplanabilir Rapor Muhasebe Bütçesi

Bağımsız raporların birden fazla kez işlenmediğinden emin olmak için bütçeye yapılan referanslar.

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

Genellikle kriptografik karma veya imzalarla yazılım kimliğini doğrulayan bir mekanizma. Toplama hizmeti teklifinde, doğrulama, reklam teknolojisi tarafından işletilen toplama hizmetinizde çalışan kodu açık kaynak kodla eşleştirir.

Onay hakkında daha fazla bilgi edinin.

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

Gizliliği korumak ve nihai raporların anonimleştirilmiş ölçüm bilgileri sağlamasını sağlamak için toplama işlemi sırasında özet raporlara eklenen istatistiksel gürültü.

Laplace dağılımından alınan ek gürültü mekanizması hakkında daha fazla bilgi edinin.

Bildirim kaynağı

Toplanabilir raporları alan tüzel kişi (yani siz veya Attribution Reporting API'yi çağıran bir reklam teknolojisi). Birleştirilebilir raporlar, kullanıcı cihazlarından raporlama kaynağıyla ilişkili iyi bilinen bir URL'ye gönderilir. Raporlama kaynağı, kayıt sırasında belirlenir.

Paylaşılan kimlik

shared_info, reporting_origin, destination_site (yalnızca Attribution Reporting API için), source_registration-time (yalnızca Attribution Reporting API için), scheduled_report_time ve sürümden oluşan bir hesaplanmış değer.

shared_info alanında aynı özellikleri paylaşan birden fazla rapor aynı paylaşılan kimliğe sahip olmalıdır. Paylaşılan kimlikler, birleştirilebilir rapor muhasebesinde önemli bir rol oynar.

Güvenilir sunucular hakkında daha fazla bilgi edinin.

Özet Rapor

Attribution Reporting API ve Private Aggregation API rapor türü. Özet rapor, birleştirilmiş kullanıcı verilerini içerir ve gürültü eklenmiş ayrıntılı dönüşüm verileri içerebilir. Özet raporlar, toplu raporlardan oluşur. Özellikle dönüşüm değerleri gibi bazı kullanım alanları için etkinlik düzeyindeki raporlamaya kıyasla daha fazla esneklik sağlar ve daha zengin bir veri modeli sunar.

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 Özet Rapor'un Toplama Hizmeti'nde oluşturulduğu ana kadar olan uçtan uca akışa odaklanacağız.

Uçtan uca Aggregation Service akışı

1. Şifrelenmiş raporlar oluşturmak için herkese açık anahtarı alın.
2. Şifrelenmiş birleştirilebilir raporlar, toplanması, dönüştürülmesi ve toplu olarak işlenmesi için reklam teknolojisi sunucularına gönderilir.
3. Reklam teknolojisi sunucusu, raporları (avro biçiminde) gruplandırır ve Toplama Hizmeti'ne gönderir. (Bu formu doldurmanız gerekir.)
4. Toplama İşleyici, şifresinin çözülmesi için toplu raporları alır.
5. Toplama Çalışanı, şifre çözme anahtarlarını bir Koordinatör'den alır.
6. Toplama İşleyici, 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 yeterli gizlilik bütçesi olup olmadığını kontrol eder.
8. Nihai özet raporu gönderin.

Diyagramda, 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 herkese açık 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 toplu raporlama 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.

Toplama Hizmeti bulut bileşenleri

Ö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ç hizmetinde iki API kullanılabilir:

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ğı ve daha fazlası 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 çalışanları, 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.

Toplayıcı ç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ı 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 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 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.