Attribution Reporting API ve Private Aggregation API ile kullanıcılar arasında toplanan verileri ölçün.
Uygulama durumu
- İlişkilendirme Raporlama özet raporlarına katılarak denemeler yapın.
Özet raporu nedir?
Bir kullanıcı grubu için, herhangi bir kullanıcıyla ilişkilendirilemeyecek şekilde bir özet rapor 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 arasında 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 teknolojisi uzmanları, bir reklam tıklamasının veya görüntülemesinin bir reklamveren sitesinde satış veya kaydolma gibi bir dönüşüme yol açtığı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 özet raporlar da oluşturabilir.
- Genel siteler arası raporlama: Geliştiriciler, siteler arası verileri Paylaşılan Depolama'da yakalar ve Gizli Toplama ile bu veriler hakkında rapor oluşturabilir. Bu, kullanıcı demografisi hakkında bilgi edinme ve içerik için benzersiz erişimler elde etme gibi birçok amaç için kullanılabilir.
Özet raporlar, İlişkilendirme Raporlaması ve Özel Toplama için farklı şekilde istenir. Rapor oluşturmayı öğrenmeden önce, toplamanın ne olduğunu ve özet raporların ölçüm ihtiyaçlarınızı karşılamak için nasıl kullanılabileceğini anlamanız gerekir.
Temel kavramlar
Veri toplama işleminizi tasarlama
Özet raporların temel ilkelerinden biri, erken tasarım kararlarıdır. Hangi kategorilerde hangi verilerin toplanacağına siz karar verirsiniz. Çıkış raporları, kampanyalarınız veya işletmenizle ilgili analizler sunar.
Çıkış raporu, siteler arası ayrıntılı dönüşüm verileri ve tıklama ve görüntüleme verilerini dönüşüm verileriyle birleştirmek için esneklik sunar. Nihai çıkışı, karar vermek için kullandığınız araçlara giriş olarak da düşünebilirsiniz.
Kendinize şu soruyu sorun: İçeriğimle kullanıcı etkileşimi hakkında ne öğrenmek istiyorum?
Reklam dönüşümleri
Örneğin, belirli bir toplam harcama değerine ne kadar dönüşümün yol açtığını belirlemek için özet raporlar oluşturursanız ekibinizin, daha yüksek bir toplam harcama elde etmek için bir sonraki reklam kampanyanızın neyi hedeflemesi gerektiğine karar vermesine yardımcı olabilirsiniz.

