Bir reklam tıklamasının veya görüntülemenin ne zaman dönüşüme (ör. reklamveren sitesinde gerçekleştirilen satın alma işlemi) yol açtığını ölçün.
Kimler içindir?
Burada, İlişkilendirme Raporlama'nın temellerini ve bazı temel kavramları bulabilirsiniz ancak teknik ayrıntılar yer almaz.
- 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 bilgi içeren API kullanım alanlarına göz atın.
- Geliştirici veya yazılım mühendisiyseniz sisteme genel bakışın tamamını inceleyin ya da API ile deneme yapın ve API'yi kullanın.
Dönüşüm ölçümü için reklam teknolojisi platformlarını kullanan reklamverenlerin ve yayıncıların API'yi doğrudan kullanması gerekmez. Reklam teknolojiniz bu API ile entegrasyon yapmayı planlıyorsa Attribution Reporting'in nasıl çalıştığını 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ıtlıyor. Bunun nedeni, bu çerezlerin kullanıcıları siteler arasında izlemek ve kullanıcı gizliliğini engellemek için kullanılabilmesidir.
Attribution Reporting API, bu ölçümleri üçüncü taraf çerezleri olmadan, gizliliği koruyarak yapmanızı 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ülemeleri.
- Üçüncü taraf iFrame'deki reklamlar (ör. üçüncü taraf reklam teknolojisi sağlayıcısı kullanan bir yayıncı sitesindeki reklamlar).
- Bir sosyal ağdaki veya arama motoru sonuç sayfasındaki 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 Ö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 işaret ayarlayın.
API ile deneme yapmak istiyorsanız Attribution Reporting: experiment and participate (Attribution Reporting: Deneme yapın ve katılın) 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 sunduğumuz hakkında bilgi edinin.
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önderilebilen 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ülemeyi (reklam tarafında) dönüşüm tarafındaki verilerle ilişkilendirir. Dönüşüm tarafı verileri çok sınırlıdır ve veriler gürültülüdür (yani, 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 ö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 daha yüksek doğrulukta dönüşüm verileri sağlar. Gizlilik tekniklerinin bir kombinasyonu, siteler arası 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ülemeyi kaba dönüşüm verileriyle ilişkilendirir.
news.example üzerindeki tıklama kimliği 200400600 (news.example üzerindeki kullanıcı kimliği Bob_Doe'ya bağlı) shop.example üzerinde bir satın alma işlemine yol açtı.Etkinlik düzeyindeki raporlar şunlar için uygundur:
- Optimizasyon "Yatırım getirisini nasıl artırabilirim?" gibi soruları yanıtlayın. Özellikle bu raporlar, reklam yerleşimini optimize etmek için kullanılabilir. Bunun nedeni, raporlarda reklam tarafındaki benzersiz kimliklerin kullanılabilmesidir. Etkinlik düzeyindeki raporlar, makine öğrenimi modelleri için eğitim verileri sağlayabilir.
- Dönüşüm hakkında çok az bilgiye ihtiyaç duyulan genel raporlama. Tıklamalar için mevcut sınır 3 bit dönüşüm verisidir. Bu, bir dönüşümün sekiz kategoriden birine atanabileceği anlamına gelir. Görüntülemeler için ise sınır 1 bittir. 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ığını tespit etme ve analiz etme konusunda faydalı olabilir.
Özet raporlar
Özet raporlar (eski 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ştirme konusunda daha fazla esneklik sunar.
Özet raporları hakkında daha fazla bilgi edinin.
news.example üzerindeki 1234567 kimlikli kampanya, shoes.example üzerinde 518 dönüşüm ve toplam 38.174 TL harcama sağladı. Dönüşümlerin yarısı ABD'nin New York şehrindeki kullanıcılardan geldi.Özet raporlar, raporlama kullanım alanları için en uygun olanlardır. Bu raporlar, "Yatırım getirim ne kadar?" gibi soruları yanıtlamanıza yardımcı olur.
Optimizasyon için özet raporların kullanımı (ör. dönüşüm verileri çok kaba olduğundan etkinlik düzeyindeki raporlar tarafından desteklenmeyen bir satın alma değeri için optimizasyon) aktif araştırma alanıdır.
Diğer özellikler
Bu API'nin diğer özellikleri şunlardır:
- Uygulamadan web'e ilişkilendirme: Uygulamada bir reklamı görme veya tıklama ve web'de dönüşüm gerçekleştirme.
Tarayıcı desteği
- Firefox ve Edge sinyal paylaşmıyor.
- Safari ve Webkit, olumsuz 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ışıyor. Örneğin, özellik adları ve raporlar için JSON yapısı konusunda uyum sağlıyorlar.
Attribution Reporting API'nin özellik seti, Safari ve WebKit tarafından önerilen Private Click Measurement API'nin özellik setinden farklıdır. En önemlisi, Attribution Reporting API ile:
- Görüntüleme dönüşümü ö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/adPrivacyadresindeki kullanıcı ayarlarını kullanarak API'yi devre dışı bırakabilir. - API, Gizli modda etkin değildir.
Siteler erişimi nasıl kontrol edebilir?
Belirli bir tarayıcıda kullanılabilen API, hem üst düzey dokümanlarda ve komut dosyalarında hem de aynı kaynaklı iFrame'lerde olmak üzere, belirli bir sitede varsayılan olarak kullanılabilir.
Rastgele üçüncü taraflar (ör. üst düzey erişimi olan bir komut dosyasıyla sayfaya eklenmemiş olan kaynaklar arası reklam iframe'leri), yayıncının veya reklamverenin bilgisi olmadan API'yi kullanamaz. Bu iframe'lerde, Attribution Reporting API'nin izin politikası ile açıkça etkinleştirilmesi gerekir.
<iframe src="..." allow="attribution-reporting"></iframe>
Üst düzey erişime sahip ve bir sayfaya kaynaklar arası iFrame'ler ekleyen üçüncü taraflar, izin politikası ile ilişkilendirme raporlama API'sini de etkinleştirebilir.
Bir site, üst düzey erişime sahip komut dosyaları da dahil olmak üzere tüm taraflar için Attribution Reporting API'yi HTTP yanıt başlığını göndererek 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 veriler 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 haline getirir.
- Toplanabilir raporlar tarayıcı tarafından şifrelenir ve bir reklam teknolojisi sunucusuna gönderilir. Bu 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ı etkinliğini izlemeden dönüşümler hakkında bilgi edinmesine olanak tanır.
Örneğin, Burak adlı bir kişiyi ele alalım. Bülent, news.example sitesinde haber okurken bir reklam görüyor. Bir hafta sonra Bora, shoes.example adresinden ayakkabı satın alıyor.
Günümüzde bu dönüşüm, siteler arası tanımlayıcı olarak kullanılan bir üçüncü taraf çereziyle izlenir.
Üçüncü taraf çerezleri sayesinde bir reklam teknolojisi şirketi, Ali'nin news.example ve shoes.example üzerindeki etkinliğiyle ilgili birçok ayrıntıya erişebilir. Reklam teknolojisi, bu bilgileri birleştirerek Bob'un konumu, göz atma alışkanlıkları ve news.example'daki tercih ettiği okumalar dahil olmak üzere Bob hakkında ayrıntılı bir profil oluşturabilir. Bu profilde shoes.example üzerindeki satın alma işlemleri, etkinlikler ve kredi kartı bilgileri de yer alabilir. Bu siteler arası ortaklık, reklam dönüşümlerini ölçmek için kullanışlıdır. Ancak bu durum, kullanıcı gizliliğini engeller:
Bob'un etkinliği, sitelerde yüksek düzeyde ayrıntıyla izlenir.
Siteler arasında az miktarda bilgi birleştirilir. Bu bilgiler, dönüşümleri ölçmek için yeterli olsa da Ali'nin siteler arası etkinliğini ayrıntılı olarak izlemek için yeterli değildir. Ali'nin news.example ve shoes.example üzerindeki etkinliği ayrı kalır.
Her rapor türündeki korumalar
Etkinlik düzeyindeki raporlar, reklam tarafı tanımlayıcıyı az miktarda dönüşüm tarafı verisiyle ilişkilendirir. Dönüşüm hakkında siteler arası bilgi sağlasalar da dönüşüm tarafındaki bilgiler, kullanıcı kimliğini siteler arasında birleştirmek için çok kaba kalır.
Özet raporlar ayrıntılı analizler sunar ancak yalnızca toplu düzeyde. Bu toplanabilir raporların içeriği, reklam teknolojisine gönderilirken şifrelendiği için reklam teknolojisi, toplama hizmeti kullanmadan raporlardan herhangi bir bilgi alamaz. Toplama hizmeti yalnızca gürültülü toplamlara erişim sağlar.
Hem etkinlik düzeyindeki hem de toplu raporlara sıklık 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 ayrıntılı siteler arası tarama etkinliği cihazdan ayrılmaz.
- Etkinlik düzeyindeki raporlar, reklam tarafındaki 64 bitlik bilgiyi (
news.example) dönüşüm tarafındaki yalnızca 1 bitlik veya 3 bitlik bilgiyle (shop.example) ilişkilendirir. 64 bit, tek bir kullanıcı tanımlayıcısıyla eşlenecek kadar bilgi içerir ancak bu 64 bit yalnızca çok az siteler arası bilgiyle (1 bit veya 3 bit) bağlanabilir. Bu da bir tanımlayıcıyı tutmak için yeterli değildir.- Reklam tarafındaki 64 bitlik kısım yeni bir bilgi değildir. Kullanıcı kimliği, reklam tarafında zaten kullanılabilir.
news.exampleveyaadtech.examplenews.exampleüzerindeki belirli bir kullanıcı etkinliği hakkında zaten bilgi sahibi.
- Reklam tarafındaki 64 bitlik kısım yeni bir bilgi değildir. Kullanıcı kimliği, reklam tarafında zaten kullanılabilir.
- Kötüye kullanımı ve siteler arası takibi önlemek için ek korumalar uygulanır:
- Raporlar gecikmeli olarak gönderilir.
- Dönüşüm verileri gürültülüdür: Sahte raporlar, belirli bir yüzdede oluşturulur.
- Atfedilen 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ı siteler arasında izlemeden dönüşüm analizleri sağlarlar:
- Siteler arası tanımlayıcı kullanılmaz.
- Her ilişkilendirme, sonuçta elde edilen özet raporuna 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 hiçbir etkinlik tam olarak gözlemlenemez. Birleştirilmiş verilere bakarken ayrıntı düzeyi arttıkça bu verilerdeki göreli gürültü de artar. Çok sayıda etkinlik ve kullanıcıyı birleştiren veri dilimleri, kullanışlı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ı takibi önlemek için ek korumalar uygulanır:
- Raporlar rastgele gecikmelerle gönderilir.
- Verilerin farklı dilimleriyle ilgili sorgulara sıklık sınırlaması uygulanır.
Etkileşim kurma ve geri bildirim paylaşma
- API ile ilgili sorularınız için API deposunda sorun oluşturun.
- Attribution Reporting posta listesindeki API güncellemelerini ve duyurularını takip edin.
- Teknik sorularınız varsa Chromium hata bildiriminde bulunun.