Bir reklam tıklamasının veya görüntülemenin, satın alma gibi bir dönüşümle sonuçlandığı durumları reklamverenin sitesine bakın.
Kimler kullanabilir?
Burada İlişkilendirme Raporları'nın temellerini ve bazı temel ama fazla teknik ayrıntı yok.
- Reklamcılık veya reklam teknolojisi alanında çalışıyorsanız bu API'nin üçüncü taraf çerezlerinin etkinleştirdiği özellikler sunar. Kontrol et kullanım alanlarına göz atabilirsiniz. raporlar oluşturulduğunda.
- Geliştirici veya yazılım mühendisiyseniz tam sisteme genel bakış veya deneme ve katılım bunu API ile yapabilirsiniz.
Dönüşüm için reklam teknolojisi platformlarından yararlanan reklamverenler ve yayıncılar doğrudan API'yi kullanması gerekmez. İlginizi çekebilir: reklam teknolojinizin entegre edilmesi planlandığı takdirde İlişkilendirme Raporları'nın nasıl çalıştığını anlama bu API'yi kullanın.
Attribution Reporting API nedir?
Günümüzde reklam dönüşümü ölçümü için genellikle üçüncü taraf çerezler. Tarayıcılar, üçüncü taraf çerezlerine erişimi kısıtlar çünkü bunlar Kullanıcıları sitelerde izlemek ve kullanıcı gizliliğini engellemek için kullanılır.
Attribution Reporting API bu ölçümlerin üçüncü taraf çerezleri olmadan, yalnızca gizliliği korumaya yönelik bir uygulama çalışması yapmaktır.
Bu API, reklamverenlerin ve reklam teknolojisi sağlayıcıların dönüşümleri aşağıdaki durumlarda:
- Reklam tıklama sayısı ve görüntüleme sayısı.
- Üçüncü taraf iframe'lerdeki reklamlar (örneğin, üçüncü taraf reklam teknolojisi sağlayıcısıdır.
- Birinci taraf bağlamında yer alan reklamlar (ör. sosyal ağdaki veya aramadaki reklamlar) arama motoru sonuçları sayfasında veya kendi reklamlarını sunan bir yayıncıda.
Bu terimlerden veya kavramlardan bazılarını bilmiyorsanız lütfen Özel Korumalı Alan sözlüğü.
API'yi deneyin
- Tarayıcınızda yerel olarak test edin. İşaret oluşturun, Bu kod, Chrome tarayıcıya belirli bir deneysel özelliği etkinleştirmesini özellikleri.
API ile denemeler yapmak istiyorsanız şuraya gidin: İlişkilendirme Raporlama: Deneme ve katılım.
API değişiklikleri
- API değişikliklerini takip edin.
- 2023'ün ilk yarısında Attribution Reporting API'yi neden gönderdiğimizi öğrenin.
Kullanılabilirlik
Teklif | Durum |
---|---|
Dönüşüm yolculuğu: Uygulamadan web'e Web açıklayıcısı ve Android açıklayıcısı Posta listesi duyurusu |
Chrome ve Android'de kaynak denemesi için kullanılabilir |
Dönüşüm yolculuğu: cihazlar arası Açıklama |
Bu teklif arşivlendi. Şu anda uygulamaya yönelik bir plan bulunmamaktadır. |
Rapor doğrulamasını kullanarak geçersiz toplanabilir raporları önleme Açıklama |
2024'ün ilk yarısında Chrome'da kullanıma sunulması bekleniyor |
Attribution Reporting API İzin Politikası için varsayılan izin verilenler listesi aynı kalacak * Posta listesi duyurusu |
2023'ün 1. çeyreğinde Chrome'da kullanıma sunulacak |
Yapılandırılabilir etkinlik düzeyinde raporlama epsilon GitHub sorunu |
2023'ün 4. çeyreğinde Chrome'da kullanıma sunulacak |
Birleştirilebilir rapor yükü için dolgu Güncellenen açıklayıcı |
2023'ün 4. çeyreğinde Chrome'da kullanıma sunulacak |
1. Aşama Lite Esnek Etkinlik Düzeyinde Esnek etkinlik düzeyinde yapılandırma açıklaması |
2023'ün 4. çeyreğinde Chrome'da kullanıma sunulacak
İlişkilendirme raporlarının sayısını ve raporlama aralıklarının sayısını/uzunluğunu özelleştirme olanağı. 2024'ün 1. çeyreğinde Chrome'da kullanıma sunulacak Tetikleyici verilerinin bit sayısını özelleştirme olanağı. |
Üçüncü taraf çerezleri için destek sonlandırıldıktan sonra İlişkilendirme raporlarında hata ayıklama desteği GitHub ile ilgili geri bildirim arama |
2024'ün ilk yarısında Chrome'da kullanıma sunulması bekleniyor |
Google Cloud için Attribution Reporting API ve Toplama Hizmeti Desteği Attribution Reporting API Explainer Aggregation Service Explainer |
2023'ün ikinci yarısında Chrome'da kullanılabilir |
Kullanım alanları ve özellikler
Attribution Reporting API, yüksek performans gösteren bir reklamverene veya üçüncü taraf reklam teknolojisine gönderilebilecek iki tür rapor sağlar. Bu iki rapor türü aynı anda kullanılabilir birbirini tamamlar.
- Etkinlik düzeyindeki raporlar belirli bir reklamı ilişkilendirir. (reklam tarafında) tıklayın. Dönüşüm tarafı verileri çok sınırlıdır ve verilere gürültü uygulanır (yani vakaların küçük bir yüzdesinde gerçek raporlar yerine rastgele veriler gönderilir). Bu işlem, kullanıcı kimliklerinin siteler. Ek gizlilik koruması olarak raporlar gecikmeli olarak gönderilir.
- Özet raporlar, çok önemlidir. Bu raporlar, daha zengin ve daha yüksek doğruluk oranına sahip dönüşüm verileri sağlar daha etkili sonuçlar verir. Çeşitli gizlilik tekniklerini birlikte kullanmak, arasında kimlik kaynaştırılması riskini artırır.
Etkinlik düzeyindeki raporlar
Etkinlik düzeyindeki raporlar, bir reklam tıklamasını veya görüntülemeyi genel dönüşüm verileriyle ilişkilendirir.
![Etkinlik düzeyinde rapor](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=9&hl=tr)
news.example
üzerindeki 200400600 tıklama kimliği (news.example
üzerindeki Bob_Doe kullanıcı kimliğine eklendi) shop.example
tarihinde satın alma işlemiyle sonuçlandı.Etkinlik düzeyindeki raporlar aşağıdakiler için uygundur:
- Optimizasyon. "Gelirimi nasıl artırabilirim?" veya nasıl belirlersiniz? Bu raporlar bilhassa reklamı optimize etmek için reklam tarafı benzersiz kimlikler raporlarda kullanılabileceğinden Etkinlik düzeyindeki raporlar, makine öğrenimi modelleri için eğitim verileri sağlayabilir.
- Hakkında çok az bilginin gerekli olduğu genel raporlama gösterir. Mevcut sınır, tıklamalar için 3 bit dönüşüm verisidir⏤ dönüşüme sekiz kategoriden biri ve her bir veri türü için 1 bit görüntüleme. Ayrıntılı dönüşüm tarafı verilerinin kodlanması (örneğin, özel fiyat veya dönüşüm zamanı etkinlik düzeyindeki raporlarda desteklenmez.
- Sahtekarlık tespiti. Bazı raporlardaki veriler reklam sahtekarlığı için faydalı olabilir yardımcı olabilecek kalıpları anlamanıza olanak tanıyarak tespit etmek için kullanılan dönüşüm etkinlikleridir.
Özet raporlar
Özet raporlar (önceki adıyla toplu raporlar) daha ayrıntılı Dönüşüm verileri ve tıklama ya da görüntüleme verileri ile dönüşümü birleştirmek için daha fazla esneklik dışı verilerdir.
Özet raporlar hakkında daha fazla bilgi edinin.
![Özet raporlardan elde edilen analizleri gösteren örnek.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=9&hl=tr)
news.example
tarihli 1234567 numaralı kampanya, shoes.example
tarihinde 518 dönüşüm ve 38.174 ABD doları harcama ile sonuçlandı. Dönüşümlerin yarısı ABD'nin New York bölgesindeki kullanıcılardan geldi.Özet raporlar, raporlama amaçlı kullanım alanları için idealdir. Bu raporlar, kullanıcıların "Yatırım getirim ne?" gibi sorulara yanıt bulabilirsiniz.
Optimizasyon için özet raporları kullanma (örneğin, belirli bir satın alma değerine (etkinlik düzeyindeki raporlar tarafından desteklenmez) verileri çok genel olduğunda) aktif bir araştırma alanıdır.
Diğer özellikler
Bu API'nin diğer özellikleri şunlardır:
- Uygulamadan web'e ilişkilendirme: Uygulamadaki bir reklamı görüp veya tıklayarak web'de dönüşüm gerçekleştirebilirsiniz.
Tarayıcı desteği
- Firefox ve Edge'in sinyalleri ortak değildir.
- Safari ve Webkit negatif ve reklam dönüşümlerini ölçmek için Özel Tıklama adı verilen farklı bir API önerdi. Ölçüm.
İki API farklı olsa da Chrome ve WebKit daha basit hale getirmek için, örneğin özellik adlarını ve Raporlar için JSON yapısı.
Attribution Reporting API'nin özellik kümesi Safari ve WebKit tarafından önerilen Private Click Measurement API'si. En önemlisi, Attribution Reporting API ile:
- Görüntüleme ölçümü desteklenir.
- Etkinlik düzeyinde raporlar sağlanabilir.
- Özet raporlar, hem tıklama/görüntüleme hem de dönüşüm tarafında zengin bilgiler içerir.
- Reklam teknolojisi platformları gibi üçüncü taraflar, yayıncılar ve reklamverenler.
Tarayıcı yapılandırması
- Kullanıcılar, şu adresteki kullanıcı ayarlarından API'nin kapsamı dışında kalmayı seçebilir:
chrome://settings/adPrivacy
- API Gizli modda etkin değildir.
- Üçüncü taraf çerezleri devre dışı bırakıldığında API etkin değildir.
Siteler erişimi nasıl kontrol edebilir?
Belirli bir tarayıcıda kullanılabiliyorsa API, varsayılan olarak hem üst düzey belgelerde hem de komut dosyalarında ve aynı kaynak iframe'lerde yer alır.
Rastgele üçüncü taraflar (örneğin, tam olarak sizin için üst düzey erişime sahip bir komut dosyası içeren sayfaya eklenmişse. Bu API, bir yayıncının veya reklamverenin bilgisi olmadan: bu iframe'lerde, Attribution Reporting API'nin açıkça etkinleştirilmesi gerekir. İzinler politikasına tabidir.
<iframe src="..." allow="attribution-reporting"></iframe>
Bir sayfaya kaynaklar arası iframe'ler ekleyen üst düzey erişime sahip üçüncü taraflar: Attribution Reporting API'yi de İzin politikası.
Bir site, şunlar da dahil olmak üzere tüm taraflar için Attribution Reporting API'yi devre dışı bırakabilir: komut dosyalarını üst düzey erişime sahip komut dosyaları için kullanabilirsiniz:
Permissions-Policy: attribution-reporting=()
Attribution Reporting API nasıl çalışır?
Attribution Reporting API, birbirine bağlı iki etkinliğin ölçülmesine olanak tanır. birlikte: yayıncının web sitesindeki bir etkinlik (örneğin, bir kullanıcının görüntüleme veya tıklama gibi) reklamverenin sitesinde daha sonra dönüşümle sonuçlanacak.
Etkinlik düzeyindeki raporlar
![etkinlik düzeyinde rapor](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=9&hl=tr)
Tarayıcı, tıklamaları veya görüntülemeleri bir reklam teknolojisi tarafından tanımlanan dönüşüm verileriyle eşleştirir.
Daha sonra tarayıcı, sonuç raporlarını önceden tanımlanmış bir uç noktaya, biraz gecikme ve sapmayla gönderir.
Özet raporlar
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=9&hl=tr)
Özet raporlar şu şekilde oluşturulur:
- Kullanıcı özel olarak yapılandırılmış bir reklamı tıklar veya görüntüler. Kullanıcının yerel cihazındaki tarayıcı, bu etkinliği önceden belirlenmiş ilişkilendirme yapılandırma verileriyle birlikte kaydeder.
- Daha sonra kullanıcı dönüşüm gerçekleştirdiğinde tarayıcı, bu ayrıntılı tıklama veya görüntüleme etkinliğini (ilişkilendirme kaynak etkinliği olarak bilinir) ayrıntılı dönüşüm verileriyle (ilişkilendirme tetikleyicisi verileri olarak bilinir) eşleştirir. Yakalanan ayrıntıların boyutları bir reklam teknolojisi şirketi tarafından önceden tanımlanmıştır ve tarayıcı, reklam teknolojisinin tanımladığı belirli bir mantığı izler. Tarayıcı bu verileri toplanabilir bir raporda oluşturur.
- Toplanabilir raporlar tarayıcı tarafından şifrelenir ve reklam teknolojisi sunucusuna gönderilir. Toplanabilir raporlar, reklam teknolojisi sunucusundan özet rapor oluşturmak için toplama hizmetine gönderilir.
- Özet raporlar daha sonra reklam teknolojisine sunulur. Özet raporların, etkinlik düzeyindeki raporlarla aynı sıklıkta gecikmediğini unutmayın.
Özet raporlar hakkında daha fazla bilgi edinin.
Gizlilik
Üçüncü taraf çerezlerinden farklı olarak, Attribution Reporting API reklamcılık şirketlerinin bu yeni çözümlerle ilgili bir kullanıcının etkinliğini izlemeden dönüşüm sayısı emin olun.
Bora adlı kişiyi ele alalım. Bora kitap okurken bir reklam görür
news.example
ile ilgili haberler. Bir hafta sonra Bora
shoes.example
Şu anda bu dönüşüm üçüncü bir tarafça izleniyor:
siteler arası tanımlayıcı olarak kullanılan çerez.
Bir reklam teknolojisi şirketi, üçüncü taraf çerezleri sayesinde birçok
(Bülent'in news.example
ve tarihindeki etkinliğiyle ilgili ayrıntılar)
shoes.example
. Reklam teknolojisi bu parçaları birleştirerek
oluşturmak için bilgilerini birlikte kullanarak
Ali'nin konumu, gezinme alışkanlıkları ve
news.example
tarihinde okunacaklar. Bu profil ayrıca
alışveriş, etkinlik ve kredi kartı bilgilerini dahil etme
shoes.example
Bu siteler arası birleştirme,
reklam dönüşümlerinin sayısı. Ancak aşağıdaki durumlarda kullanıcı gizliliğini olumsuz etkiler:
Bulut'un etkinliği, sitelerde çok ayrıntıya sahip bir şekilde izleniyor.
![Bugünün web'inin (birleştirilmiş kimlik) ve yarının web'in (bölümlendirilmiş kimlik) yan yana görünümü](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=9&hl=tr)
Az miktarda bilgi birleştirilir
dönüşümler bulunur. Dönüşümleri ölçmek için yeterlidir,
Bu, Ali'nin sitelerdeki etkinliğini ayrıntılı olarak izlemek için yeterlidir. İbrahim'in
news.example
ve shoes.example
üzerindeki etkinlik devam ediyor
ayırın.
Her rapor türündeki korumalar
Etkinlik düzeyindeki raporlar, bir reklam tarafı tanımlayıcısını az miktarda dönüşüm tarafı verileri için de geçerlidir. Bir kullanıcı ile ilgili siteler arası bilgiler sağlarlar. dönüşüm tarafı bilgileri, kullanıcıya katılmak için çok genel olduğunda kimlik doğrulamanızı da sağlar.
Özet raporları, yalnızca toplu düzeyde ayrıntılı analizler sağlar; çünkü içeriklerdeki Bu toplu raporlardan tanesi reklam teknolojisine gönderildiğinde şifrelenir. Ancak, raporlardaki hiçbir bilgiyi bir toplama hizmeti kullanmadan raporlayabilir. Yalnızca toplama hizmeti gürültülü kümelere erişim sağlar.
Ücret sınırlamaları gibi ek gizlilik korumaları her iki cihaza da uygulanır. etkinlik düzeyindeki ve toplu raporlar için geçerlidir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=9&hl=tr)
Ayrıntılı bilgi: Etkinlik düzeyinde raporlar ve gizlilik
Etkinlik düzeyindeki raporlar, kullanıcıları aşağıdaki gizlilik mekanizmalarını kullanarak yapabilirsiniz:
- Siteler arası tanımlayıcı kullanılmaz ve ayrıntılı siteler arası tarama etkinliği yoktur cihazdan ayrılır.
- Etkinlik düzeyindeki raporlar, reklam tarafında 64 bit bilgiyi ilişkilendirir.
(
news.example
), dönüşüm tarafında yalnızca 1 bit veya 3 bit ile (shop.example
). 64 bit, bir veri analisti oluşturmak için bağımsız kullanıcı tanımlayıcısı, ancak bu 64 bit yalnızca siteler arası bilgi miktarı çok az: tutmak için yeterli olmayan 1 veya 3 bit belirtir.- Reklam tarafı 64 bit yeni bir bilgi değildir. Bir kullanıcı kimliği
kullanılabilecektir.
news.example
veyaadtech.example
belirli bir kullanıcınınnews.example
ürününden haberdar olduğunu zaten biliyor.
- Reklam tarafı 64 bit yeni bir bilgi değildir. Bir kullanıcı kimliği
kullanılabilecektir.
- Kötüye kullanımı ve siteler arası izlemeyi önlemek için ek korumalar uygulanır:
- Raporlar bir gecikme ile gönderilir.
- Dönüşüm verileri gürültülenir: İşlemin belirli bir yüzdesinde sahte raporlar oluşturulur.
- İlişkilendirilen dönüşüm raporlarının sayısı, tıklama veya görüntüleme başına sınırlıdır.
Ayrıntılı bilgi: Özet raporlar ve gizlilik
Özet raporları, bir tıklama veya görüntüleme etkinliğini ayrıntılı dönüşüm verileriyle ilişkilendirir. Aşağıdaki gizlilik mekanizmalarını kullanarak, sitelerde kullanıcıları izlemeden dönüşüm analizleri sağlar:
- Siteler arası tanımlayıcı kullanılmaz.
- Her ilişkilendirme, özete birden fazla katkı sağlayabilir rapordur. Herhangi bir kullanıcı belirli bir alan için birden fazla ilişkilendirmeyi tetikleyebilir tıklama (veya görüntüleme) ve dönüşüm.
- Veriler, birçok etkinliğin (birçok kullanıcı) düzeyine kadar toplanır ve münferit olaylar hassas bir şekilde gözlemlenebilir. Aynı şekilde ayrıntı düzeyi arttıkça göreli gürültü de artar, veriler de artıyor. Çok sayıda etkinliği toplayan veri dilimleri ve kullanıcıların kullanışlılığı korumak için daha doğru bilgiler vermesidir.
- Ayrıntılı bir tıklama veya görüntüleme etkinliğini ayrıntılı bir tıklama veya görüntüleme etkinliğiyle ilişkilendiren ham raporlar, Dönüşüm verileri şifreleniyor ve reklam teknolojisi şirketi tarafından okunamıyor. Bu veriler yalnızca toplama hizmeti tarafından okunabilir.
- Kötüye kullanımı ve siteler arası izlemeyi önlemek için ek korumalar uygulanır:
- Raporlar rastgele gecikmelerle gönderilir.
- Farklı veri dilimlerindeki sorgular hızla sınırlıdır.
Etkileşimde bulunun ve geri bildirim paylaşın
- API hakkında sorular için: sorun oluştur inceleyebilirsiniz.
- API güncellemeleri ve duyuruları için İlişkilendirme Raporu posta listesi.
- Teknik sorularınız varsa Chromium hatası bildirin.
- Uygulama, entegrasyon ve genel en iyi uygulama soruları için: sorun oluştur .