İlişkilendirme Raporları hata ayıklama raporlarına giriş

İ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 etmelisiniz. Aksi takdirde, ve İlişkilendirme Raporlama uygulamanız hakkında daha fazla bilgi edinin ve entegrasyonunuzla ilgili sorunları giderin.

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. İlişkilendirdikleri doğrudan ilişkilendirme raporuna gönderebilirsiniz.

Başarıyla ilgili hata ayıklama raporları, Chrome 101 sürümünden (Nisan 2022) beri mevcuttur.

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ını kullanmak için raporlama kaynağının bir çerez ayarlaması gerekir.

Rapor almak üzere yapılandırılan kaynak üçüncü tarafsa bu çerez bir üçüncü taraf olur çerez. Bunun birkaç önemli etkisi vardır:

  • Hata ayıklama raporları yalnızca üçüncü taraf çerezleri Tarayıcıda izin verilen siteler.
  • Hata ayıklama raporları, üçüncü taraf çerezleri kullanımdan kaldırıldıktan sonra kullanılamayacak aşamalı olarak kullanımdan kaldırıldı.

Hata ayıklama raporları hemen gönderilir

Hata ayıklama raporları tarayıcı tarafından hemen raporlama kaynağına gönderilir. Bu gecikme.

Başarıyla ilişkili hata ayıklama raporları, ilgili ilişkilendirme raporu oluşturulur: yani, tetikleyicide teşekkür ederiz.

Ayrıntılı hata ayıklama raporları, kaynak veya tetikleyicinin hemen ardından gönderilir teşekkür ederiz.

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ü

Hata ayıklama raporları, ilişkilendirme raporlarının aksine hemen uç noktanıza gönderilir Bu reklamlar, kullanıcı gizliliğini korumak için gecikir. Hata ayıklama raporlarını, Search Ads 360 ile entegrasyonunuzun gerçek zamanlı bir sinyal olarak Attribution Reporting API çalışıyor.

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, İlişkilendirme Raporları API'de yerleşik gizlilik bulunur koruma özellikleri ve uygulamalar arasında ve gizlilik. Bu, Attribution Reporting API'yi kullanırken topladığınız tüm ölçüm verilerini toplamanıza olanak tanır. çerezler. Yapabileceğiniz tüm dönüşümleri üçüncü taraf çerezleriyle izleme, ilişkilendirme raporu oluşturur.

Örnek: Etkinlik düzeyindeki raporlar için en fazla bir dönüşüm kaydedebilirsiniz gösterim başına maliyet. 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.

Uygulamanız ile kampanyalarınız arasındaki farkları görmek için hata ayıklama raporlarını Çerez tabanlı ölçüm sonuçları ve İlişkilendirme ile elde ettiğiniz sonuçlar Raporlama API'si. Hangi dönüşümlerin raporlandığını ve kaç dönüşümün hangilerinin raporlanmadığını, özellikle de hangilerinin

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 beklense de kasıtsız olabilir. Uygulamanızdaki yanlış yapılandırmalar veya tarayıcının kendisi raporların kaybolmasına neden olabilir.

Hata ayıklama raporlarını kullanarak tarafınızda uygulama ile ilgili bir sorunu tespit edip düzeltebilir veya tarayıcı ekiplerine olası bir hatayı bildirme Bunu nasıl yapacağınızı şuradan öğrenebilirsiniz: 3. Bölüm: Hata ayıklamak için tarif defteri.

Gelişmiş yapılandırma kontrolü

Attribution Reporting API'nin bazı özellikleri, API'nin temel özelliklerini ve bunları kontrol etmenizi sağlar. Filtreleme kuralları, tekilleştirme kuralları ve öncelik kuralları örnek olarak verilebilir.

Bu özellikleri kullanırken mantığınızın istenen davranışa yönlendirdiğini kontrol etmek için hata ayıklama raporlarını kullanın üretim, ilişkilendirme raporlarını beklemeden. 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ş ve toplu hale getirilebilir hata ayıklama raporlarının aksine, toplanabilir ilişkilendirme raporlarının aksine dahil edilmemelidir.

Birleştirilebilir raporların içeriğini doğrulamak için toplanabilir hata ayıklama raporlarını kullanma ve test için yerel toplama aracı ile özet raporlar oluşturmak.

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.

Sıradaki

2. Bölüm: Hata ayıklama raporlarını ayarlayın