Attribution Reporting API ve Private Aggregation API ile kullanıcılar genelinde toplanan verileri ölçün.
Uygulama durumu
- İlişkilendirme Raporu özet raporlarına katılın ve bu raporlarla denemeler yapın.
Özet rapor nedir?
Özet raporu, herhangi bir kullanıcıyla ilişkilendirilemeyecek şekilde bir kullanıcı grubu için derlenir. Özet raporlar, tıklama ve görüntüleme verileri için esneklik sunan ayrıntılı dönüşüm verileri sunar. Özet raporlar, siteler genelinde bireysel kullanıcıları tanımlamak için kullanılabilecek üçüncü taraf çerezlerine veya mekanizmalarına dayanmaz.
Özet raporlar iki bağlamda oluşturulur:
- Reklam ölçümü: Reklam teknolojileri, bir reklam tıklamasının veya görüntülemenin reklamveren sitesinde ne zaman satış ya da kayıt gibi bir dönüşümle sonuçlandığını ölçmek için İlişkilendirme Raporları ile özet raporlar oluşturabilir. Reklam teknolojileri, Özel Toplama ile Protected Audience API açık artırmaları için de özet raporlar oluşturabilir.
- Genel siteler arası raporlama: Geliştiriciler, siteler arası verileri Paylaşılan Depolama'da yakalar ve Özel Toplama ile bu veriler hakkında rapor oluşturabilir. Bunun, kullanıcı demografisi hakkında bilgi edinmek ve içerik için tekil erişimleri yakalamak gibi pek çok amacı vardır.
Özet raporlar, İlişkilendirme Raporlaması ve Gizli Toplama için farklı şekilde istenir. Rapor oluşturmayı öğrenmeden önce, toplamanın ne olduğunu ve ölçüm ihtiyaçlarınızı karşılamak için özet raporların nasıl kullanılabileceğini anlamanız gerekir.
Temel kavramlar
Veri koleksiyonunuzu tasarlama
Özet raporların önemli bir ilkesi erken tasarım kararlarıdır. Hangi verilerin hangi kategorilerde toplanacağına siz karar verirsiniz. Çıkış raporları, kampanyalarınız veya işletmelerinizle ilgili analizler sağlar.
Çıkış raporu, siteler arası ayrıntılı dönüşüm verilerinin yanı sıra tıklama ve görüntüleme verilerini dönüşüm verileriyle birleştirmek için esneklik sunar. Nihai çıktıyı, karar alırken kullandığınız araçlar için bir girdi olarak da düşünebilirsiniz.
Kendinize şunu sorun: Kullanıcıların içeriklerimle etkileşimi hakkında ne öğrenmek istiyorum?
Reklam dönüşümleri
Örneğin, toplam harcama değerine yol açan dönüşümlerin sayısını belirlemek için özet raporlar oluşturursanız bu raporlar, ekibinizin daha yüksek bir toplam harcama elde etmek için sonraki reklam kampanyanızda neyi hedeflemesi gerektiğine karar vermesine yardımcı olabilir.
![Birden fazla toplanabilir raporun nasıl işlendiğini ve belirli özet raporlar oluşturmak için gürültünün nasıl eklendiğini gösteren şema.](https://developers.google.cn/static/privacy-sandbox/assets/images/diagram-shows-multiple-f504e84e824cc.png?authuser=19&hl=tr)
Siteler arası etkileşim
Örneğin, bir üçüncü tarafın web sitesindeki içeriğinizi kaç kişinin okuduğunu belirlemek için özet raporlar oluşturursanız, bu rapor ekibinizin daha yüksek etkileşim elde etmek ve okuyucuları doğrudan sitenizi ziyaret etmeye teşvik etmek için söz konusu üçüncü tarafla nasıl iş ortaklığı yapacağına karar vermesine yardımcı olabilir.
Tarayıcıda hangi bilgiler yakalanır?
Birleştirilebilir rapor, kullanıcının tarayıcısından yakalanan ve önceden belirlenmiş bir paket grubunu (veya toplama anahtarlarını) içeren ham verilerdir. Bu ölçütleri nasıl belirlediğiniz, tasarım kararlarınıza bağlıdır.
Özet raporlar, ayrıntılı dönüşüm verilerinin yanı sıra birleştirilmiş verilerin bir kombinasyonunu sunar.
Reklam dönüşümleri
Dönüşümler, reklamveren veya reklam teknolojisi şirketi tarafından tanımlanır ve farklı reklam kampanyaları için farklı olabilir. Bir kampanya, reklamı yapılan ürünü satın alan kullanıcının izlediği reklam tıklamalarının sayısını ölçebilir. Başka bir kampanya ise kaç reklam görüntülemesinin reklamverenin sitesini ziyaret ettiğini ölçebilir.
Örneğin, bir reklam teknolojisi sağlayıcı news.example sitesinde bir reklam kampanyası yayınlar.Buradaki dönüşüm, bir kullanıcının ayakkabı reklamını tıkladığını ve ayakkabı satın alma işlemini tamamladığını ifade eder.
Reklam teknolojisi, 1234567
kimlikli bu reklam kampanyası için bir özet rapor alıyor. Bu rapor, ayakkabılarda 12 Ocak 2022'de 518 dönüşüm elde edildiğini ve toplam 38.174 ABD doları harcamanın gerçekleştiğini belirtir. Dönüşümlerin %60'ı 9872
ürün SKU'suna sahip mavi spor ayakkabı satın alan kullanıcılardan, %40'ı ise 2643
ürün SKU'suna sahip sarı sandalet satın alan kullanıcılardan geldi. Kampanya kimliği reklam tarafı ayrıntılı verileri, ürün SKU'ları ise ayrıntılı dönüşüm verileridir. Dönüşüm sayısı ve toplam harcama birleştirilmiş verilerdir.
Siteler arası etkileşim
Verileri yakalayabilmeniz için önce hangi bilgileri toplamak istediğinizi, belirli bir siteler arası entegrasyondan hangi dönüşümleri beklediğinizi ve hangi rapor türünü toplayacağınızı belirlemeniz gerekir.
Özel Toplama belgelerinde ayrıntılı olarak açıklanan birkaç olası kullanım alanı vardır. Bir örneği inceleyelim:
Farklı sitelerde içeriğinizi gören kullanıcıların demografisini ölçmek isteyebilirsiniz. Özel Toplama, "18-45 yaşlarında ve Almanya'dan yaklaşık 317 benzersiz kullanıcı" gibi bir yanıt sağlayabilir. İlk olarak, özellikle hangi bilgileri (yaş ve konum gibi) toplamak istediğinize karar verin. Ardından, söz konusu demografi verilerini bir üçüncü taraf sitesinden toplamak için Paylaşılan Depolama'yı kullanın. Daha sonra, toplama anahtarında kodlanmış yaş grubu ve ülke boyutlarıyla Özel Toplama üzerinden bir rapor gönderebilirsiniz.
Veriler toplamadan önce nasıl yakalanır?
Özet raporlar, bir grup farklı cihazdan toplanan verilerden oluşur. Her bir kullanıcının işlemleri gözlemlenemez ve incelenemez ancak toplama işlemi her kullanıcı için aynıdır.
Tek bir kullanıcının işlemleri şifrelenir ve bir toplanabilir raporda toplanır. Bu raporlar, gruplamayla ilgili az miktarda şifrelenmemiş meta veri de içerir.
İlişkilendirme Raporlama verileri için, birleştirilebilir raporlar şu şekilde yakalanır:
- Kullanıcı bir yayıncı sitesini ziyaret eder ve bir reklamı görür veya tıklar (ilişkilendirme kaynağı etkinliği olarak da bilinir).
- Kullanıcının dönüşüm gerçekleştirmesinden birkaç dakika veya gün sonra gerçekleşir. Diğer bir deyişle, ilişkilendirme tetikleyicisi etkinliği olarak da bilinir. Örneğin, dönüşüm, bir ürün satın alma olarak tanımlanabilir.
- Tarayıcı yazılımı, reklam tıklamasını veya görüntülemeyi dönüşüm etkinliğiyle eşleştirir. Tarayıcı, bu eşleşmeye göre reklam teknolojisi sağlayıcı tarafından oluşturulan belirli bir mantığı içeren, toplanabilir bir rapor oluşturur.
- Tarayıcı bu verileri şifreler ve kısa bir gecikmenin ardından toplanması için bir reklam teknolojisi sunucusuna gönderir. Reklam teknolojisi sunucusu, gürültü uygulanan analizlere erişmek için toplama hizmetinden yararlanmalıdır.
Gizli Toplama için şu şekilde görünür:
- Üçüncü taraf, neyi ölçmek istediğine karar verir ve verileri daha sonra okunmak üzere Paylaşılan Depolama alanına yazar.
- Kullanıcı, üçüncü tarafın ölçmek istediğiyle eşleşen bir etkinliği tetikler. Örneğin, kullanıcı yerleşik içeriğe sahip bir siteyi ziyaret ettiğinde, üçüncü taraf paylaşılan Depolama Alanı'ndaki verileri okuyabilir ve Özel Toplama'yı kullanarak toplanacak şifrelenmiş ve birleştirilmiş raporları sunucunuza gönderebilir.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/2Si3rdSh7jr3S6UZTSrg.png?authuser=19&hl=tr)
Birleştirilebilir raporları gruplandırma
Toplanan birleştirilmiş raporların işlenip bir özet raporda toplanabilmesi için öncelikle toplu olarak raporlanmaları gerekir. Grup, toplanabilir raporlardan oluşan stratejik bir gruptur.
Toplanabilir raporlarda, gruplar oluşturmak için kullanılabilecek shared_info
olarak dahil edilen az miktarda şifrelenmemiş veri bulunur. Bu, zaman damgasını ve raporlama kaynağını içerir. Rapordaki şifrelenmiş bilgilere dayalı olarak gruplandırma yapamazsınız.
İdeal olan, grupların çok sayıda rapor içermesidir. Saatlik, günlük, haftalık veya istediğiniz başka bir zaman aralığını gruplandırmaya karar verebilirsiniz. Bu strateji, daha yüksek trafiğin beklendiği belirli etkinlikler için değişebilir.
Örneğin, Attribution Reporting API için toplanabilir raporları toplu olarak birleştirirken, toplu hale getirme stratejinizi büyük bir indirimin olduğu gün için saatlik olarak güncellemeye karar verebilirsiniz. Bu durumda, reklam dönüşümlerinin hacmi daha yüksektir.
Private Aggregation API sayesinde, üçüncü taraf web sitelerine yerleştirilmiş belirli bir içerik parçasıyla ilgili büyük bir basın bülteninin yayınlandığı gün stratejinizi değiştirebilirsiniz.
Verileri toplama hizmetiyle işleme
Toplama hizmeti, toplanabilir raporlardaki toplu verilerin şifresini çözer, bunları birleştirir, gürültü ekler ve nihai özet raporunu döndürür. Bu hizmet, bu verileri korumak için gerekli güvenlik önlemlerini destekleyen bir bulut hizmetine dağıtılan güvenilir yürütme ortamında (TEE) çalışır.
İlişkilendirme Raporları içeren özet raporlar
Reklam teknolojisi sağlayıcıların özet raporu alabilmesi için aşağıdaki adımlar gerçekleştirilmelidir:
- Reklam teknolojisi sağlayıcı, her kullanıcının tarayıcılarından birleştirilebilir raporlar toplar.
- Reklam teknolojisi sağlayıcı, birleştirilebilir raporları gruplandırır ve grupları, toplama hizmetine gönderir.
- Toplama hizmeti, verileri toplamak için bir çalışan planlar.
- Toplama çalışanı, gürültü uygulanmış verilerle birlikte birleştirilebilir raporlardaki verilerin şifresini çözer ve bu verileri toplar.
- Toplama hizmeti, özet raporunu reklam teknolojisi sağlayıcısına döndürür.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/U1ZeswSEnAMSSoCcE5Za.png?authuser=19&hl=tr)
Reklam teknolojisi, teklif verme hakkında bilgi edinmek ve kendi müşterilerine raporlar sunmak için özet raporu kullanabilir. Özet raporlar için JSON kodlu şema, önerilen biçimdir.
Gizli Toplama içeren özet raporları
- Shared Storage tarafından toplanan siteler arası verileri okuyun ve verileri gruplandırmak için bir toplama anahtarı oluşturun.
- Toplama anahtarı ve biriktirmek istediğiniz değerle, Paylaşılan Depolama iş uygulamasından Private Aggregation API'yi çağırın. Tarayıcı, girişinizden şifrelenmiş ve toplanabilir bir rapor oluşturur ve toplanması için sunucunuza gönderir.
- Birleştirilebilir raporları gruplandırın ve işlenmeleri için toplama hizmetine gönderin.
- Toplama hizmeti toplu raporları işler, ardından gürültü ekler.
- Toplama hizmeti, özet raporunu istek sahibine döndürür.
Etkileşimde bulunun ve geri bildirim paylaşın
Özet raporlar, Özel Korumalı Alan ölçüm tekliflerinin temel parçalarından biridir. Diğer Özel Korumalı Alan teklifleri gibi bu da GitHub'da herkese açık olarak belgelenir ve tartışılır.
- Attribution Reporting API'yi tartışın.
- Private Aggregation API'yi tartışın.
- Geliştirici desteği: Özel Korumalı Alan Geliştirici Desteği deposunda sorular sorun ve tartışmalara katılın.