Siteler arası etkileşim
Örneğin, bir üçüncü tarafın web sitesinde içeriğinizi kaç kişinin okuduğunu belirlemek için özet raporlar oluşturursanız ekibiniz, daha fazla etkileşim elde etmek ve okuyucuları doğrudan sitenizi ziyaret etmeye teşvik etmek için bu üçüncü tarafla nasıl iş ortaklığı yapacağını kararlaştırabilir.
Tarayıcıda hangi bilgiler yakalanır?
Toplanabilir rapor, kullanıcının tarayıcısından yakalanan ham verilerdir. Bu veriler, önceden belirlenmiş bir grup paket (veya toplama anahtarı) içerir. Bu ölçütleri nasıl belirleyeceğ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ı tıklayan kullanıcının reklamı yapılan ürünü satın alma sayısını ölçebilir. Başka bir kampanya, kaç reklam görüntülemenin reklamveren site ziyaretlerine yol açtığını ölçebilir.
Örneğin, bir reklam teknolojisi sağlayıcısı, news.example adresinde bir reklam kampanyası yayınlar. Bu kampanyada dönüşüm, bir kullanıcının ayakkabı reklamını tıklayıp shoes.example adresinde ayakkabı satın almasını temsil eder.
Reklam teknolojisi, 1234567
kimlikli bu reklam kampanyası için bir özet raporu alır. Bu raporda, 12 Ocak 2022 tarihinde shoes.example sitesinde 38.174 ABD doları tutarında toplam harcama ile 518 dönüşüm olduğu belirtilmektedir. Dönüşümlerin %60'ı, ürün SKU'su 9872
olan mavi spor ayakkabı satın alan kullanıcılardan, %40'ı ise ürün SKU'su 2643
olan sarı sandalet satın alan kullanıcılardan geldi. Kampanya kimliği, reklam tarafı ayrıntılı verileridir. Ürün SKU'ları ise ayrıntılı dönüşüm verileridir. Dönüşüm sayısı ve toplam harcama, toplu verilerdir.
Siteler arası etkileşim
Veri toplayabilmeniz için toplamak istediğiniz bilgileri tanımlamanız, belirli bir siteler arası entegrasyondan hangi dönüşümleri beklediğinizi belirlemeniz ve hangi rapor türünün toplanacağını belirlemeniz gerekir.
Gizli toplama dokümanlarında ayrıntılı olarak açıklanan çeşitli olası kullanım alanları vardır. Bir örneği inceleyelim:
İçeriğinizi farklı sitelerde görmüş kullanıcıların demografisini ölçmek isteyebilirsiniz. Özel toplama, "Yaklaşık 317 benzersiz kullanıcı 18-45 yaş aralığında ve Almanya'dan" gibi bir yanıt sağlayabilir. Öncelikle, hangi bilgileri (ör. yaş ve konum) toplamak istediğinize karar verin. Ardından, üçüncü taraf sitesinden belirli demografi verilerini toplamak için Ortak Depolama'yı kullanın. Daha sonra, toplama anahtarında kodlanmış yaş grubu ve ülke boyutlarını içeren bir raporu Gizli Toplama aracılığıyla gönderebilirsiniz.
Veriler birleştirmeden önce nasıl yakalanır?
Özet raporlar, bir cihaz grubundan toplanan verilerden oluşur. Tek bir kullanıcının işlemleri gözlemlenip incelenemez ancak veri toplama işlemi her kullanıcı için aynıdır.
Bir kullanıcının işlemleri şifrelenir ve toplanabilir bir raporda toplanır. Bu raporlar, küçük miktarda gruplandırmayla alakalı şifrelenmemiş meta veri de içerir.
İlişkilendirme raporlama verileri için toplanabilir raporlar aşağıdaki şekilde yakalanır:
- Bir kullanıcı bir yayıncı sitesini ziyaret eder ve ilişkilendirme kaynağı etkinliği olarak da bilinen bir reklamı görür veya tıklar.
- Birkaç dakika veya gün sonra kullanıcı dönüşüm gerçekleştirir. Bu işlem, ilişkilendirme tetikleyici etkinliği olarak da bilinir. Örneğin, dönüşüm bir ürün satın alma işlemi olarak tanımlanabilir.
- Tarayıcı yazılımı, reklam tıklamasını veya görüntülemesini dönüşüm etkinliğiyle eşleştirir. Tarayıcı, bu eşleşmeye dayanarak bir reklam teknolojisi sağlayıcı tarafından oluşturulan belirli mantıkla toplanabilir bir rapor oluşturur.
- Tarayıcı bu verileri şifreler ve küçük bir gecikmeden sonra toplanması için bir reklam teknolojisi sunucusuna gönderir. Reklam teknolojisi sunucusu, gürültülü analizlere erişmek için bir toplama hizmetine ihtiyaç duyar.
Özel toplama için bu durum aşağıdaki gibi görünür:
- Üçüncü taraf, neyi ölçmek istediğine karar verir ve verileri daha sonra okunması için Paylaşılan Depolama'ya yazar.
- Kullanıcı, üçüncü tarafın ölçmek istediğiyle eşleşen bir etkinlik tetikler. Örneğin, kullanıcı yerleşik içeriğe sahip bir siteyi ziyaret ettiğinde üçüncü taraf, Paylaşılan Depolama'daki verileri okuyabilir ve toplanması için sunucunuza şifrelenmiş birleştirilebilir raporlar göndermek üzere Özel Toplama'yı kullanabilir.

