İlişkilendirme Raporları'nda hata ayıklama ile ilgili 3 bölümden oluşan serinin 3. bölümü. Hata ayıklama raporlarını kullanmayla ilgili talimatları inceleyin.
Bu çözüm kitabında, 1. Bölüm: Hata ayıklama raporlarına giriş bölümünde açıklanan çeşitli kullanım alanları için hata ayıklama raporlarının nasıl kullanılacağıyla ilgili talimatları bulabilirsiniz.
Sözlük
- Raporlama kaynağı, İlişkilendirme Raporlama kaynağı ve tetikleyici başlıklarını ayarlayan kaynaktır.
Tarayıcı tarafından oluşturulan tüm raporlar bu kaynağa gönderilir. Bu kılavuzda, örnek raporlama kaynağı olarak
https://adtech.examplekullanılmıştır. - İlişkilendirme raporu (kısaca rapor), istediğiniz ölçüm verilerini içeren nihai rapordur (etkinlik düzeyinde veya toplanabilir).
- Hata ayıklama raporu bir ilişkilendirme raporu veya bir kaynak ya da tetikleyici etkinliği hakkında ek veriler içerir. Hata ayıklama raporu almak bir şeylerin yolunda olduğu anlamına gelmez. İki tür hata ayıklama raporu vardır
- Geçişli hata ayıklama raporu, oluşturulup gönderilmesi için bir çerezin ayarlanmasını gerektiren hata ayıklama raporudur. Bir çerez ayarlanmazsa ve üçüncü taraf çerezleri kullanımdan kaldırıldığında geçişli hata ayıklama raporları kullanılamaz. Bu kılavuzda açıklanan tüm hata ayıklama raporları, geçişli hata ayıklama raporlarıdır.
- 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ı hata ayıklama raporları, Chrome 101 sürümünden (Nisan 2022) beri kullanılabiliyor.
- Ayrıntılı hata ayıklama raporları, eksik raporları izleyebilir ve bunların neden eksik olduğunu belirlemenize yardımcı olabilir. Tarayıcının bir kaynağı kaydetmediği veya etkinliği tetiklemediği (yani ilişkilendirme raporu oluşturmadığı) ve herhangi bir nedenle ilişkilendirme raporunun oluşturulamadığı ya da gönderilemediği durumları gösterir.
Ayrıntılı hata ayıklama raporlarında kaynak etkinlik, tetikleyici etkinliği veya ilişkilendirme raporunun oluşturulmama nedenini açıklayan bir
typealanı bulunur. Ayrıntılı hata ayıklama raporları, Chrome 109 sürümünden itibaren kullanıma sunulmuştur (Ocak 2023'te kararlı durumda). - Hata ayıklama anahtarları hem kaynak hem de tetikleyici tarafında ayarlayabileceğiniz benzersiz tanımlayıcılardır. Hata ayıklama anahtarları, çereze dayalı dönüşümleri ve ilişkilendirmeye dayalı dönüşümleri eşlemenizi sağlar. Sisteminizi hata ayıklama raporları oluşturacak ve hata ayıklama anahtarları ayarlayacak şekilde ayarladığınızda tarayıcı bu hata ayıklama anahtarlarını tüm ilişkilendirme raporlarına ve hata ayıklama raporlarına ekler.
Belgelerimizde kullanılan diğer kavramlar ve anahtar terimler için Özel Korumalı Alan sözlüğüne bakın.
Nasıl yapılır: Entegrasyonunuzu gerçek zamanlı olarak kontrol etme
- Sisteminizi başarılı hata ayıklama raporları oluşturacak şekilde ayarlayın. Nasıl yapılacağını 2. Bölüm: Hata ayıklama raporlarını ayarlama başlıklı makalede bulabilirsiniz.
- Attribution Reporting kodunu her dağıttığınızda, uç noktanızda bazı başarılı hata ayıklama raporları alıp almadığınızı gerçek zamanlı olarak kontrol edin. Bu durumda, Attribution Reporting kurulumunuz çalışıyor demektir.
- Başarı hata ayıklama raporları yalnızca dönüşüm gerçekleştiğinde gönderilir. Bunun yerine, dönüşümlerden bağımsız olarak entegrasyonunuzun düzgün şekilde ayarlandığını kontrol etmek isteyebilirsiniz. Yani kaynakların başarıyla kaydedildiğini kontrol etmek isteyebilirsiniz. Bunu başarmak için kaynak kaydı başarısı ayrıntılı hata ayıklama raporlarından yararlanabilirsiniz. Bunları nasıl ayarlayacağınızı 2. Bölüm: Hata ayıklama raporlarını ayarlama başlıklı makalede bulabilirsiniz.
Nasıl yapılır: Kaybı analiz etme ve entegrasyonunuzla ilgili sorunları giderme
Çerez tabanlı dönüşüm ölçümü sonuçlarını İlişkilendirme Raporlama raporlarıyla karşılaştırmak için hata ayıklama anahtarlarını kullanın ve çerez dönüşümlerini hata ayıklama raporlarıyla eşleyin. Hata ayıklama raporlarının, uç noktanıza hemen gönderildiğini unutmayın.
Genel Bakış
Çerez dönüşümlerini başarı hata ayıklama raporlarıyla eşlemek için hata ayıklama anahtarlarını (<source_debug_key, trigger_debug_key> çifti) kullanın.
Dönüşüm zamanında, her çerez dönüşümü için karşılık gelen bir başarı hata ayıklama raporu aldınız mı?
Evetse: Bu başarılı hata ayıklama raporlarının tümü için daha sonra (birkaç istisna dışında) bir ilişkilendirme raporu almayı bekleyebilirsiniz. Ayrıntılar için Başarılı hata ayıklama raporu senaryosunu inceleyin.
Hayırsa: Bu, dönüşümün Attribution Reporting ile kaydedilmediği anlamına gelir. Çerez dönüşümlerini ayrıntılı hata ayıklama raporlarıyla eşlemek için <source_debug_key, trigger_debug_key> çiftini (tetikleyici hata ayıklama anahtarı yoksa kaynak hata ayıklama anahtarı) kullanın. Bu dönüşümlerin her biri için bir noktada (kaynak veya tetikleme zamanı) karşılık gelen ayrıntılı bir hata ayıklama raporu aldınız mı?
Ayrıntılı bir hata ayıklama raporu almadıysanız: Bu durum, kullanıcı davranışından veya entegrasyon sorunundan kaynaklanabilir. Ayrıntılar için hata ayıklama raporu olmayan senaryoyu inceleyin.
Ayrıntılı bir hata ayıklama raporu aldıysanız
typealanına bakın.typedeğerisource-successise: Bu, kaynağın başarıyla kaydedildiği ancak tetikleyicinin kaydedilmediği anlamına gelir. Başarı hata ayıklama raporunun eksik olmasının nedenini daraltmak için başka bir türde ayrıntılı bir hata ayıklama raporu arayın. Bu rapor, tetikleyici tarafında bir sorun olduğunu gösterir.typedeğeri başka bir şeyse: Kaynak veya tetikleyici kaydedilmemiştir.typenedenini açıklar. İlgili ilişkilendirme raporu (ve başarı hata ayıklama raporu) eksik olur. Ayrıntılı bir hata ayıklama raporununtypedurumuna bağlı olarak, bu bilgiyi yalnızca bir kayıp analizi veri noktası olarak değerlendirmek (yani sizin için herhangi bir işlem yapmamak) veya bir hata kaydetmek ya da uygulamanızda sorun gidermek isteyebilirsiniz. Ayrıntılar için ayrıntılı hata ayıklama raporu senaryosunu inceleyin.
Olası senaryolar
Başarı hata ayıklama raporu
Belirli bir çerez dönüşümü için başarı hata ayıklama raporu aldıysanız bu dönüşümün İlişkilendirme Raporlama ile başarıyla kaydedildiği anlamına gelir.
Bu dönüşüm için daha sonra bir ilişkilendirme raporu almayı bekleyebilirsiniz (birkaç istisna dışında):
- Kullanıcı davranışı: Dönüşümden sonra ve ilişkilendirme raporu gönderilmeden önce verilerin temizlenmesi, tarayıcının kapatılması vb. Bir kullanıcı dönüşüm gerçekleştirdikten sonra tarayıcısını kapatır ve bir hafta boyunca tarayıcısını açmazsa rapor bir hafta veya daha uzun süre gönderilmez. Bu gecikmeyi kayıp olarak değerlendirebilirsiniz.
- Yalnızca etkinlik düzeyinde geçerlidir: Etkinlik düzeyindeki bir rapor, daha yüksek öncelikli başka bir raporla değiştirilir.
- Olası ağ sorunları.
source-success türünde ayrıntılı hata ayıklama raporu
Belirli bir çerez dönüşümünün kaynağı için source-success türünde ayrıntılı bir hata ayıklama raporu aldıysanız bu, kaynak kaydının başarılı olduğu anlamına gelir. Daha sonra tetikleyici kaydı da başarılı olursa söz konusu dönüşüm için rapor alabilirsiniz veya almayabilirsiniz.
Bu konuda dikkat edilecek bir nokta vardır:
Diğer türlerdeki ayrıntılı hata ayıklama raporu
Belirli bir çerez dönüşümü için başka bir türde ayrıntılı bir hata ayıklama raporu aldıysanız başarılı hata ayıklama raporu ve dolayısıyla daha sonra da bir ilişkilendirme raporu almazsınız. Bunun nedeni, ayrıntılı raporun raporlanabilir bir hatanın meydana geldiği anlamına gelmesidir. Kaynak kaydı, tetikleyici kaydı, rapor oluşturma veya rapor gönderme işlemi bir nedenden dolayı engellendi. Olası nedenler:
- Gizlilik sınırları
- Depolama sınırları
- Özel kurallar
- Kodunuzdaki uygulama sorunu
- Tarayıcı hatası
Bunlardan bazıları beklenen durumlardır. Hangi işlemin yapılacağı, her ayrıntılı raporun type bağlıdır. Ayrıntılı raporlar referansını inceleyin.
Hata ayıklama raporu yok
Belirli bir çerez dönüşümü için yalnızca bir ilişkilendirme raporu aldıysanız (başarı hata ayıklama raporu veya ayrıntılı hata ayıklama raporu yoksa) bu, hata ayıklama raporlarının oluşturulmasını engelleyen bir durum olduğu anlamına gelir. Olası nedenler:
- Kullanıcı tercihleri (kullanıcı, üçüncü taraf çerezlerini devre dışı bırakmıştır)
- Çerez eksik veya hata ayıklama anahtarları eksik (hata ayıklama anahtarı, çerez eksik olduğundan temizlendi).
chrome://attribution-internalsbölümünde Günlükler sekmesini açın ve burada herhangi bir sorun olup olmadığını kontrol edin. - Kaynak veya tetikleme zamanında meydana gelen ancak ilişkilendirme raporu gönderilirken oluşmayan ağ sorunları.
İlişkilendirme raporları alıyor musunuz?
Bu, hata ayıklama raporu almama durumunun bir alt durumudur: Belirli bir çerez dönüşümü için herhangi bir rapor almadıysanız (herhangi bir hata ayıklama raporu, ilişkilendirme raporu yoksa) bu, raporlanamayan bir hatanın meydana geldiği anlamına gelir. Olası nedenler:
- Temel entegrasyon sorunu. Bunları nasıl gidereceğinizi öğrenmek için Temel entegrasyon sorunlarını düzeltme başlıklı makaleyi inceleyin.
- Olası ağ sorunları.
- Tarayıcı ayarlarında kullanıcı tercihleri (ör. Özel Korumalı Alan devre dışı bırakılmış).
Ayrıntılı hata ayıklama raporları referansı
Her ayrıntılı hata ayıklama raporunda, ilgili ilişkilendirme raporunun neden bırakıldığını belirten bir type alanı bulunur. Ayrıntılı raporun her type için hangi işlemin yapılacağını belirlemek üzere referansı kullanın.
Kaynak kaydı başarılı
Kaynak başarıyla kaydedildi.
source-success- Ayrıntılar ve rapor gövdesi
Gizlilik sınırlamaları raporları
Bu raporlar beklenir. Siteler arası kullanıcı kimliği sızıntısını azaltmak için gizlilik sınırlamalarını gösterirler.
source-destination-limit- Ayrıntılar ve rapor gövdesi
source-noised- Ayrıntılar ve rapor gövdesi
trigger-attributions-per-source-destination-limit- Ayrıntılar ve rapor gövdesi
trigger-reporting-origin-limit- Ayrıntılar ve rapor gövdesi
trigger-event-noise- Ayrıntılar ve rapor gövdesi
trigger-event-excessive-reports- Bu, rapor sayısı sınırın üzerinde olduğunda oluşturulur. Görüntülemeler için en fazla bir, tıklamalar için ise üç dönüşüm kaydedebilirsiniz. Öncelikler belirleyerek hangi raporları alacağınızı yapılandırabileceğinizi unutmayın. Ayrıntılar ve rapor gövdesi
Depolama alanı sınırlamaları raporları
Bu raporlar beklenir. Aşırı kaynak kullanımını önlemek için depolama alanı sınırlamalarını gösterirler.
source-storage-limit- Ayrıntılar ve rapor gövdesi
trigger-event-storage-limit- Ayrıntılar ve rapor gövdesi
trigger-aggregate-storage-limit- Ayrıntılar ve rapor gövdesi
Özel kurallar raporları
Filtreleme, tekilleştirme, öncelikler veya pencere tabanlı filtreleme kullanıyorsanız bu raporlar beklenir. İlgili ayrıntılı raporun gerçekten silmek istediğiniz bir rapor olduğunu doğrulamak için ilgili özel kuralları tekrar kontrol edin. Bu doğruysa herhangi bir işlem yapmanıza gerek yoktur.
trigger-no-matching-filter-data- Ayrıntılar ve rapor gövdesi
trigger-event-no-matching-configuration- Ayrıntılar ve rapor gövdesi
trigger-event-deduplicated- Ayrıntılar ve rapor gövdesi
trigger-aggregate-deduplicated- Ayrıntılar ve rapor gövdesi
trigger-event-low-priority- Ayrıntılar ve rapor gövdesi
trigger-event-report-window-passed- Ayrıntılar ve rapor gövdesi
trigger-aggregate-report-window-passed- Ayrıntılar ve rapor gövdesi
Diğer ayrıntılı raporlar
Bu raporlar, kodunuzda olası uygulama sorunları olduğunu gösterebilir.
trigger-no-matching-source- Bu, uygulama ile ilgili bir sorun olabilir.
<reporting origin, destination>kurulumunuzda yanlış yapılandırma olmadığından emin olun. Bu, beklenen API davranışı da olabilir. Örneğin, kullanıcı bir reklamla etkileşim kurduktan ve dönüşüm gerçekleştirmeden önce bir noktada verileri temizlemiş veya ilişkili bir reklamı hiç görmeden dönüşüm gerçekleştirmiş olabilir. Ayrıntılar ve rapor gövdesi trigger-aggregate-no-contributions- Bu, kodunuzun olmasını istediğiniz davranış değildir. Tetikleyici kayıt kodunuzla ilgili sorunları giderin ve katkı yapılandırmanızın doğru olduğundan emin olun. Ayrıntılar ve rapor gövdesi
trigger-aggregate-insufficient-budget- Bu, kodunuzun olmasını istediğiniz davranış değildir. Tüm katkıların toplamının katkı bütçesini aşmadığından emin olmak için tetikleyici kayıt kodunuzu tekrar kontrol edin. Ayrıntılar ve rapor gövdesi
Beklenmeyen hatalar (tarayıcı hataları olabilir)
Bu raporlar beklenmedik. Bu durum, tarayıcı hatasından kaynaklanıyor olabilir. Hata bildirin ve açıklamanızda hatanın yeniden oluşturulması için uygulanacak adımları belirtin.
source-unknown-error- Ayrıntılar ve rapor gövdesi
trigger-unknown-error- Ayrıntılar ve rapor gövdesi
Kayıp analizi örneği
1. adım: Çerezlerle kurulum ve eşleme
Sisteminizi başarılı hata ayıklama raporları ve ayrıntılı hata ayıklama raporları oluşturacak şekilde ayarlamak için 2. Bölüm: Hata ayıklama raporlarını ayarlama bölümündeki talimatları uygulayın.
Bu sayede, çerez tabanlı dönüşüm bilgilerini kullanarak ilgili hata ayıklama raporlarını veya ilişkilendirme raporlarını arayabilirsiniz.
2. adım: Başarılı kayıtları ve eksik raporları belirleyin
Bu örnekte, çerez tabanlı sisteminizle 100 dönüşüm izlediğinizi varsayalım.
Çerez tabanlı bir dönüşüm her kaydettiğinizde, bu çerez tabanlı dönüşümle aynı <source_debug_key, trigger_debug_key> çiftine sahip olan başarı hata ayıklama raporunu (hemen gönderilir) arayın.
Bu çerez dönüşümlerinin 70'i için başarılı bir hata ayıklama raporu aldığınızı varsayalım.
- Başarı raporları, ilişkilendirmenin başarıyla kaydedildiği anlamına gelir. Bu nedenle, bazı istisnalar dışında her başarı raporuna karşılık gelen bir ilişkilendirme raporu alacağınızı güvenle varsayabilirsiniz.
- Bu istisnaları izlemeye karar verebilirsiniz. Bunu yapmak için, ilişkilendirme raporları önümüzdeki günlerde veya haftalarda (geçerlilik süresine bağlı olarak) uç noktanıza gönderilirken her başarı hata ayıklama raporuyla aynı hata ayıklama anahtarı çiftine sahip ilişkilendirme raporlarını arayın. Biraz beklediğinizden emin olun: Raporlar, her dönemin sonunda hemen gönderilmeyebilir. Yalnızca 60 ilişkilendirme raporu bulduğunuzu varsayalım. Eksik olan 10 ilişkilendirme raporu, kullanıcı davranışından kaynaklanıyor olabilir.
3. adım: Kısa hasar değerlendirmesi
100-70 = 30 başarılı hata ayıklama raporu eksik. Bu durumda, bu 30 dönüşüm (çerez tabanlı uygulamanızda izlenen) İlişkilendirme Raporları ile kaydedilmemiştir. Bunlar için ilişkilendirme raporları almazsınız.
100 çereze dayalı dönüşümünüz ve yalnızca 70 ilişkilendirmeye dayalı dönüşümünüz olduğundan kaybınız %30'dur. Artık kısa bir kayıp değerlendirmeniz var.
4. adım: Nedenleri analiz edin
Bu raporların neden eksik olduğunu araştırmak için dönüşüm (tetikleyici kaydı) sırasında veya daha önce kaynak kaydı sırasında aldığınız ayrıntılı hata ayıklama raporlarını bulun. Bunları ayrıntılı hata ayıklama raporlarıyla eşlemek için çerez tabanlı dönüşümlerin anahtarlarını kullanın.
- Ayrıntılı hata ayıklama raporu olmayan 10 anahtar olduğunu varsayalım. Entegrasyon sorunu olup olmadığını kontrol edin. Aksi takdirde, bu durum kullanıcı davranışından kaynaklanıyor olabilir.
- 20 ayrıntılı hata ayıklama raporunuz var. Artık kayıp analizlerinizi daha ayrıntılı hale getirebilirsiniz. Ayrıntılı raporların her birinin
typealanını analiz edin. Örneğin, aşağıdakileri fark edebilirsiniz:pending destination limitnedeniyle 10 rapor eksik (= örneğimizde% 10)trigger-aggregate-no-contributionsnedeniyle 5 rapor (%5) eksik.unknown-errornedeniyle 5 rapor (%5) eksik.
5. adım: Harekete geçin ve sorunları giderin
Raporların neden eksik olduğu konusunda bilgi edindiğinize göre artık bu analizlere göre hareket edebilirsiniz.
Hangi işlemin yapılacağı, her ayrıntılı raporun type bağlıdır. Ayrıntılar için ayrıntılı raporlar referansını inceleyin. Örneğin:
pending-destination-limit, gizlilik korumasıdır. Herhangi bir işlem yapmanız gerekmez. Bu sayıyı, kendi görünürlüğünüz ve izlemeniz için bir veri noktası olarak kullanın.trigger-aggregate-no-contributions, sizden kaynaklanan bir uygulama sorununun işareti olabilir. Bu konuyu daha ayrıntılı analiz et. Gerekirse bu sorunu gidermek ve düzeltmek için ayrıntılı raporun gövdesindeki bilgileri kullanın.unknown-error, tarayıcı hatası veya ağ hatası işareti olabilir. Bu sorunla tekrar tekrar karşılaşırsanız tarayıcı geliştiricileri için bir hata kaydı oluşturun.