İlişkilendirme Raporları'nda hata ayıklama ile ilgili 3 bölümden oluşan serinin 1. bölümü. Hata ayıklamanın neden önemli olduğunu ve testte hata ayıklama raporlarını ne zaman kullanacağınızı öğrenin.
Neden hata ayıklama raporlarına ihtiyacınız var?
Attribution Reporting API'yi test ediyorsanız entegrasyonunuzun düzgün çalıştığını kontrol etmeli, çerez tabanlı uygulamanız ile Attribution Reporting uygulamanız arasındaki ölçüm sonuçlarındaki boşlukları anlamalı ve entegrasyonunuzla ilgili sorunları gidermelisiniz.
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 önemli yönleri
İki tür hata ayıklama raporu
İki tür hata ayıklama raporu vardır. Farklı kullanım alanlarına hitap ettikleri için ikisini de kullanın.
Başarı hata ayıklama raporları
Başarı 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ı 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 etkinlikler hakkında 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ı (kaynak veya tetikleyici etkinliklerdeki hata, rapor gönderilirken veya oluşturulurken hata) belirleyebilirsiniz. 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 kaynak veya tetikleyici etkinliği başarıyla kaydetmediği durumlar (bu, ilişkilendirme raporu oluşturmayacağı anlamına gelir).
- Bir nedenden dolayı ilişkilendirme raporunun oluşturulamadığı veya gönderilemediği 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şturulmamasının nedenini açıklayan bir type alanı içerir.
Ayrıntılı hata ayıklama raporları, Chrome 109'dan (Ocak 2023) beri kullanılabilir. Ancak kaynak kaydı başarı ayrıntılı hata ayıklama raporları daha sonra Chrome 112'ye eklenmiştir.
Bölüm 2: Hata ayıklama raporlarını 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.
Raporları alacak şekilde yapılandırılan kaynak bir üçüncü tarafsa bu çerez, üçüncü taraf çerezi olur. Bu, hata ayıklama raporlarının yalnızca kullanıcının tarayıcısında üçüncü taraf çerezlerine izin verilirse oluşturulacağı anlamına gelir.
Hata ayıklama raporları hemen gönderilir.
Hata ayıklama raporları, tarayıcı tarafından bildirim kaynağına hemen gönderilir. Bu, gecikmeli olarak gönderilen ilişkilendirme raporlarından farklıdır.
Başarı hata ayıklama raporları, ilgili ilişkilendirme raporu oluşturulur oluşturulmaz (yani tetikleyici kaydı sırasında) oluşturulup gönderilir.
Ayrıntılı hata ayıklama raporları, kaynak veya tetikleyici kaydı yapıldıktan hemen sonra gönderilir.
Hata ayıklama raporları farklı uç nokta yollarına sahip
Tüm hata ayıklama raporları, ilişkilendirme raporları gibi raporlama kaynağına gönderilir. Hata ayıklama raporları, raporlama kaynağının üç ayrı uç noktasına gönderilir:
- Etkinlik düzeyinde başarı hata ayıklama raporları için uç nokta
- Başarılı hata ayıklama raporları için uç nokta, toplanabilir
- Ayrıntılı hata ayıklama raporları için uç nokta (etkinlik düzeyinde ve toplanabilir).
Daha fazla bilgi için 2. Bölüm: Hata ayıklama raporlarını ayarlama başlıklı makaleyi inceleyin.
Kullanım alanları
Temel anlık entegrasyon kontrolü
Hata ayıklama raporları, kullanıcı gizliliğini korumak için geciktirilen ilişkilendirme raporlarının aksine uç noktanıza hemen gönderilir. Hata ayıklama raporlarını, Attribution Reporting API ile entegrasyonunuzun çalıştığını gösteren gerçek zamanlı bir sinyal olarak kullanın.
Bunu nasıl yapacağınızı 3. Bölüm: Hata ayıklama kılavuzu'ndan öğrenebilirsiniz.
Kayıp analizi
Üçüncü taraf çerezlerinin aksine, Attribution Reporting API, fayda ve gizlilik arasında denge kurmak için tasarlanmış yerleşik gizlilik korumaları içerir. Bu nedenle, 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.
Örneğin, etkinlik düzeyindeki raporlar için gösterim başına en fazla bir dönüşüm kaydedebilirsiniz. Bu, belirli bir reklam gösterimi için kullanıcı kaç kez dönüşüm gerçekleştirirse gerçekleştirsin yalnızca bir ilişkilendirme raporu alacağınız anlamına gelir.
Çerez tabanlı ölçüm sonuçlarınız ile 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ı ve özellikle hangilerinin neden raporlanmadığını belirleyin.
Bölüm 3: Hata ayıklama kılavuzu'nda kayıp analizini nasıl çalıştıracağınızı öğrenin.
Sorun giderme
Gizlilik veya kaynak korumaları nedeniyle oluşan kayıplar beklenir ancak diğer kayıplar istenmeden oluşabilir. Uygulamanızdaki yanlış yapılandırmalar veya tarayıcının kendisindeki hatalar, raporların eksik olması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 kılavuzu'ndan öğ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ı bu tür kurallara örnek olarak verilebilir.
Bu özellikleri kullanırken, ilişkilendirme raporlarını beklemeden mantığınızın üretimde amaçlanan davranışa yol açtığı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 kılavuzu'ndan öğrenebilirsiniz.
Toplanabilir raporlarla yerel test
Şifrelenmiş olan toplanabilir ilişkilendirme raporlarının aksine, toplanabilir hata ayıklama raporları şifrelenmemiş yükü içerir.
Toplanabilir hata ayıklama raporlarını kullanarak toplanabilir raporların içeriğini doğrulayabilir ve test için yerel toplama aracıyla özet raporlar oluşturabilirsiniz.
Toplama Hizmeti raporlarını yeniden işleme
Hata ayıklama modunu kullanmanın bir diğer avantajı da raporları tekrar işleyebilmenizi sağlaması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ıklamaya çalışıyorsanız
- Farklı toplu işleme stratejileriyle denemeler yapın.
- Farklı epsilon değerleriyle denemeler yapın.
Veri kurtarma
Reklam teknolojisi sağlayıcıların, hata ayıklama raporları alarak raporlama verilerini kurtarabilmeleri için hata ayıklama modunu etkinleştirmelerini öneririz. Bu, ö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.
Sıradaki
2. bölüm: Hata ayıklama raporları oluşturma