İşleyiş şekli

Toplama Hizmeti, reklam teknolojilerine müşterilerle kampanya etkinliğini artırmak için gereken performans analizlerini sağlar.

Bu belgede:

• Temel terimler ve kavramlar
• Aggregation Service'in işleyiş şekli: Ayrıntılı dönüşüm verileri ve ham toplanabilir raporlardan elde edilen erişim ölçümleri
• Toplanabilir raporları toplu işleme kavramsal genel bakışı
• Bulut bileşenlerine kavramsal genel bakış

Bu belge kimler için hazırlanmıştır?

Bu sayfa, API'lerimizin nasıl etkili ve gizliliği koruyan reklam ölçümü sağladığını anlamaları için reklam teknolojisi sağlayıcılarına ve geliştiricilere yardımcı olur.

Bu belgede, Private Aggregation API, Attribution Reporting API, Protected Audience API, Shared Storage ve Trusted Execution Environments hakkında bilgi sahibi olduğunuz varsayılmaktadır.

Temel terimler ve kavramlar

Devam etmeden önce temel terimleri öğrenin:

Sözlük

Reklam teknolojileri

Reklam platformu, reklam yayınlamak için hizmetler sunan şirketlerdir.

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 raporlama 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ğı

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çeklendirme

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.

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

Aggregation Service iş akışı

Toplama hizmeti, ham toplanabilir raporlardan ayrıntılı dönüşüm ve erişim verilerinin özet raporlarını oluşturur. Rapor oluşturma akışı aşağıdaki adımlardan oluşur:

1. Tarayıcı, şifrelenmiş raporlar oluşturmak için ortak anahtar getirir.
2. Şifrelenmiş toplanabilir raporlar, reklam teknolojileri sunucularına gönderilir.
3. Reklam teknolojisi sunucusu, raporları (avro biçiminde) gruplandırır ve Toplama Hizmeti'ne gönderir.
4. Bir toplama çalışanı, şifre çözmek için toplu raporları alır.
5. Toplama çalışanı, şifre çözme anahtarlarını bir koordinatörden alır.
6. Toplama çalışanı, toplama ve gürültü ekleme için raporların şifresini çözer.
7. Toplanabilir rapor muhasebe hizmeti, belirtilen toplanabilir raporlar için özet rapor oluşturmaya yetecek gizlilik bütçesi olup olmadığını kontrol eder.
8. Toplama Hizmeti, nihai bir özet rapor gönderir.

Aşağıdaki diyagramda, raporların web ve mobil cihazlardan alındığı andan itibaren Aggregation Service tarafından özet rapor oluşturulana kadar Aggregation Service'in işleyiş şekli gösterilmektedir.

Özetle, Attribution Reporting API veya Private Aggregation API, birden fazla tarayıcı örneğinden raporlar oluşturur. Chrome, raporları reklam teknolojisi raporlama kaynağına göndermeden önce şifrelemek için Koordinatördeki Anahtar Barındırma Hizmeti'nden yedi günde bir döndürülen bir genel anahtar alır. Reklam teknolojisi raporlama kaynağı, gelen raporları toplayıp avro biçimine dönüştürür ve Toplama Hizmeti'ne gönderir. Toplama Hizmeti'ne bir toplu istek gönderildiğinde, bu hizmet şifre çözme anahtarlarını Anahtar Barındırma Hizmeti'nden alır, raporların şifresini çözer ve özet rapor oluşturmak için raporları toplayıp gürültü ekler. Bunun için yeterli gizlilik bütçesi olması gerekir.

Uygulama bölümünde toplanabilir raporlarınızı hazırlama hakkında daha fazla bilgi edinin.

Toplanabilir raporların toplu işlenmesi

Kaydolma süreci sırasında belirttiğiniz, belirlenmiş raporlama kaynağı sunucusunun yardımı olmadan raporlama akışı tamamlanmaz. Raporlama kaynağı, toplanabilir raporları toplama, dönüştürme ve gruplandırmanın yanı sıra Google Cloud veya Amazon Web Services'deki Toplama Hizmetinize gönderilmek üzere hazırlamaktan sorumludur. Toplanabilir raporlarınızı hazırlama hakkında daha fazla bilgi edinin.

Bulut 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 Functions (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. Aggregation Service kullanıcılarından gelen istekleri almak, giriş parametrelerini doğrulamak ve toplama işi planlama sürecini başlatmakla sorumludur.

Frontend Service'in iki API'si vardır:

Uç nokta	Açıklama
createJob	Bu API, bir Aggregation Service işini tetikler. İşin tetiklenmesi için iş kimliği, giriş depolama alanı ayrıntıları, çıkış depolama alanı ayrıntıları ve raporlama kaynağı gibi bilgiler gerekir.
getJob	Bu API, belirtilen iş kimliğine sahip işin durumunu döndürür. İşin durumu hakkında bilgi verir (ör. "Alındı", "Devam ediyor" veya "Tamamlandı"). İş tamamlandıysa işin yürütülmesi 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'ne yönelik iş isteklerini içeren bir mesaj sırasıdır. Ön uç hizmeti, iş isteklerini sıraya ekler. Bu istekler daha sonra bunları işleyen toplama çalışanları tarafından tüketilir.

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ış özet 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 Tamamlandı gibi durumları kaydeder. Toplama çalışanları, işler ilerledikçe İş Meta Verileri Veritabanı'nı günceller.

Aggregation Worker

Yönetilen Bulut Hizmeti: Gizli alan ile Compute Engine (Google Cloud) / Nitro Enclave ile Amazon Web Services EC2 (Amazon Web Services).

Bir toplama çalışanı, iş kuyruğundaki iş isteklerini işler ve şifrelenmiş girişleri, koordinatörlerdeki anahtar oluşturma ve dağıtım hizmetinden (KGDS) aldığı anahtarları kullanarak şifrelerini çözer. İşleme gecikmesini en aza indirmek için toplama çalışanları, şifre çözme anahtarlarını sekiz saat boyunca önbelleğe alır ve işledikleri işlerde kullanır.

Toplama İşçileri, Güvenilir Yürütme Ortamı (TEE) örneğinde çalışır. Bir çalışan aynı anda yalnızca bir işi ele alır. Otomatik ölçeklendirme yapılandırmasını ayarlayarak işleri paralel olarak işlemek için birden fazla çalışan yapılandırabilirsiniz. Kullanıldığında otomatik ölçeklendirme, çalışan sayısını iş kuyruğundaki ileti sayısına göre dinamik olarak ayarlar. Otomatik ölçeklendirme için minimum ve maksimum çalışan sayısını Terraform ortam dosyası üzerinden 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 kaydı için birleştirilebilir rapor kaydı hizmetini çağırır. Bu hizmet, işlerin yalnızca gizlilik bütçe sınırı aşılmadığında çalıştırıldığını doğrular. ("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 hakkında daha fazla bilgi edinin.

Toplama çalışanları, 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.

Aggregation Service'in daha ayrıntılı açıklaması için bu açıklayıcı metne bakın.

Sonraki adımlar

Toplama hizmetinin nasıl çalıştığını öğrendiğinize göre, Google Cloud veya Amazon Web Services üzerinden kendi örneğinizi dağıtmak için başlangıç kılavuzunu inceleyin.