Bir reklam tıklamasının veya görüntülemesinin, reklamveren sitesinde satın alma gibi bir dönüşümle sonuçlandığını ölçün.
Bu araç kimler için tasarlandı?
İlişkilendirme raporlamasının temellerini ve bazı temel kavramları burada bulabilirsiniz ancak teknik ayrıntılar çok fazla değildir.
- Reklamcılık veya reklam teknolojisi alanında çalışıyorsanız bu API'nin üçüncü taraf çerezleri tarafından etkinleştirilen özellikleri nasıl sağladığı hakkında bilgi edineceksiniz. Raporların nasıl oluşturulduğu hakkında daha fazla ayrıntı içeren API kullanım alanlarını inceleyin.
- Geliştirici veya yazılım mühendisiyseniz sisteme genel bakış sayfasına gidin veya API ile deneme yapın ve katılımda bulunun.
Dönüşüm ölçümü için reklam teknolojisi platformlarına güvenen reklamverenlerin ve yayıncıların API'yi doğrudan kullanması gerekmez. Reklam teknolojiniz bu API ile entegrasyon yapmayı planlıyorsa Attribution Reporting'in işleyiş şeklini öğrenmek isteyebilirsiniz.
Attribution Reporting API nedir?
Günümüzde reklam dönüşümü ölçümü genellikle üçüncü taraf çerezlerine dayanır. Tarayıcılar, kullanıcıları siteler arasında izlemek ve kullanıcı gizliliğini engellemek için kullanılabilecekleri için üçüncü taraf çerezlerine erişimi kısıtlıyor.
Attribution Reporting API, bu ölçümleri üçüncü taraf çerezleri olmadan gizliliği koruyacak şekilde sağlar.
Bu API, reklamverenlerin ve reklam teknolojisi sağlayıcıların aşağıdaki durumlarda dönüşümleri ölçmesini sağlar:
- Reklam tıklamaları ve görüntüleme sayısı.
- Üçüncü taraf iFrame'deki reklamlar (ör. üçüncü taraf reklam teknolojisi sağlayıcısı kullanan bir yayıncı sitesindeki reklamlar).
- Sosyal ağ veya arama motoru sonuçları sayfasında yer alan reklamlar ya da kendi reklamlarını yayınlayan bir yayıncı gibi birinci taraf bağlamındaki reklamlar.
Bu terimlerden veya kavramlardan bazılarını bilmiyorsanız Gizlilik Korumalı Alan sözlüğüne göz atın.
API'yi deneyin
- Tarayıcınızda yerel olarak test edin. Chrome Tarayıcı'ya belirli deneysel özellikleri etkinleştirmesini bildiren bir işaret ayarlayın.
API'yi denemek istiyorsanız İlişkilendirme raporları: deneme ve katılım başlıklı makaleyi inceleyin.
API değişiklikleri
- API değişikliklerini takip edin.
- 2023'ün ilk yarısında Attribution Reporting API'yi neden kullanıma sunduk?
Kullanılabilirlik
Teklif | Durum |
---|---|
Dönüşüm yolculuğu: uygulamadan web'e Web açıklama sayfası ve Android açıklama sayfası Posta listesi duyurusu |
Kaynak denemesi için Chrome ve Android'de kullanılabilir |
Dönüşüm yolculuğu: cihazlar arası Açıklama |
Bu teklif arşivlendi. Şu anda uygulamayla ilgili herhangi bir plan yoktur. |
Rapor doğrulamasını kullanarak geçersiz toplu raporları önleme Açıklama |
Bu teklif arşivlendi. Bu kullanım alanı için bunun yerine trigger_context_id aracını uyguladık. |
Attribution Reporting API izinleri politikasının 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 sunulacaktır. |
Toplanabilir raporlar yükü için dolgu Güncellenen açıklama |
2023'ün 4. çeyreğinde Chrome'da kullanıma sunulacaktır. |
Esnek etkinlik düzeyi Esnek etkinlik düzeyi yapılandırmaları hakkında |
2023'ün 4. çeyreğinde Chrome'da kullanıma sunulacaktır
İlişkilendirme raporlarının sayısını ve raporlama aralıkları sayısını/uzunluğunu özelleştirme olanağı. Chrome'da 2024'ün 1. çeyreğinde kullanıma sunulacak Tetikleyici verisi bit sayısını özelleştirme olanağı. |
Üçüncü taraf çerezlerine bağlı olmayan Attribution Reporting ayrıntılı hata ayıklama raporları için destek Açıklama |
2024'ün 3. çeyreğinde Chrome'da kullanıma sunulacak |
Google Cloud için Attribution Reporting API ve Aggregation Service desteği Attribution Reporting API Açıklaması Aggregation Service Açıklaması |
2023'ün 2. yarısında Chrome'da kullanıma sunulacak |
Esnek katkı filtreleme Açıklama |
2024'ün 3. çeyreğinde Chrome'da kullanıma sunulacak |
İlişkilendirme öncesi filtreleme: İlişkilendirme kapsamları Açıklama |
2024'ün 4. çeyreğinde Chrome'da kullanıma sunulmuştur. |
Kullanım alanları ve özellikler
Attribution Reporting API, bir reklamverene veya üçüncü taraf reklam teknolojisi sağlayıcıya gönderilebilecek iki tür raporla farklı analiz türlerine erişim sağlar. Bu iki rapor türü aynı anda kullanılabilir ve birbirini tamamlar.
- Etkinlik düzeyindeki raporlar, belirli bir reklam tıklamasını veya görüntülemesini (reklam tarafında) dönüşüm tarafındaki verilerle ilişkilendirir. Dönüşüm tarafı verileri çok sınırlıdır ve verilerde gürültü vardır (yani, küçük bir yüzdelik oranda gerçek raporlar yerine rastgele veriler gönderilir). Bu, kullanıcı kimliğinin siteler arasında birleştirilmesini engelleyerek kullanıcı gizliliğini korur. Ek bir gizlilik koruması olarak raporlar gecikmeli olarak gönderilir.
- Özet raporlar, reklam tarafında belirli bir etkinliğe bağlı değildir. Bu raporlar, etkinlik düzeyindeki raporlardan daha zengin ve daha yüksek doğruluk oranına sahip dönüşüm verileri sağlar. Gizlilik tekniklerinin bir kombinasyonu, siteler arasında kimlik birleştirme riskini azaltmaya yardımcı olur.
Etkinlik düzeyindeki raporlar
Etkinlik düzeyindeki raporlar, bir reklam tıklamasını veya görüntülemesini kaba dönüşüm verileriyle ilişkilendirir.
![Etkinlik düzeyinde rapor](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?hl=tr)
news.example
'daki 200400600 tıklama kimliği (news.example
'daki Bob_Doe kullanıcı kimliğine eklenmiş), shop.example
'de satın alma işlemine yol açmıştır.Etkinlik düzeyindeki raporlar şunlar için uygundur:
- Optimizasyon. "Yatırım getirimi nasıl artırabilirim?" gibi soruları yanıtlayın. Özellikle bu raporlar, reklam tarafı tekil kimlikleri raporlarda kullanılabildiğinden reklam yerleşimini optimize etmek için kullanılabilir. Etkinlik düzeyindeki raporlar, makine öğrenimi modelleri için eğitim verileri sağlayabilir.
- Dönüşüm hakkında çok az bilgi gerektiren genel raporlama. Mevcut sınır, tıklamalar için 3 bit dönüşüm verisi (bir dönüşüme sekiz kategoriden biri atanabilir) ve görüntülemeler için 1 bittir. Belirli bir fiyat veya dönüşüm zamanı gibi dönüşüm tarafı ayrıntılı verilerinin kodlanması, etkinlik düzeyindeki raporlarda desteklenmez.
- Sahtekarlığı algılama. Bazı raporlardaki veriler, spam veya geçersiz etkinliği tespit etmek için kullanılabilecek kalıpları anlamanıza olanak tanıyarak reklam sahtekarlığını tespit etmek ve analiz etmek için yararlı olabilir.
Özet raporlar
Özet raporlar (eski adıyla birleştirilmiş raporlar), daha ayrıntılı dönüşüm verileri ve tıklama veya görüntüleme verileri ile dönüşüm verilerini birleştirme konusunda daha fazla esneklik sunar.
Özet raporları hakkında daha fazla bilgi edinin.
![Özet raporlardaki analizleri gösteren örnek.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?hl=tr)
news.example
'daki 1234567 kampanya kimliği, shoes.example
'de 518 dönüşüm ve toplam 38.174 ABD doları harcama sağladı. Dönüşümlerin yarısı ABD, New York'taki kullanıcılardan geldi.Özet raporlar, raporlama kullanım alanları için en uygun raporlardır. Bu raporlar, "Yatırım getirim ne kadar?" gibi soruları yanıtlamanıza yardımcı olur.
Optimize etmek için özet raporların kullanımı (ör. dönüşüm verileri çok kaba olduğu için etkinlik düzeyindeki raporlar tarafından desteklenmeyen bir satın alma değeri için optimizasyon yapmak amacıyla) aktif bir araştırma alanıdır.
Diğer özellikler
Bu API'nin diğer özellikleri şunlardır:
- Uygulama ile web ilişkilendirmesi: Bir uygulamada reklam görür veya tıklar ve web'de dönüşüm gerçekleştirirsiniz.
Tarayıcı desteği
- Firefox ve Edge sinyal paylaşmamıştır.
- Safari ve Webkit olumsuz bir yanıt verdi ve reklam dönüşümlerini ölçmek için Gizli Tıklama Ölçümü adlı farklı bir API önerdi.
İki API farklı olsa da Chrome ve WebKit, geliştirici deneyimini basitleştirmek için açık bir şekilde birlikte çalışır. Örneğin, özellik adları ve raporlar için JSON yapısı konusunda uyumlu hale gelirler.
Attribution Reporting API'nin özellik grubu, Safari ve WebKit tarafından önerilen Private Click Measurement API'den farklıdır. Özellikle 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 adına rapor alabilir.
Tarayıcı yapılandırması
- Kullanıcılar,
chrome://settings/adPrivacy
adresindeki kullanıcı ayarlarını kullanarak API'yi devre dışı bırakabilir. - API, Gizli modda etkin değildir.
Siteler erişimi nasıl kontrol edebilir?
API belirli bir tarayıcıda kullanılabiliyorsa varsayılan olarak herhangi bir sitede, hem üst düzey belgelerde ve komut dosyalarında hem de aynı kaynaktaki iFrame'lerde kullanılabilir.
İsteğe bağlı üçüncü taraflar (ör. sayfaya üst düzey erişimi olan bir komut dosyasıyla eklenmeyen çapraz kaynak reklam iframe'leri) API'yi yayıncının veya reklamverenin bilgisi olmadan kullanamaz. Bu iframe'lerde Attribution Reporting API'nin izin politikasıyla açıkça etkinleştirilmesi gerekir.
<iframe src="..." allow="attribution-reporting"></iframe>
Bir sayfaya çapraz kaynak iFrame'leri ekleyen üst düzey erişime sahip üçüncü taraflar, İzinler Politikası ile İlişkilendirme Raporlama API'yi de etkinleştirebilir.
Bir site, HTTP yanıt üst bilgisini göndererek Attribution Reporting API'yi üst düzey erişime sahip komut dosyaları da dahil olmak üzere tüm taraflar için devre dışı bırakabilir:
Permissions-Policy: attribution-reporting=()
Attribution Reporting API nasıl çalışır?
Attribution Reporting API, birbiriyle bağlantılı iki etkinliğin ölçülmesini sağlar: bir yayıncının web sitesinde gerçekleşen etkinlik (ör. kullanıcının bir reklamı görüntülemesi veya tıklaması) ve ardından bir reklamverenin sitesinde gerçekleşen dönüşüm.
Etkinlik düzeyindeki raporlar
![etkinlik düzeyinde rapor](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?hl=tr)
Tarayıcı, tıklamaları veya görüntülemeleri bir reklam teknolojisinin tanımladığı dönüşüm verileriyle eşleştirir.
Ardından tarayıcı, oluşturulan bu raporları önceden tanımlanmış bir uç noktaya biraz gecikme ve ilgisiz noktalar içerecek şekilde gönderir.
Özet raporlar
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?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 belirtilmiş ilişkilendirme yapılandırması 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 kaynağı etkinliği olarak bilinir), ayrıntılı dönüşüm verileriyle (ilişkilendirme tetikleyici verileri olarak bilinir) eşleştirir. Yakalanan ayrıntının boyutlarını bir reklam teknolojisi şirketi önceden tanımlar ve tarayıcı, reklam teknolojisinin tanımladığı belirli mantığı izler. Tarayıcı bu verileri toplanabilir bir rapor halinde sunar.
- Toplanabilir raporlar tarayıcı tarafından şifrelenir ve bir reklam teknolojisi sunucusuna gönderilir. Toplanabilir raporlar, özet rapor üretilmesi için reklam teknolojileri sunucusundan sonra toplama hizmetine gönderilir.
- Ardından, özet raporlar reklam teknolojilerinin kullanımına sunulur. Özet raporlarda, etkinlik düzeyindeki raporlar kadar gecikme yaşanmadığını hatırlatırız.
Özet raporları hakkında daha fazla bilgi edinin.
Gizlilik
Üçüncü taraf çerezlerinin aksine Attribution Reporting API, reklam şirketlerinin bir kullanıcının sitelerdeki etkinliklerini izlemeden dönüşümler hakkında analizler elde etmesine olanak tanır.
Bora isimli bir kullanıcıyı ele alalım. Bülent, news.example
'te haberleri okurken bir reklam görür. Bir hafta sonra Bora, shoes.example
sitesinden ayakkabı satın alır.
Günümüzde bu dönüşüm, siteler arası tanımlayıcı olarak kullanılan bir üçüncü taraf çerezi tarafından izlenir.
Reklam teknolojisi şirketleri, üçüncü taraf çerezleri sayesinde Boran'ın news.example
ve shoes.example
'daki etkinlikleriyle ilgili birçok ayrıntıya erişebilir. Reklam teknolojisi, bu bilgi parçalarını birleştirerek Bora'nın konumu, tarama alışkanlıkları ve news.example
'te tercih ettiği okumalar da dahil olmak üzere Bora'nın ayrıntılı bir profilini oluşturabilir. Bu profil, shoes.example
'teki satın alma işlemleri, etkinlikler ve kredi kartı bilgilerini de içerebilir. Bu siteler arası ortak, reklam dönüşümlerini ölçmek için yararlıdır. Ancak bu durum kullanıcı gizliliğini engeller:
Barış'ın etkinliği, sitelerde yüksek düzeyde ayrıntıyla izlenir.
![Bugünün web'i (birleştirilmiş kimlik) ve yarının web'i (bölünmüş kimlik) yan yana görünümü](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?hl=tr)
Siteler arasında küçük miktarda bilgi birleştirilir. Bu bilgi, dönüşümleri ölçmek için yeterlidir ancak Bob'ın sitelerdeki etkinliğini ayrıntılı olarak izlemek için yeterli değildir. Boran'ın news.example
ve shoes.example
'daki etkinlikleri birbirinden ayrı kalır.
Her rapor türünde bulunan korumalar
Etkinlik düzeyindeki raporlar, reklam tarafı tanımlayıcısını dönüşüm tarafı verilerinin küçük bir miktarıyla bağlar. Dönüşümle ilgili siteler arası bilgiler sağlarlar ancak dönüşüm tarafındaki bilgiler, siteler arasında kullanıcı kimliğini birleştirmek için çok kabadır.
Özet raporlar ayrıntılı analizler sağlar ancak yalnızca toplu düzeydedir. Bu toplanabilir raporların içeriği reklam teknolojisine gönderilirken şifrelenir. Bu nedenle, reklam teknolojisi bir toplama hizmeti kullanmadan raporlardan hiçbir bilgi alamaz. Toplama hizmeti yalnızca gürültülü toplamalara erişim sağlar.
Hem etkinlik düzeyindeki hem de toplu raporlara ücret sınırlamaları gibi ek gizlilik korumaları uygulanır.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?hl=tr)
Ayrıntılı bilgi: Etkinlik düzeyindeki raporlar ve gizlilik
Etkinlik düzeyindeki raporlar, aşağıdaki gizlilik mekanizmalarını uygulayarak kullanıcıları sitelerde takip etmeden dönüşüm analizleri sağlar:
- Siteler arası tanımlayıcı kullanılmaz ve siteler arası ayrıntılı tarama etkinliği cihazdan dışarıya çıkmaz.
- Etkinlik düzeyindeki raporlar, reklam tarafındaki 64 bitlik bilgiyi (
news.example
) dönüşüm tarafındaki yalnızca 1 bit veya 3 bitle (shop.example
) ilişkilendirir. 64 bit, tek bir kullanıcı tanımlayıcısıyla eşlenecek kadar bilgidir ancak bu 64 bit yalnızca çok az sayıda siteler arası bilgiyle bağlanabilir: 1 bit veya 3 bit. Bu bilgiler, bir tanımlayıcıyı saklamak için yeterli değildir.- Reklam tarafı 64 bit yeni bir bilgi değildir. Kullanıcı kimliği, reklam tarafında halihazırda kullanılabilir.
news.example
veyaadtech.example
, belirli bir kullanıcınınnews.example
'teki etkinliğini zaten biliyorsa
- Reklam tarafı 64 bit yeni bir bilgi değildir. Kullanıcı kimliği, reklam tarafında halihazırda kullanılabilir.
- Kötüye kullanımı ve siteler arası izlemeyi önlemek için ek korumalar uygulanır:
- Raporlar gecikmeli olarak gönderilir.
- Dönüşüm verileri gürültüye sahiptir: Belirli bir yüzdede sahte raporlar oluşturulur.
- İlişkilendirilmiş 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 kullanıcıları sitelerde izlemeden dönüşüm analizleri sağlarlar:
- Siteler arası tanımlayıcı kullanılmaz.
- Her ilişkilendirme, sonuçta elde edilen özet rapora birden fazla katkıda bulunabilir. Belirli bir tıklama (veya görüntüleme) ve dönüşüm için herhangi bir kullanıcı birden fazla ilişkilendirmeyi tetikleyebilir.
- Veriler birçok etkinlik (birçok kullanıcı) düzeyinde birleştirilir ve tek tek etkinlikler tam olarak gözlemlenemez. Birleştirilmiş verilere bakıldığında, ayrıntı düzeyi arttıkça bu verilerdeki göreceli gürültü de artar. Çok sayıda etkinliği ve kullanıcıyı bir araya getiren veri dilimleri, yararlılığı korumak için daha doğrudur.
- Ayrıntılı bir tıklama veya görüntüleme etkinliğini ayrıntılı dönüşüm verileriyle ilişkilendiren ham raporlar şifrelenir ve reklam teknolojisi şirketi tarafından okunamaz. 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.
- Verilerin farklı dilimleri üzerindeki sorgular hız sınırlıdır.
Etkileşim kurma ve geri bildirim paylaşma
- API ile ilgili sorular için: API deposunda sorun oluşturun.
- Attribution Reporting posta listesinde API güncellemelerini ve duyuruları takip edin.
- Teknik sorularınız varsa Chromium hata bildiriminde bulunun.
- Uygulama, entegrasyon ve genel en iyi uygulama soruları için: Privacy Sandbox geliştirici destek deposunda sorun oluşturun.