İlişkilendirme Raporları'nda hata ayıklamayla ilgili bölüm 1/3. Hata ayıklamanın neden önemli olduğunu ve hata ayıklama raporlarını testlerde ne zaman kullanacağınızı öğ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ı arasındaki boşlukları anlamanız ve entegrasyonunuzla ilgili sorunları gidermeniz gerekir.
Bu görevleri tamamlamak için hata ayıklama raporları gerekiyor. Bu nedenle, bu reklamları 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 vardır. İkisi de farklı kullanım alanları olduğundan her ikisini de kullanın.
Başarılı hata ayıklama raporları
Başarı hata ayıklama raporları, ilişkilendirme raporunun başarılı bir şekilde oluşturulmasını izler. Bunlar, doğrudan bir ilişkilendirme raporuyla ilişkilidir.
Başarıyla ilgili hata ayıklama raporları, Chrome 101 sürümünden (Nisan 2022) beri kullanılabiliyor.
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ı takip edip neden eksik olduklarını belirleyebilirsiniz (kaynak veya tetikleme etkinliklerinde hata, rapor gönderilirken veya oluşturulurken hata meydana gelir). Ayrıntılı hata ayıklama raporlarında şunlar gösterilir:
- Tarayıcının bir kaynağı başarıyla kaydettiği durumlar.
- Tarayıcının bir kaynağı veya etkinliği başarıyla kaydetmediği, yani ilişkilendirme raporu oluşturmadığı durumlar.
- Herhangi bir nedenle ilişkilendirme raporunun oluşturulamadığı veya gönderilemediği durumlar.
Ayrıntılı hata ayıklama raporlarında, başarılı bir kaynak kaydını veya kaynak, tetikleyici ya da ilişkilendirme raporunun oluşturulmama nedenini açıklayan bir type alanı bulunur.
Chrome 109 sürümünden (Ocak 2023) beri ayrıntılı hata ayıklama raporları kullanılmaktadır. Chrome 112 sürümünde daha sonra eklenen kaynak kaydı başarılı ayrıntılı hata ayıklama raporları hariçtir.
2. Bölüm: 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 bir çerez ayarlaması gerekir.
Rapor alacak şekilde yapılandırılan kaynak üçü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 verilirse oluşturulur.
- Hata ayıklama raporları, üçüncü taraf çerezleri kullanımdan kaldırıldıktan sonra 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ı, karşılık gelen ilişkilendirme raporu (tetikleyici kaydında) oluşturulduğunda oluşturulur ve gönderilir.
Ayrıntılı hata ayıklama raporları, kaynak veya tetikleyici kaydından hemen sonra gönderilir.
Hata ayıklama raporlarında farklı uç nokta yolları var
İ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ılı hata ayıklama raporları için uç nokta, etkinlik düzeyinde
- Başarılı hata ayıklama raporları için uç nokta (toplanabilir)
- Etkinlik düzeyinde ve toplanabilir ayrıntılı hata ayıklama raporları için uç nokta.
2. Bölüm: Hata ayıklama raporlarını ayarlama bölümünde daha fazla bilgi edinebilirsiniz.
Kullanım alanları
Temel gerçek zamanlı entegrasyon kontrolü
Kullanıcı gizliliğini korumak için geciken ilişkilendirme raporlarının aksine, hata ayıklama raporları uç noktanıza hemen gönderilir. Attribution 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: Yol tarifinde hata ayıklama bölümünden öğrenebilirsiniz.
Kayıp analizi
Üçüncü taraf çerezlerinden farklı olarak Attribution Reporting API, fayda ve gizlilik arasında denge kurmak için tasarlanmış yerleşik gizlilik korumaları içerir. Bu nedenle, şu anda çerezlerle topladığınız tüm ölçüm verilerini Attribution Reporting API ile 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. Diğer bir deyişle, kullanıcı kaç kez dönüşüm gerçekleştirdiğinden bağımsız olarak belirli bir reklam gösterimi için yalnızca bir ilişkilendirme raporu alırsınız.
Çerez tabanlı ölçüm sonuçlarınız ile Attribution Reporting API ile elde ettiğiniz sonuçlar arasındaki farklılıkları görmek için hata ayıklama raporlarını kullanın. Hangi dönüşümlerin ve kaç dönüşümün raporlanmadığını ve özellikle hangilerinin ve neden önemli olduğunu belirleyin.
Kayıp analizini nasıl çalıştıracağınızı 3. Bölüm: Hata ayıklama tarif defteri bölümünden öğrenebilirsiniz.
Sorun giderme
Gizlilik veya kaynak korumalarından kaynaklanan kayıplar beklenen bir durum olsa da başka kayıplar istenmeyen olabilir. Uygulamanızdaki yanlış yapılandırmalar veya tarayıcının kendisindeki hatalar, raporların kaybolmasına neden olabilir.
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: Yol tarifinde hata ayıklama bölümünden öğ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ı örnek olarak verilebilir.
Bu özellikleri kullanırken, ilişkilendirme raporlarını beklemeden mantığınızın üretimde istenen davranışı sağlayıp sağlamadığını kontrol etmek için hata ayıklama raporlarından yararlanın. Bunu nasıl yapacağınızı 3. Bölüm: Yol tarifinde hata ayıklama bölümünden öğrenebilirsiniz.
Birleştirilebilir raporlarla yerel test
Şifrelenmiş birleştirilebilir 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 toplanabilir hata ayıklama raporlarını kullanın.
Toplama Hizmeti raporlarını yeniden işleme
Hata ayıklama modunu kullanmanın başka bir avantajı da raporları tekrar işleyebilmenizdir. Bu nedenle, raporları birden çok kez işlemek için hata ayıklama raporlarını etkinleştirdiğinizden emin olun. Aşağıdaki durumlarda raporları yeniden işlemeyi düşünebilirsiniz:
- hatasını ayıklamaya çalışıyor.
- farklı toplu işleme stratejilerini denemek.
- farklı epsilon değerleriyle denemeler yapıyorum.
Veri kurtarma
Reklam teknolojilerinin, raporlama verilerini kurtarabilmeleri için hata ayıklama raporlarını almak üzere hata ayıklama modunu etkinleştirmelerini öneririz. Bu özellik, özet rapor oluşturma işleminin başarısız olmasına yol açabilecek olan kullanım dışı veya yanıt vermeyen hizmetler gibi Toplama Hizmeti sorunları olduğunda kullanışlıdır.