Toplu olarak toplanabilir raporlar
Toplanan birleştirilebilir raporların işlenip özet raporda toplanamadan önce gruplandırılmaları gerekir. Grup, birleştirilebilir raporlardan oluşan stratejik bir gruptur.
Toplanabilir raporlarda, grup oluşturmak için kullanılabilecek shared_info
olarak eklenen az miktarda şifrelenmemiş veri bulunur. Zaman damgası ve raporlama kaynağı da buna dahildir. Rapordaki şifrelenmiş bilgilere göre gruplandıramazsınız.
İdeal olarak, gruplar birçok rapor içermelidir. Gruplandırmayı saatlik, günlük, haftalık veya istediğiniz başka bir ritimde yapabilirsiniz. Bu strateji, daha yüksek trafik beklendiği belirli etkinlikler için değişebilir.
Örneğin, İlişkilendirme Raporlama API'si için toplu raporları gruplandırırken, daha büyük hacimli reklam dönüşümleri beklediğiniz büyük bir indirimin olduğu gün için gruplandırma stratejinizi saatlik olarak güncellemeye karar verebilirsiniz.
Private Aggregation API ile, üçüncü taraf web sitelerine yerleştirilmiş belirli bir içerikle ilgili büyük bir basın bülteninin yayınlandığı gün stratejinizi değiştirebilirsiniz.
Toplama hizmetini kullanarak verileri işleme
Toplama hizmeti, birleştirilebilir raporlardaki toplu verilerin şifresini çözer ve birleştirir, gürültü ekler ve nihai özet raporu döndürür. Bu hizmet, bu verileri korumak için gerekli güvenlik önlemlerini destekleyen bir bulut hizmetinde dağıtılan güvenilir bir yürütme ortamında (TEE) çalışır.
İlişkilendirme raporları içeren özet raporlar
Reklam teknolojisi sağlayıcıların özet rapor alabilmesi için aşağıdaki adımların uygulanması gerekir:
- Reklam teknolojisi sağlayıcı, tek tek kullanıcıların tarayıcılarından toplanabilir raporlar toplar.
- Reklam teknolojisi sağlayıcı, toplanabilir raporları gruplandırır ve grupları toplama hizmetine gönderir.
- Toplama hizmeti, verileri toplamak için bir çalışan planlar.
- Toplama işleyici, toplanabilir raporlardaki verilerin şifresini çözer ve gürültü eklenmiş verilerle birlikte toplar.
- Toplama hizmeti, özet raporu reklam teknolojisi sağlayıcıya döndürür.

Reklam teknolojisi, teklif verme sürecini bilgilendirmek ve kendi müşterilerine raporlama sunmak için özet raporu kullanabilir. Özet raporlar için önerilen biçim JSON kodlamalı şemadır.
Gizli toplama içeren özet raporlar
- Paylaşılan Depolama tarafından toplanan siteler arası verileri okuyun ve verileri gruplamak için bir toplama anahtarı oluşturun.
- Paylaşılan Depolama iş parçasından, toplama anahtarını ve toplamak istediğiniz değeri kullanarak Özel Toplama API'sini çağırın. Tarayıcı, girişinizden şifrelenmiş bir toplanabilir rapor oluşturur ve toplanması için sunucunuza gönderir.
- Toplanabilir raporları gruplandırın ve işleme için toplama hizmetine gönderin.
- Toplama hizmeti, toplu raporları işler ve ardından gürültü ekler.
- Toplama hizmeti, özet raporu istek sahibine döndürür.
Etkileşim kurma ve geri bildirim paylaşma
Özet raporlar, Özel Korumalı Alan ölçüm tekliflerinin önemli bir parçasıdır. Diğer Özel Korumalı Alan teklifleri gibi bu teklif de GitHub'da belgelenmiş ve herkese açık olarak tartışılmıştır.
- Attribution Reporting API'den bahsedin.
- Private Aggregation API'den bahsedin.
- Geliştirici desteği: Privacy Sandbox Geliştirici Destek deposunda soru sorabilir ve tartışmalara katılabilirsiniz.