Bir reklam tıklamasının veya görüntülemenin ne zaman dönüşümle (ör. bir reklamveren sitesinde satın alma işlemi) sonuçlandığını ölçün.
Bu kimin için?
Burada, İlişkilendirme Raporlaması'nın temellerini ve bazı temel kavramları bulabilirsiniz, ancak fazla teknik ayrıntıya gerek yoktur.
- Reklamcılık veya reklam teknolojisinde çalışıyorsanız bu API'nin üçüncü taraf çerezleriyle etkinleştirilen özellikleri nasıl sunduğu hakkında bilgi edineceksiniz. Raporların nasıl oluşturulduğu hakkında 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ış sayfasına gidin veya API ile deneme yapın ve katılın.
Dönüşüm ölçümü için reklam teknolojisi platformlarını kullanan reklamverenlerin ve yayıncıların doğrudan API kullanmalarına gerek yoktur. Reklam teknolojiniz bu API ile entegre olmayı planlıyorsa İlişkilendirme Raporları'nın işleyiş şeklini anlamak isteyebilirsiniz.
Attribution Reporting API nedir?
Günümüzde reklam dönüşümü ölçümü genellikle üçüncü taraf çerezlerine dayanmaktadır. Tarayıcılar, üçüncü taraf çerezlerine erişimi kısıtlar. 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 koruyan 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ıklamaları ve görüntülemeleri.
- Bir üçüncü taraf iframe'deki reklamlar (ör. üçüncü taraf reklam teknolojisi sağlayıcı kullanan bir yayıncı sitesindeki reklamlar).
- Bir sosyal ağdaki, arama motoru sonuç sayfasındaki reklamlar veya kendi reklamlarını sunan bir yayıncı gibi birinci taraf bağlamındaki reklamlar.
Bu terimlerden veya kavramlardan bazılarına aşina değilseniz Ö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 bildiren bir bayrak ayarlayın.
API ile denemeler yapmak istiyorsanız İlişkilendirme Raporlama: deneme ve katılma bölümüne gidin.
API değişiklikleri
- API değişikliklerini takip edin.
- 2023'ün ilk yarısında neden Attribution Reporting API'yi kullanıma sunduğumuzu öğrenin.
Kullanıma sunulma
|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ğrulama aracılığıyla geçersiz toplanabilir raporları önleme
Açıklayıcı
|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
|2. Aşama: Tam Esnek Etkinlik Düzeyi
Esnek etkinlik düzeyinde yapılandırma açıklayıcısı
|2024'ün 1. çeyreğinde Chrome'da kullanıma sunulması bekleniyor
|Üçü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, bir reklamverene veya üçüncü taraf reklam teknolojisi sağlayıcısına gönderilebilecek iki rapor türüyle 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ındaki veriler çok sınırlıdır ve verilere gürültü uygulanır. Diğer bir deyişle, vakaların küçük bir yüzdesinde 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 gönderilir.
- Özet raporlar reklam tarafındaki belirli bir etkinliğe bağlı değildir. Bu raporlar, etkinlik düzeyindeki raporlara göre daha zengin ve doğruluğu daha yüksek dönüşüm verileri sağlar. Gizlilik tekniklerini birlikte kullanmak, siteler arasında kimlik birleştirme riskinin azaltılmasına 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üzeyindeki raporlar aşağıdakiler için uygundur:
- Optimizasyon. "Yatırım getirimi nasıl artırabilirim?" gibi soruları cevaplayabilirsiniz. Özellikle, raporlarda reklam tarafı benzersiz kimlikleri sağlanabildiğinden, bu raporlar 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 bit dönüşüm verisidir ⏤Bu, bir dönüşümün sekiz kategoriden⏤ biri ve görüntülemeler için 1 bit olarak 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 algılama. Bazı raporlardaki veriler, spam veya geçersiz etkinlikleri belirlemek için kullanılabilecek kalıpları anlamanıza olanak tanıyarak reklam sahtekarlığı tespiti ve analizi için yararlı olabilir.
Özet raporlar
Özet raporlar (önceki adıyla birleştirilmiş raporlar), tıklama veya görüntüleme verileri ile dönüşüm verilerini birleştirmek için daha ayrıntılı dönüşüm verileri ve daha fazla esneklik sunar.
Özet raporları hakkında daha fazla bilgi edinin.
Özet raporlar, raporlama kullanım alanları için idealdir. Bu raporlar, "Yatırım getirim nedir?"
Özet raporların optimizasyon için kullanımı (örneğin, etkinlik düzeyindeki raporlar tarafından desteklenmeyen (dönüşüm verileri çok genel olduğu için) 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:
- Uygulamadan web'e ilişkilendirme: Uygulamadaki bir reklamı görün veya tıklayın ve web'de dönüşüm gerçekleştirin.
- Cihazlar arası ilişkilendirme: Mobil cihazlarda bir reklamı görün veya tıklayın ve masaüstünde dönüşüm gerçekleştirin.
Tarayıcı desteği
- Firefox ve Edge sinyalleri paylaşmamıştır.
- Safari ve Webkit negatiftir ve reklam dönüşümlerini ölçmek için Özel Tıklama Ölçümü adı verilen farklı bir API önermiştir.
İki API farklı olsa da Chrome ve WebKit, geliştirici deneyimini basitleştirmek için açık bir şekilde birlikte çalışmaktadır. Örneğin, özellik adları ve raporlar için JSON yapısı uyumlu hale getirilmiştir.
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ünüm tarafı hem de dönüşüm tarafıyla ilgili 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/adPrivacyadresindeki kullanıcı ayarlarıyla API'yi devre dışı bırakabilir.
- API, Gizli modda etkin değildir.
- Üçüncü taraf çerezleri devre dışı bırakıldığında API etkin olmaz.
Siteler erişimi nasıl kontrol edebilir?
API belirli bir tarayıcıda kullanılabiliyorsa API, varsayılan olarak belirli bir sitede, hem üst düzey belgelerde hem de komut dosyalarında ve aynı kaynak iframe'lerde kullanılabilir.
İsteğe bağlı üçüncü taraflar (örneğin, üst düzey erişime sahip bir komut dosyasıyla sayfaya eklenmemiş kaynaklar arası reklam iframe'leri) API'yi yayıncının veya reklamverenin bilgisi olmadan kullanamaz: Bu iframe'lerde Attribution Reporting API'nin İzin politikasıyla açık bir şekilde etkinleştirilmesi gerekir.
<iframe src="..." allow="attribution-reporting"></iframe>
Bir sayfaya çapraz kaynak iframe'ler ekleyen üst düzey erişime sahip üçüncü taraflar, Attribution Reporting API'yi İzin politikası ile de etkinleştirebilir.
Bir site, HTTP yanıt başlığını göndererek Attribution Reporting API'yi üst düzey erişime sahip komut dosyaları da dahil tüm taraflar için 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çülmesini sağlar: Yayıncının web sitesinde gerçekleşen bir etkinlik (ör. bir kullanıcının reklamı görüntülemesi veya tıklaması) ve bunu izleyen bir reklamveren sitesinde gerçekleşen dönüşüm.
Etkinlik düzeyindeki raporlar
Özet raporlar
Özet raporlar aşağıdaki gibi 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 kaynağı etkinliği olarak bilinir) ayrıntılı dönüşüm verileriyle (ilişkilendirme tetikleyici verileri olarak bilinir) eşleştirir. Yakalanan ayrıntıları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 toplanabilir bir raporda üretir.
- Toplanabilir raporlar tarayıcı tarafından şifrelenir ve bir reklam teknolojisi sunucusuna gönderilir. Birleştirilebilir raporlar, özet rapor oluşturmak için reklam teknolojisi sunucusundan toplama hizmetine gönderilir.
- Özet raporlar, daha sonra reklam teknolojisinin kullanımına sunulur. Özet raporların etkinlik düzeyindeki raporlarla aynı ölçüde gecikmediğini unutmayın.
Özet raporları hakkında daha fazla bilgi edinin.
Gizlilik
Üçüncü taraf çerezlerinin aksine Attribution Reporting API, reklamcılık şirketlerinin kişilerin sitelerdeki etkinliğini izlemeden dönüşümler hakkında bilgi edinmesine olanak tanır.
Bob adlı bir kişiyi ele alalım. Bob,
news.example sitesinde haberleri okurken
bir reklam görüyor. Bora, bir hafta sonra
shoes.example sitesinden ayakkabı satın alır.
Günümüzde bu dönüşüm, siteler arası tanımlayıcı olarak kullanılan üçüncü taraf çerezi tarafından izlenir.
Bir reklam teknolojisi şirketi, üçüncü taraf çerezlerini kullanarak Bülent'in
news.example ve
shoes.example üzerindeki etkinliğiyle ilgili birçok ayrıntıya erişebilir. Reklam teknolojisi bu bilgileri bir araya getirerek Bora'nın konumu, göz atma alışkanlıkları ve
news.example sitesindeki okumalar gibi ayrıntılı bir profil oluşturabilir. Bu profil,
shoes.example üzerindeki satın alma işlemlerini, etkinlikleri ve kredi kartı bilgilerini de içerebilir. Bu siteler arası birleştirme, reklam dönüşümlerini ölçmek için yararlıdır. Ancak bu durum kullanıcı gizliliğini olumsuz etkiler:
Barış'ın etkinlikleri sitelerde yüksek düzeyde ayrıntıyla izleniyor.
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. Bob'un
news.example ve
shoes.example üzerindeki etkinliği ayrı
kalıyor.
Her bir rapor türünde korumalar
Etkinlik düzeyindeki raporlar, reklam tarafı tanımlayıcısını az miktarda dönüşüm tarafı verileriyle bağlar. Bir dönüşüm hakkında siteler arası bilgiler sağlasa da, dönüşüm tarafı bilgileri siteler arasında kullanıcı kimliğini birleştirmek için çok yüzeyseldir.
Özet raporları yalnızca toplu düzeyde ayrıntılı analizler sunar. Bu birleştirilmiş raporların içerikleri reklam teknolojisine gönderildiğinde şifrelendiğinden, reklam teknolojisi, toplama hizmeti kullanmadan raporlardan herhangi bir bilgi alamaz. Toplama hizmeti yalnızca gürültülü toplama işlemlerine erişim sağlar.
Hız sınırlamaları gibi ek gizlilik korumaları hem etkinlik düzeyinde hem de toplu raporlara uygulanır.
Ayrıntılı olarak: Etkinlik düzeyinde raporlar ve gizlilik
Etkinlik düzeyindeki raporlar, aşağıdaki gizlilik mekanizmalarını uygulayarak kullanıcıları siteler arasında izlemeden dönüşüm analizleri sunar:
- Siteler arası tanımlayıcı kullanılmaz ve ayrıntılı siteler arası tarama etkinliği cihazdan ayrılmaz.
- Etkinlik düzeyindeki raporlar, reklam tarafındaki (
news.example) 64 bit bilgiyi, dönüşüm tarafındaki yalnızca 1 veya 3 bitle (
shop.example) ilişkilendirir. 64 bit, tek bir kullanıcı tanımlayıcısıyla eşlenmesi için yeterli bilgidir ancak bu 64 bit yalnızca siteler arası çok az bilgiyle bağlanabilir: 1 veya 3 bit; bunlar tanımlayıcı tutmak için yeterli değildir.
- Reklam tarafı 64 bit yeni bilgiler değildir. User-ID hâlihazırda reklam tarafında
kullanılabilir.
news.exampleveya
adtech.example,
news.exampleürünündeki belirli bir kullanıcının etkinliğini zaten biliyor.
- Reklam tarafı 64 bit yeni bilgiler değildir. User-ID hâlihazırda reklam tarafında kullanılabilir.
- 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 verilerine gürültü çıkar: Zamanın belirli bir yüzdesinde sahte raporlar üretilir.
- Tıklama veya görüntüleme başına ilişkilendirilen dönüşüm raporlarının sayısı 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 arasında izlenmeden dönüşüm analizleri sunarlar:
- Siteler arası tanımlayıcı kullanılmaz.
- Her atıf, oluşturulan özet rapora birden fazla katkı yapabilir. Herhangi bir kullanıcı belirli bir tıklama (veya görüntüleme) ve dönüşüm için birden çok ilişkilendirmeyi tetikleyebilir.
- Veriler birçok etkinlik (birçok kullanıcı) düzeyine kadar toplanır ve tek tek etkinlikler kesin olarak gözlemlenemez. Birleştirilmiş verilere bakarken ayrıntı düzeyi arttıkça söz konusu verilerdeki göreli gürültü de artar. Çok sayıda etkinliği ve kullanıcıları bir araya getiren veri dilimleri, kullanışlılığı korumak için 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.
- Verilerin farklı dilimlerindeki sorgular hız sınırlamasına tabidir.
Etkileşimde bulunun ve geri bildirim paylaşın
- API ile ilgili sorularınız için: API deposunda sorun oluşturun.
- Attribution Reporting posta listesinden API güncellemelerini ve duyurularını takip edin.
- Teknik sorularınız varsa Chromium hatası bildiriminde bulunun.
- Uygulama, entegrasyon ve genel en iyi uygulama soruları için Özel Korumalı Alan geliştirici destek deposunda sorun oluşturma bölümüne bakın.