Bir reklam tıklamasının veya görüntülemesinin ne zaman bir dönüşüme (ör. reklamveren sitesinde gerçekleştirilen satın alma işlemi) yol açtığı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 söyleyen 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 öğrenin.
Kullanılabilirlik
Proposal | Status |
---|---|
Conversion journey: app-to-web Web explainer and Android explainer Mailing list announcement |
Available in Chrome and Android for origin trial |
Conversion journey: cross-device Explainer |
This proposal has been archived. There are no current plans for implementation. |
Preventing invalid aggregatable reports using report verification Explainer |
This proposal has been archived. We have implemented trigger_context_id for this use case instead. |
Default allowlist for the Attribution Reporting API Permissions-Policy will remain * Mailing list announcement |
Available in Chrome in Q1 2023 |
Configurable event-Level reporting epsilon GitHub issue |
Available in Chrome in Q4 2023 |
Padding for aggregatable reports payload Updated explainer |
Available in Chrome in Q4 2023 |
Flexible event-Level Flexible event-level configurations explainer |
Available in Chrome in Q4 2023
The ability to customize the number of attribution reports and the number/length of reporting windows. Available in Chrome in Q1 2024 The ability to customize the number of bits of trigger data. |
Support for Attribution Reporting verbose debugging reports not dependent on third-party cookies Explainer |
Available in Chrome in Q3 2024 |
Support for Attribution Reporting API and Aggregation Service for Google Cloud Attribution Reporting API Explainer Aggregation Service Explainer |
Available in Chrome in H2 2023 |
Flexible contribution filtering Explainer |
Available in Chrome in Q3 2024 |
Pre-attribution filtering: attribution scopes Explainer |
Available in Chrome in Q4 2024 |
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 sayede, kullanıcı kimliğinin siteler arasında birleştirilmesini önleyerek kullanıcı gizliliği korunur. 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.

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 (dönüşümlerin sekiz kategoriden birine atanabileceği anlamına gelir) 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.

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?" 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şmadı.
- Safari ve Webkit olumsuz bir yanıt verdi ve reklam dönüşümlerini ölçmek için Private Click Measurement 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ğil.
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

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

Ö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 siteler arasındaki 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.

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 sunulan 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.

Ayrıntılı bilgi: Etkinlik düzeyindeki raporlar ve gizlilik
Etkinlik düzeyindeki raporlar, aşağıdaki gizlilik mekanizmalarını uygulayarak kullanıcıları siteler arasında 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 bilgi, 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 biliyordur.
- 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ğlar:
- Siteler arası tanımlayıcı kullanılmaz.
- Her ilişkilendirme, sonuçta elde edilen özet rapora birden fazla katkıda bulunabilir. 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 etkinlik (birçok kullanıcı) düzeyinde birleştirilir ve tekil 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: Özel Korumalı Alan geliştirici destek deposunda sorun oluşturun.