İlişkilendirme Raporlarında hata ayıklamayla ilgili bölüm 1/3. Hata ayıklamanın neden önemli olduğunu ve testlerde hata ayıklama raporlarının ne zaman kullanılacağını öğrenin.
Hata ayıklama raporlarına neden ihtiyacınız var?
Attribution Reporting API'yi test ediyorsanız entegrasyonunuzun düzgün çalışıp çalışmadığını kontrol etmeniz, çerez tabanlı uygulamanız ile Attribution Reporting uygulamanız arasındaki ölçüm sonuçlarındaki boşlukları anlamanız ve entegrasyonunuzla ilgili sorunları gidermeniz gerekir.
Bu görevleri tamamlamak için hata ayıklama raporları gerekir. Bu nedenle, bunları ayarlamanızı önemle tavsiye ederiz.
Sözlük
Hata ayıklama raporlarının temel özellikleri
İki tür hata ayıklama raporu
İki tür hata ayıklama raporu kullanılabilir. Farklı kullanım alanlarına uygun oldukları için ikisini de kullanın.
Başarı hata ayıklama raporları
Başarı hata ayıklama raporları, başarılı bir ilişkilendirme raporu oluşturulmasını izler. Bunlar, doğrudan bir ilişkilendirme raporuyla ilişkilidir.
Başarı hata ayıklama raporları, Chrome 101 sürümünden (Nisan 2022) beri kullanılmaktadır.
Ayrıntılı hata ayıklama raporları
Ayrıntılı hata ayıklama raporları, kaynak ve tetikleyici etkinlikleri hakkında daha fazla görünürlük sağlar. Böylece kaynakların başarılı bir şekilde kaydedildiğinden emin olabilir veya eksik raporları izleyip neden eksik olduklarını belirleyebilirsiniz (kaynak veya tetikleyici etkinliklerde hata, rapor gönderilirken veya oluşturulurken hata meydana gelebilir). Ayrıntılı hata ayıklama raporları şunları gösterir:
- Tarayıcının bir kaynağı başarıyla kaydettiği durumlar.
- Tarayıcının bir kaynağı veya tetikleyici etkinliği başarıyla kaydetmediği, yani ilişkilendirme raporu oluşturmadığı durumlar.
- İlişkilendirme raporunun herhangi bir nedenle oluşturulamadığı veya gönderilemediği durumlar.
Ayrıntılı hata ayıklama raporlarında, başarılı bir kaynak kaydının veya bir kaynağın, tetikleyicinin ya da ilişkilendirme raporunun oluşturulmama nedenini açıklayan bir type alanı bulunur.
Ayrıntılı hata ayıklama raporları, Chrome 109'dan (Ocak 2023) itibaren kullanılabilir. Ancak Chrome 112'de daha sonra eklenen kaynak kaydı başarı ayrıntılı hata ayıklama raporları buna dahil değildir.
2. Bölüm: Hata ayıklama raporları ayarlama bölümündeki örnek raporları inceleyin.
Hata ayıklama raporları çerez tabanlıdır
Hata ayıklama raporlarını kullanmak için raporlama kaynağının çerez ayarlaması gerekir.
Rapor almak üzere yapılandırılan kaynak bir üçüncü tarafsa bu çerez bir üçüncü taraf çerezi olur. Bunun birkaç önemli etkisi vardır:
- Hata ayıklama raporları yalnızca kullanıcının tarayıcısında üçüncü taraf çerezlerine izin veriliyorsa oluşturulur.
- Hata ayıklama raporları, üçüncü taraf çerezleri kullanımdan kaldırıldıktan sonra artık kullanılamayacaktır.
Hata ayıklama raporları hemen gönderilir
Hata ayıklama raporları, tarayıcı tarafından hemen raporlama kaynağına gönderilir. Bu, gecikmeyle gönderilen ilişkilendirme raporlarından farklıdır.
Başarı hata ayıklama raporları, ilgili ilişkilendirme raporu oluşturulduğunda, yani tetikleyici kaydında oluşturulur ve gönderilir.
Ayrıntılı hata ayıklama raporları, kaynak veya tetikleyici kaydının hemen ardından gönderilir.
Hata ayıklama raporlarının uç nokta yolları farklı
İlişkilendirme raporlarında olduğu gibi, tüm hata ayıklama raporları da raporlama kaynağına gönderilir. Hata ayıklama raporları, raporlama kaynağının üç ayrı uç noktasına gönderilir:
- Başarı hata ayıklama raporları için uç nokta, etkinlik düzeyinde
- Başarı hata ayıklama raporları için uç nokta, toplanabilir
- Etkinlik düzeyinde ve toplanabilir olan ayrıntılı hata ayıklama raporları için uç nokta.
2. Bölüm: Hata ayıklama raporlarını ayarlama bölümünden daha fazla bilgi edinebilirsiniz.
Kullanım alanları
Temel gerçek zamanlı entegrasyon kontrolü
Hata ayıklama raporları, kullanıcı gizliliğini korumak için geciktirilen ilişkilendirme raporlarının aksine hemen uç noktanıza gönderilir. Attribution Reporting API ile entegrasyonunuzun çalıştığını gerçek zamanlı bir sinyal olarak göstermek için hata ayıklama raporlarını kullanın.
Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama çözüm kitabında öğrenebilirsiniz.
Kayıp analizi
Üçüncü taraf çerezlerinin aksine Attribution Reporting API, fayda ve gizlilik arasında bir denge sağlamak için tasarlanmış yerleşik gizlilik korumaları içerir. Bu, Attribution Reporting API'yi kullanarak şu anda çerezlerle topladığınız tüm ölçüm verilerini toplayamayacağınız anlamına gelir. Üçüncü taraf çerezleriyle izleyebileceğiniz tüm dönüşümler ilişkilendirme raporu oluşturmaz.
Örnek: Etkinlik düzeyindeki raporlarda, gösterim başına en fazla bir dönüşüm kaydedebilirsiniz. Bu, kullanıcının kaç kez dönüşüm sağladığından bağımsız olarak belirli bir reklam gösterimi için yalnızca bir ilişkilendirme raporu alacağınız anlamına gelir.
Çerez tabanlı ölçüm sonuçlarınız ile Attribution Reporting API'den aldığınız sonuçlar arasındaki farkları görmek için hata ayıklama raporlarını kullanın. Hangi dönüşümlerin raporlandığını, kaç dönüşümün raporlanmadığını ve özellikle hangilerinin neden raporlanmadığını tespit edin.
3. Bölüm: Hata ayıklamayla ilgili çözüm kitabında kayıp analizi çalıştırma hakkında bilgi edinin.
Sorun giderme
Gizlilik veya kaynak korumalarından kaynaklanan kayıp beklenir ancak diğer kayıplar istenmeyen düzeyde olabilir. Uygulamanızdaki yanlış yapılandırmalar veya tarayıcının kendisindeki hatalar, raporların kaybolmasına neden olabilir.
Kendi tarafınızdaki bir uygulama sorununu tespit edip düzeltmek veya olası bir hatayı tarayıcı ekiplerine bildirmek için hata ayıklama raporlarını kullanabilirsiniz. Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama çözüm kitabında öğrenebilirsiniz.
Gelişmiş yapılandırma kontrolü
Attribution Reporting API'nin bazı özellikleri, API'nin davranışını özelleştirmenize olanak tanır. Filtreleme kuralları, tekilleştirme kuralları ve öncelik kuralları örnek olarak verilebilir.
Bu özellikleri kullanırken, ilişkilendirme raporlarını beklemeden mantığınızın üretimde istenen davranışa yol açıp açmadığını kontrol etmek için hata ayıklama raporlarını kullanın. Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama çözüm kitabında öğrenebilirsiniz.
Birleştirilebilir raporlarla yerel testler
Şifrelenmiş toplanabilir ilişkilendirme raporlarının aksine, toplanabilir hata ayıklama raporları şifrelenmemiş yükü içerir.
Birleştirilebilir raporların içeriğini doğrulamak ve test amacıyla yerel toplama aracıyla özet raporlar oluşturmak için birleştirilebilir hata ayıklama raporlarını kullanın.
Toplama Hizmeti raporlarını yeniden işleme
Hata ayıklama modunu kullanmanın bir başka avantajı da raporları tekrar işlemenize olanak tanımasıdır. Bu nedenle, raporları birden fazla kez işlemek için hata ayıklama raporlarını etkinleştirdiğinizden emin olun. Aşağıdaki durumlarda raporları yeniden işlemek isteyebilirsiniz:
- toplama Hizmeti'nde hata ayıklama işlemi gerçekleştirilir.
- farklı toplu işleme stratejileriyle denemeler yapabilirsiniz.
- ve farklı epsilon değerleriyle denemeler yapabilirsiniz.
Veri kurtarma
Reklam teknisyenlerinin, raporlama verilerini kurtarabilmek amacıyla hata ayıklama raporları almak için hata ayıklama modunu etkinleştirmesini öneririz. Bu, özet rapor oluşturma işleminin başarısız olmasına neden olabilecek, kullanılamayan veya yanıt vermeyen hizmetler gibi Toplama Hizmeti sorunları olduğunda yararlıdır.