Attribution Reporting API ve Private Aggregation API ile kullanıcılar arasında toplanan verileri ölçün.
Uygulama durumu
- Attribution Reporting özet raporlarına katılın ve bu raporlarla denemeler yapın.
Özet rapor nedir?
Bir kullanıcı grubu için özet raporu derlenir. Bu rapor, herhangi bir bireyle ilişkilendirilemez. Özet raporlar, tıklama ve görüntüleme verileri için esneklik sunan ayrıntılı dönüşüm verileri sağlar. Özet raporlar, üçüncü taraf çerezlerine veya siteler arasında tek tek kullanıcıları tanımlamak için kullanılabilecek mekanizmalara dayanmaz.
Özet raporlar iki bağlamda oluşturulur:
- Reklam ölçümü: Reklam teknolojileri, bir reklam tıklamasının veya görüntülemenin ne zaman bir reklamveren sitesinde dönüşüme (ör. satış veya kaydolma) yol açtığını ölçmek için Attribution Reporting ile özet raporlar oluşturabilir. Reklam teknolojileri, Private Aggregation ile Protected Audience API açık artırmaları için de özet raporlar oluşturabilir.
- Genel siteler arası raporlama: Geliştiriciler, siteler arası verileri Shared Storage'da yakalar ve Private Aggregation ile bu veriler hakkında rapor oluşturabilir. Bu özellik, kullanıcı demografik bilgileri hakkında analiz elde etme ve içerik için benzersiz erişimler yakalama gibi birçok amaçla kullanılabilir.
Özet raporları, İlişkilendirme Raporlama 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 sürecinizi 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şletmeniz hakkında analizler sağlar.
Çıkış raporu, ayrıntılı siteler arası dönüşüm verileri ve tıklama ile görüntüleme verilerini dönüşüm verileriyle birleştirme esnekliği sunar. Son çıktıyı, karar vermek için kullandığınız araçların girişi 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, toplam harcama değerine kaç dönüşümün yol açtığını belirlemek için özet raporlar oluşturursanız bu, 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ı olabilir.

