Bir reklam tıklamasının veya görüntülemenin, reklamverenin sitesinde satın alma gibi bir dönüşümle sonuçlandığı durumları ölçün.
Kimler kullanabilir?
Burada İlişkilendirme Raporları'nın temellerini ve bazı temel kavramları bulabilirsiniz, ancak fazla teknik ayrıntı içermez.
- Reklamcılık veya reklam teknolojisi sektöründe çalışıyorsanız bu API'nin, üçüncü taraf çerezleri tarafından etkinleştirilen özellikleri nasıl sağladığını öğreneceksiniz. Raporların nasıl oluşturulduğu konusunda daha ayrıntılı bilgi içeren API kullanım alanlarına göz atın.
- Geliştirici veya yazılım mühendisiyseniz tam sisteme genel bakış bölümüne gidin veya API ile deneme yapıp katılın.
Dönüşüm ölçümü için reklam teknolojisi platformlarını kullanan reklamverenlerin ve yayıncıların doğrudan API'yi kullanması gerekmez. Reklam teknisyeniniz bu API ile entegrasyon yapmayı planlıyorsa Attribution Reporting'in işleyiş şeklini anlamak isteyebilirsiniz.
Attribution Reporting API nedir?
Günümüzde reklam dönüşümü ölçümü için genellikle üçüncü taraf çerezleri kullanılmaktadır. Tarayıcılar, üçüncü taraf çerezlerine erişimi kısıtlar. Çünkü bu çerezler, sitelerde kullanıcıları izlemek ve kullanıcı gizliliğini engellemek için kullanılabilir.
Attribution Reporting API, bu ölçümleri üçüncü taraf çerezleri olmadan, gizliliği korumaya yönelik bir şekilde etkinleştirir.
Bu API, reklamverenlerin ve reklam teknolojisi sağlayıcıların aşağıdaki durumlarda dönüşümleri ölçmesine olanak tanır:
- Reklam tıklama sayısı ve görüntüleme sayısı.
- Üçüncü taraf iframe'lerdeki reklamlar (örneğin, üçüncü taraf bir reklam teknolojisi sağlayıcı kullanan bir yayıncı sitesindeki reklamlar).
- Birinci taraf bağlamındaki reklamlar (örneğin, bir sosyal ağdaki veya arama motoru sonuç sayfasındaki reklamlar ya da kendi reklamlarını sunan bir yayıncı).
Bu terim veya kavramlardan bazılarını bilmiyorsanız Özel Korumalı Alan sözlüğüne bakın.
API'yi deneyin
- Tarayıcınızda yerel olarak test edin. Chrome tarayıcıya belirli deneysel özellikleri etkinleştirmesini söyleyen bir bayrak belirleyin.
API ile denemeler yapmak istiyorsanız İlişkilendirme Raporu: deneme ve katılın bölümüne gidin.
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
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告 |
在 Chrome 和 Android 中可用,以进行源试用 |
转化历程:跨设备 说明 |
该提案已归档。目前没有实施计划。 |
使用报告验证功能防止无效的可汇总报告 说明 |
预计于 2024 年上半年在 Chrome 中推出 |
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知 |
将于 2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
将于 2023 年第 4 季度在 Chrome 中提供 |
可汇总报告载荷的内边距 更新了解释器 |
将于 2023 年第 4 季度在 Chrome 中提供 |
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明 |
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。 |
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈 |
预计于 2024 年上半年在 Chrome 中推出 |
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明 |
Chrome 将于 2023 年下半年推出 |
Kullanım alanları ve özellikler
Attribution Reporting API, bir reklamverene veya üçüncü taraf reklam teknolojisi sağlayıcısına gönderilebilecek iki tür rapor ile farklı analiz türlerine erişim sunar. Bu iki rapor türü eş zamanlı olarak kullanılabilir ve birbirini tamamlar.
- Etkinlik düzeyindeki raporlar, belirli bir reklam tıklamasını veya görüntülemeyi (reklam tarafında) dönüşüm tarafındaki verilerle ilişkilendirir. Dönüşüm tarafı verileri çok sınırlıdır ve verilere gürültü uygulanır (yani, durumların küçük bir yüzdesi için gerçek raporlar yerine rastgele veriler gönderilir). Bu, kullanıcı kimliğinin siteler arasında birleştirilmesini önleyerek kullanıcı gizliliğini korur. Ek gizlilik koruması olarak raporlar gecikmeli olarak gönderilir.
- Özet raporlar, reklam tarafındaki belirli bir etkinliğe bağlı değildir. Bu raporlar, etkinlik düzeyindeki raporlara kıyasla daha zengin ve yüksek doğruluk oranına sahip dönüşüm verileri sağlar. Gizlilik tekniklerinin birlikte kullanılması, siteler arasında kimliğin birleşmesi riskini azaltmaya yardımcı olur.
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.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=5&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. "Yatırım getirimi nasıl artırabilirim?" gibi soruları yanıtlayın. Reklam tarafı benzersiz kimlikleri raporlarda kullanılabileceğinden bu raporlar özellikle 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 bilginin gerekli olduğu genel raporlama. Mevcut sınır, tıklamalar için 3 bitlik dönüşüm verisidir.⏤Bu, bir dönüşüme sekiz kategoriden biri ve görüntülemeler için 1 bit atanabileceği anlamına gelir. Belirli bir fiyat veya dönüşüm zamanı gibi ayrıntılı dönüşüm tarafı verilerinin kodlanması, etkinlik düzeyindeki raporlarda desteklenmez.
- Sahtekarlık tespiti. Spam içerikli veya geçersiz etkinlikleri tanımlamak için kullanılabilecek kalıpları anlamanıza olanak tanıyan bazı raporlardaki veriler, reklam sahtekarlığı tespiti ve analizi için yararlı olabilir.
Özet raporlar
Özet raporlar (önceki adıyla toplu raporlar), daha ayrıntılı dönüşüm verileri ve tıklama veya görüntüleme verileri ile dönüşüm verilerini birleştirmek için daha fazla esneklik sunar.
Özet raporlar hakkında daha fazla bilgi edinin.
![Özet raporlardan elde edilen analizleri gösteren örnek.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=5&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, "Yatırım getirim ne?" gibi soruların yanıtlanmasına yardımcı olur.
Özet raporların optimizasyon için (örneğin, etkinlik düzeyindeki raporlar tarafından desteklenmeyen bir satın alma değerine göre optimizasyon yapmak amacıyla) kullanımı (dönüşüm verileri çok genel olduğu için) etkin bir araştırma alanıdır.
Diğer özellikler
Bu API'nin diğer özellikleri şunlardır:
- Uygulamadan web'e ilişkilendirme: Bir uygulamada bir reklamı görün veya tıklayın ve web'de dönüşüm gerçekleştirin.
Tarayıcı desteği
- Firefox ve Edge'in sinyalleri ortak değildir.
- Safari ve Webkit olumsuzdur ve reklam dönüşümlerini ölçmek için Özel Tıklama Ölçümü adlı farklı bir API önermiştir.
İki API farklı olsa da Chrome ve WebKit, geliştirici deneyimini basitleştirmek için açık alanda birlikte çalışmaktadır. Örneğin, özellik adları ve raporlar için JSON yapısı uyumlu hale getirilebilir.
Attribution Reporting API'nin özellik grubu, Safari ve WebKit tarafından önerilen Private Click Measurement API'ninkinden farklıdır. 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 adına rapor alabilir.
Tarayıcı yapılandırması
- Kullanıcılar,
chrome://settings/adPrivacy
adresindeki kullanıcı ayarlarını kullanarak API'nin kapsamı dışında kalmayı seçebilir. - 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?
API belirli bir tarayıcıda kullanılabiliyorsa herhangi bir sitede (hem üst düzey belgelerde ve komut dosyalarında hem de aynı kaynaklı iframe'lerde) varsayılan olarak kullanılabilir.
Rastgele üçüncü taraflar (örneğin, üst düzey erişimi olan bir komut dosyasıyla sayfaya eklenmemiş olan kaynaklar arası reklam iframe'leri) API'yi yayıncının veya reklamverenin bilgisi olmadan kullanamaz. Bu iframe'lerde Attribution Reporting API'nin İzinler Politikası ile açık bir şekilde etkinleştirilmesi gerekir.
<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 İzinler Politikası ile de etkinleştirebilir.
Bir site, HTTP yanıt başlığını göndererek üst düzey erişimi olan komut dosyaları da dahil olmak üzere tüm taraflar için Attribution Reporting API'yi devre dışı bırakabilir:
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: yayıncının web sitesinde gerçekleşen bir etkinlik (ör. kullanıcının bir reklamı görüntülemesi veya tıklaması) ve daha sonra reklamverenin sitesinde gerçekleşen bir 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?authuser=5&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 gürültüyle gönderir.
Özet raporlar
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=5&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ının boyutları bir reklam teknolojisi şirketi tarafından önceden tanımlanır ve tarayıcı, reklam teknolojisi tarafından tanımlanan belirli bir mantığı izler. Tarayıcı, bu verileri birleştirilebilir 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.
- Daha sonra özet raporlar 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 bir kullanıcının sitelerdeki etkinliğini izlemeden dönüşümlerle ilgili bilgi edinmesini sağlar.
Bora adlı kişiyi ele alalım. Bora, news.example
sitesinde haberleri okurken
bir reklam görür. Bir hafta sonra Bora shoes.example
sitesinden ayakkabı satın alır.
Şu anda bu dönüşüm, siteler arası tanımlayıcı olarak kullanılan bir üçüncü taraf çerezleriyle izlenir.
Bir reklam teknolojisi şirketi, üçüncü taraf çerezlerini kullanarak Bora'nın news.example
ve shoes.example
üzerindeki etkinliğiyle ilgili birçok ayrıntıya erişebilir. Reklam teknolojisi, bu bilgileri birleştirerek İbrahim'in ayrıntılı bir profilini oluşturabilir. Bu profilde Bora'nın konumu, gezinme alışkanlıkları ve news.example
sitesindeki tercih ettiği okumalar yer alır. Bu profil, shoes.example
ile ilgili satın alma işlemlerini, etkinlikleri ve kredi kartı bilgilerini de içerebilir. Bu siteler arası bağlantı, reklam dönüşümlerini ölçmek için yararlıdır. Ancak kullanıcı gizliliğini zorlaştırıyor:
Bob'ın etkinliği, siteler arasında yüksek seviyede ayrıntıyla izlenir.
![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.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=5&hl=tr)
Siteler arasında az miktarda bilgi birleştirilir. Bu, dönüşümleri ölçmek için yeterlidir, ancak Barış'ın sitelerdeki etkinliğini ayrıntılı olarak izlemek için yeterli değildir. Bora'nın news.example
ve shoes.example
üzerindeki etkinliği ayrı tutulur.
Her rapor türündeki korumalar
Etkinlik düzeyindeki raporlar, bir reklam tarafı tanımlayıcısını az miktarda dönüşüm tarafı verisine bağlar. Bunlar bir dönüşümle ilgili siteler arası bilgiler sağlasa da dönüşüm tarafı bilgileri, siteler arasında kullanıcı kimliğine eklenemeyecek kadar geneldir.
Özet raporlar, yalnızca toplu düzeyde ayrıntılı analizler sağlar. Bu toplanabilir raporların içerikleri reklam teknolojisine gönderildiğinde şifrelendiğinden, reklam teknolojisi, toplama hizmeti kullanmadan raporlardan bilgi alamaz. Toplama hizmeti yalnızca gürültülü toplamalara erişim sağlar.
Hız sınırlamaları gibi ek gizlilik korumaları hem etkinlik düzeyinde hem de toplu raporlara uygulanır.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=5&hl=tr)
Ayrıntılı bilgi: Etkinlik düzeyinde raporlar ve gizlilik
Etkinlik düzeyindeki raporlar, aşağıdaki gizlilik mekanizmalarını izleyerek kullanıcıları sitelerde takip etmeden dönüşüm analizleri sağlar:
- Siteler arası tanımlayıcı kullanılmaz ve ayrıntılı siteler arası tarama etkinliği cihazdan dışarı çıkmaz.
- Etkinlik düzeyindeki raporlar, reklam tarafındaki (
news.example
) 64 bit'i dönüşüm tarafındaki (shop.example
) yalnızca 1 bit veya 3 bit ile ilişkilendirir. 64 bit, tek bir kullanıcı tanımlayıcısıyla eşlenmek için yeterlidir. Ancak bu 64 bit, siteler arası çok küçük bilgilerle (1 bit veya 3 bit) bağlanabilir: Bu, tanımlayıcı için yeterli değildir.- Reklam tarafı 64 bit yeni bir bilgi değildir. Günümüzde reklam tarafında User-ID'ye zaten
sahip olabilirsiniz.
news.example
veyaadtech.example
, belirli bir kullanıcınınnews.example
ürünündeki etkinliğinden zaten haberdar.
- Reklam tarafı 64 bit yeni bir bilgi değildir. Günümüzde reklam tarafında User-ID'ye zaten
sahip olabilirsiniz.
- 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, hazırlanan özet rapora birden çok katkı sağlayabilir. Herhangi bir kullanıcı, belirli bir tıklama (veya görüntüleme) ve dönüşüm için birden fazla ilişkilendirmeyi tetikleyebilir.
- Veriler, birçok etkinliğin (birçok kullanıcı) düzeyine kadar toplanır ve hiçbir etkinlik tam olarak gözlemlenemez. Birleştirilmiş verilere baktığınızda, ayrıntı düzeyi arttıkça bu veriler üzerindeki bağıl gürültü de artar. Çok sayıda etkinliği ve kullanıcıyı toplayan veri dilimleri, kullanışlılığı korumak adına daha doğru sonuçlar verir.
- 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.
- Farklı veri dilimlerindeki sorgular hızla sınırlıdır.
Etkileşimde bulunun ve geri bildirim paylaşın
- API ile ilgili sorular için API deposunda bir sorun oluşturun.
- İlişkilendirme Raporu posta listesinde API güncellemelerini ve duyurularını takip edin.
- Teknik sorularınız varsa Chromium hatası bildirin.
- Uygulama, entegrasyon ve genel en iyi uygulama soruları için Özel Korumalı Alan geliştirici destek deposunda bir sorun oluşturun.