İlişkilendirme raporlarında hata ayıklamayla ilgili 3 bölümden 1. bölüm. Hata ayıklamanın neden önemli olduğunu ve test sırasında 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, bu ayarları yapmanızı önemle tavsiye ederiz.
Sözlük
Hata ayıklama raporlarının önemli özellikleri
İki tür hata ayıklama raporu
İki tür hata ayıklama raporu vardır. Farklı kullanım alanlarına sahip oldukları için ikisini de kullanın.
Başarılı hata ayıklama raporları
Başarılı hata ayıklama raporları, ilişkilendirme raporunun başarılı bir şekilde oluşturulmasını izler. Doğrudan bir ilişkilendirme raporuyla ilgilidir.
Başarılı hata ayıklama raporları, Chrome 101'den (Nisan 2022) beri kullanılabilir.
Ayrıntılı hata ayıklama raporları
Ayrıntılı hata ayıklama raporları, kaynak ve tetikleyici etkinliklerle ilgili daha fazla görünürlük sağlar. Böylece, kaynakların başarıyla kaydedildiğinden emin olabilir veya eksik raporları takip edip neden eksik olduklarını belirleyebilirsiniz (kaynak veya tetikleyici etkinliklerde hata, raporu gönderirken veya oluştururken hata). 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 kaydettirmediği durumlar. Bu durumda ilişkilendirme raporu oluşturulmaz.
- Bir ilişkilendirme raporunun bir nedenden dolayı oluşturulamaması veya gönderilememesi durumları.
Ayrıntılı hata ayıklama raporları, başarılı bir kaynak kaydını veya bir kaynak, tetikleyici ya da ilişkilendirme raporunun oluşturulma nedenini açıklayan bir type alanı içerir.
Ayrıntılı hata ayıklama raporları, Chrome 109'dan (Ocak 2023) beri kullanılabilir. Chrome 112'de daha sonra eklenen kaynak kaydı başarısı ayrıntılı hata ayıklama raporları bu kapsamda değildir.
2. Bölüm: Hata ayıklama raporları oluşturma bölümündeki örnek raporları inceleyin.
Hata ayıklama raporları çerez tabanlı
Hata ayıklama raporlarını kullanmak için raporlama kaynağının bir çerez ayarlaması gerekir.
Rapor almak için yapılandırılmış kaynak bir üçüncü tarafsa bu çerez üçüncü taraf çerezi olur. Bu, hata ayıklama raporlarının yalnızca kullanıcı tarayıcısında üçüncü taraf çerezlerine izin veriliyorsa oluşturulacağı anlamına gelir.
Hata ayıklama raporları hemen gönderilir
Hata ayıklama raporları, tarayıcı tarafından raporlama kaynağına hemen gönderilir. Bu, gecikmeli olarak gönderilen ilişkilendirme raporlarından farklıdır.
Başarılı hata ayıklama raporları, ilgili ilişkilendirme raporu oluşturulur oluşturulmaz (yani tetikleyici kaydı sırasında) oluşturulur ve gönderilir.
Ayrıntılı hata ayıklama raporları, kaynak veya tetikleyici kaydı yapıldıktan hemen sonra gönderilir.
Hata ayıklama raporlarının farklı uç nokta yolları var
İlişkilendirme raporları 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
- Ayrıntılı hata ayıklama raporları için uç nokta. Etkinlik düzeyindedir ve birleştirilebilir.
Daha fazla bilgi için 2. Bölüm: Hata ayıklama raporları oluşturma başlıklı makaleyi inceleyin.
Kullanım alanları
Temel gerçek zamanlı entegrasyon kontrolü
Hata ayıklama raporları, kullanıcı gizliliğini korumak için gecikmeli olarak gönderilen ilişkilendirme raporlarının aksine uç noktanıza hemen gönderilir. İlişkilendirme Reporting API ile entegrasyonunuzun çalıştığına dair gerçek zamanlı bir sinyal olarak hata ayıklama raporlarını kullanın.
Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama yemek kitabı'nda öğrenebilirsiniz.
Kayıp analizi
Üçüncü taraf çerezlerinin aksine Attribution Reporting API, fayda ve gizlilik arasında denge sağlamak için tasarlanmış yerleşik gizlilik korumaları içerir. Bu, Attribution Reporting API ile çerezlerle toplayabileceğiniz tüm ölçüm verilerini toplayamayabilirsiniz. Üçüncü taraf çerezleriyle izleyebileceğiniz tüm dönüşümler ilişkilendirme raporu oluşturmaz.
Bir ö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 gerçekleştirdiğine bakılmaksızın, belirli bir reklam gösterimi için yalnızca bir ilişkilendirme raporu alacaksınız demektir.
Çereze dayalı ölçüm sonuçlarınızın Attribution Reporting API ile elde ettiğiniz 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ı, hangilerinin raporlanmadığını ve nedenini belirleyin.
3. Bölüm: Hata ayıklama yemek kitabı'nda kayıp analizinin nasıl çalıştırılacağını öğrenin.
Sorun giderme
Gizlilik veya kaynak korumalarından kaynaklanan kayıplar beklenirken diğer kayıplar istenmeyen olabilir. Uygulamanızdaki yanlış yapılandırmalar veya tarayıcının kendisindeki hatalar, raporların kaybolmasına neden olabilir.
Hata ayıklama raporlarını, kendi tarafınızdaki bir uygulama sorununu tespit edip düzeltmek veya tarayıcı ekiplerine olası bir hatayı bildirmek için kullanabilirsiniz. Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama yemek kitabı'nda öğrenebilirsiniz.
Gelişmiş yapılandırma kontrolü
Attribution Reporting API'nin bazı özellikleri, API'nin davranışlarını özelleştirmenize olanak tanır. Filtreleme kuralları, tekilleştirme kuralları ve öncelik kuralları buna örnek gösterilebilir.
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 yemek kitabı'nda öğrenebilirsiniz.
Toplanabilir raporlarla yerel test
Şifrelenmiş birleştirilebilir ilişkilendirme raporlarının aksine, birleştirilebilir hata ayıklama raporları şifrelenmemiş yük verisini içerir.
Toplanabilir raporların içeriğini doğrulamak ve test için yerel toplama aracı ile özet raporlar oluşturmak üzere toplanabilir hata ayıklama raporlarını kullanın.
Aggregation Service raporlarını yeniden işleme
Hata ayıklama modunu kullanmanın bir diğer avantajı, raporları tekrar işlemenize olanak tanımasıdır. Bu nedenle, raporları birden fazla kez işlemek için hata ayıklama raporlarının etkinleştirildiğinden emin olun. Aşağıdaki durumlarda raporları yeniden işlemek isteyebilirsiniz:
- Aggregation Service'te hata ayıklama işlemine çalışıyor.
- farklı gruplandırma stratejileriyle denemeler yapın.
- farklı epsilon değerleriyle denemeler yapın.
Veri kurtarma
Reklam teknolojilerinin, hata ayıklama raporları almak için hata ayıklama modunu etkinleştirmesini ve böylece raporlama verilerini kurtarmasını öneririz. Bu seçenek, özet rapor oluşturmanın başarısız olmasına neden olabilecek kullanılamayan veya yanıt vermeyen hizmetler gibi Toplama Hizmeti sorunlarında faydalıdır.