Siteler arası etkileşim
Örneğin, üçüncü taraf bir web sitesinde içeriğinizi kaç kişinin okuduğunu belirlemek için özet raporlar oluşturursanız bu, ekibinizin daha yüksek etkileşim oluşturmak ve okuyucuları doğrudan sitenizi ziyaret etmeye teşvik etmek için söz konusu üçüncü tarafla nasıl ortaklık yapacağına karar vermesine yardımcı olabilir.
Tarayıcıda hangi bilgiler yakalanır?
Toplanabilir rapor, kullanıcının tarayıcısından alınan ham verilerdir. Bu veriler, önceden belirlenmiş bir grup paketi (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 toplu 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 ve ardından reklamı yapılan öğeyi satın alan kullanıcı sayısını ölçebilir. Başka bir kampanya, kaç reklam görüntülemenin reklamveren sitesi ziyaretlerine yol açtığını ölçebilir.
Örneğin, bir reklam teknolojisi sağlayıcısı news.example üzerinde bir reklam kampanyası yayınlıyor. Bu kampanyada dönüşüm, kullanıcının ayakkabı reklamını tıklayıp shoes.example üzerinde ayakkabı satın alma işlemini tamamlamasıdır.
Reklam teknolojisi, kimliği 1234567 olan bu reklam kampanyası için bir özet rapor alır. Bu raporda, 12 Ocak 2022'de shoes.example üzerinde toplam 518 dönüşüm gerçekleştiği ve toplam harcamanın 38.174 ABD doları olduğu belirtilir. Dönüşümlerin 9872 ürün SKU'lu mavi spor ayakkabı satın alan kullanıcılardan gelen kısmı %60, 2643 ürün SKU'lu sarı sandalet satın alan kullanıcılardan gelen kısmı ise %40'tır. Kampanya kimliği ayrıntılı reklam tarafı 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 yakalamadan önce hangi bilgileri toplamak istediğinizi tanımlamanız, belirli bir siteler arası entegrasyondan hangi dönüşümleri beklediğinizi belirlemeniz ve hangi rapor türünü toplayacağınızı belirlemeniz gerekir.
Private Aggregation belgelerinde ayrıntılı olarak açıklanan çeşitli kullanım alanları vardır. Bir örneği inceleyelim:
İçeriğinizi farklı sitelerde gören kullanıcıların demografik özelliklerini ölçmek isteyebilirsiniz. Özel toplama, "Almanya'da 18 ile 45 yaş aralığında yaklaşık 317 benzersiz kullanıcı var" gibi bir yanıt sağlayabilir. Öncelikle hangi bilgileri toplamak istediğinize (ör. yaş ve konum) karar verin. Ardından, üçüncü taraf sitesinden bu belirli demografi verilerini toplamak için Ortak Depolama'yı kullanın. Daha sonra, toplama anahtarına kodlanmış yaş grubu ve ülke boyutlarıyla Private Aggregation kullanarak bir rapor gönderebilirsiniz.
Veriler birleştirilmeden önce nasıl yakalanır?
Özet raporlar, bir grup bağımsız cihazdan alınan toplu verilerden oluşur. Tek bir kullanıcının işlemleri gözlemlenip incelenemese de toplama süreci her kişi için aynıdır.
Tek bir kullanıcının işlemleri şifrelenir ve toplanabilir bir raporda toplanır. Bu raporlar, toplu işleme ile ilgili küçük bir şifrelenmemiş meta veri de içerir.
İlişkilendirme Raporlama verileri için toplanabilir raporlar şu şekilde yakalanır:
- Bir kullanıcı bir yayıncı sitesini ziyaret eder ve bir reklamı görür veya tıklar. Bu etkinlik, ilişkilendirme kaynağı etkinliği olarak da bilinir.
- Birkaç dakika veya gün sonra kullanıcı dönüşüm gerçekleştirir. Bu, 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ülemeyi dönüşüm etkinliğiyle eşleştirir. Bu eşleşmeye göre tarayıcı, bir reklam teknolojisi sağlayıcısı tarafından oluşturulan belirli bir mantıkla toplanabilir bir rapor oluşturur.
- Tarayıcı bu verileri şifreler ve kısa bir gecikmenin ardından toplama için bir reklam teknolojisi sunucusuna gönderir. Reklam teknolojileri sunucusu, gürültü eklenmiş analizlere erişmek için bir toplama hizmetinden yararlanmalıdır.
Private Aggregation için aşağıdaki gibi görünür:
- Üçüncü taraf, neyi ölçeceğine karar verir ve verileri daha sonra okunmak üzere Paylaşılan Depolama'ya yazar.
- Kullanıcı, üçüncü tarafın ölçmek istediği şeyle eşleşen bir etkinliği tetikler. Örneğin, kullanıcı yerleştirilmiş içerik bulunan bir siteyi ziyaret ettiğinde üçüncü taraf, Shared Storage'daki verileri okuyabilir ve toplama için şifrelenmiş toplu raporları sunucunuza göndermek üzere Private Aggregation'ı kullanabilir.
Toplu olarak toplanabilir raporlar
Toplanan toplu raporların işlenip özet raporda toplanabilmesi için gruplandırılması gerekir. Toplu işlem, toplanabilir raporlardan oluşan stratejik bir gruptur.
Toplanabilir raporlarda, toplu işlemler oluşturmak için kullanılabilecek küçük bir şifrelenmemiş veri miktarı bulunur (shared_info olarak dahil edilir). Zaman damgası ve raporlama kaynağı buna dahildir. Rapor içindeki şifrelenmiş bilgilere göre toplu işlem yapamazsınız.
İdeal olarak, gruplar birçok rapor içerir. Saatlik, günlük, haftalık veya istediğiniz başka bir sıklıkta toplu işlem yapabilirsiniz. Bu strateji, daha yüksek trafik beklentisi olan belirli etkinlikler için değişebilir.
Örneğin, Attribution Reporting API için toplu rapor oluştururken, reklam dönüşümlerinin daha yüksek bir hacimde olmasını beklediğiniz büyük bir indirim gününde toplu rapor oluşturma stratejinizi saatlik olarak güncelleyebilirsiniz.
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ştirmeniz gerekebilir.
Toplama hizmetiyle verileri işleme
Toplama hizmeti, toplanabilir raporlardaki gruplandırılmış verilerin şifresini çözer ve verileri birleştirir, gürültü ekler ve nihai özet raporu döndürür. Bu hizmet, 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.
Attribution Reporting ile özet raporlar
Reklam teknolojisi sağlayıcıların özet rapor alabilmesi için aşağıdaki adımlar uygulanmalıdır:
- 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 çalışanı, toplanabilir raporlardaki verileri gürültülü verilerle birlikte şifre çözüp toplar.
- Toplama hizmeti, özet raporu reklam teknolojisi sağlayıcıya döndürür.
Reklam teknolojisi, teklif verme konusunda bilgi vermek ve kendi müşterilerine raporlama sunmak için özet raporu kullanabilir. Özet raporlar için önerilen biçim JSON kodlu şemadır.
Private Aggregation ile özet raporlar
- Shared Storage tarafından toplanan siteler arası verileri okuyun ve verileri gruplandırmak için bir toplama anahtarı oluşturun.
- Private Aggregation API'yi, bir Shared Storage işlevinden toplama anahtarı ve biriktirmek istediğiniz değerle birlikte çağırın. Tarayıcı, girişinizden şifrelenmiş bir toplanabilir rapor oluşturur ve toplama için sunucunuza gönderir.
- Toplanabilir raporları gruplandırın ve işlenmek üzere toplama hizmetine gönderin.
- Toplama hizmeti, gruplandırılmış raporları işler ve ardından gürültü ekler.
- Toplama hizmeti, özet raporu isteği gönderene 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 herkese açık olarak belgelenir ve tartışılır.
- Attribution Reporting API'yi tartışın.
- Private Aggregation API'yi açıklayın.