İlişkilendirme raporlarında hata ayıklamayla ilgili 3 bölümden 3. bölüm. Hata ayıklama raporlarının nasıl kullanılacağına dair talimatları bulun.
Bu rehberde, 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ğına dair 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ı hata ayıklama raporları oluşturacak şekilde ayarlayın. Bunu nasıl yapacağınızı 2. Bölüm: Hata ayıklama raporlarını ayarlama başlıklı makalede bulabilirsiniz.
- İlişkilendirme raporlama kodunu dağıttığınızda uç noktanızda başarı hata ayıklama raporları alıp almadığınızı anlık olarak kontrol edin. Bu durumda İlişkilendirme Raporlaması ayarlarınız çalışıyor demektir.
- Başarılı 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 doğru şekilde ayarlanıp ayarlanmadığını kontrol edebilirsiniz. Yani kaynakların başarıyla kaydedilip kaydedilmediğini kontrol edebilirsiniz. Bunu yapmak için kaynak kaydı başarısı ayrıntılı hata ayıklama raporlarından yararlanabilirsiniz. Bu raporların nasıl ayarlanacağını 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 Raporları 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.
Her çerez dönüşümü için dönüşüm sırasında ilgili bir başarı hata ayıklama raporu aldınız mı?
Evet ise: Bu başarı hata ayıklama raporlarının tümü için, birkaç istisna dışında daha sonra bir ilişkilendirme raporu alabilirsiniz. Ayrıntılar için Başarılı hata ayıklama raporu senaryosuna göz atın.
Yoksa: Dönüşüm, İlişkilendirme Raporlaması'na kaydedilmemiştir. Çerez dönüşümlerini ayrıntılı hata ayıklama raporlarıyla eşlemek için <source_debug_key, trigger_debug_key> çiftini (veya tetikleyici hata ayıklama anahtarı yoksa kaynak hata ayıklama anahtarını) kullanın. Bu dönüşümlerin her biri için bir noktada (kaynak veya tetikleyici zamanı) ilgili ayrıntılı hata ayıklama raporu aldınız mı?
Ayrıntılı hata ayıklama raporu almadıysanız bu durum kullanıcı davranışından veya entegrasyon sorunundan kaynaklanabilir. Ayrıntılar için no debug report senaryosunu inceleyin.
Ayrıntılı bir hata ayıklama raporu aldıysanız
typealanına bakın.typedeğerisource-successise: Kaynak başarıyla kaydedilmiş ancak tetikleyici kaydedilmemiş demektir. Başarı hata ayıklama raporunun eksik olmasının nedenini daraltmak için diğer türlerde ilgili ayrıntılı hata ayıklama raporunu 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ı hata ayıklama raporununtypedeğerine bağlı olarak, bu bilgileri yalnızca kayıp analizi veri noktası olarak kullanabilir (yani herhangi bir işlem yapmazsınız) veya bir hata kaydı oluşturabilir ya da uygulamanızda sorun giderebilirsiniz. Ayrıntılar için ayrıntılı hata ayıklama raporu senaryosunu inceleyin.
Olası senaryolar
Başarılı hata ayıklama raporu
Belirli bir çerez dönüşümü için başarılı bir hata ayıklama raporu aldıysanız bu dönüşümün İlişkilendirme Raporları'na başarıyla kaydedilmiş olduğu anlamına gelir.
Birkaç istisna dışında, bu dönüşüm için daha sonra bir ilişkilendirme raporu alabilirsiniz⏤:
- Kullanıcı davranışı: Dönüşümden sonra ve ilişkilendirme raporu gönderilmeden önce verileri temizleme, tarayıcıyı kapatma 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 boyunca gönderilmez. Bu gecikmeyi kayıp olarak değerlendirebilirsiniz.
- Yalnızca etkinlik düzeyi için 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ündeki ayrıntılı hata ayıklama raporu
Belirli bir çerez dönüşümünün kaynağı için source-success türündeki ayrıntılı bir hata ayıklama raporu aldıysanız kaynak kaydı başarılı olmuştur. Tetikleyici kaydının daha sonra da başarılı olup olmadığına bağlı olarak, söz konusu dönüşüm için rapor alabilirsiniz veya alamayabilirsiniz.
Bununla ilgili bir uyarımız var:
Diğer türde 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ı hata ayıklama raporu almazsınız ve dolayısıyla daha sonra ilişkilendirme raporu da almazsınız. Bunun nedeni, ayrıntılı raporların raporlanabilir bir hatanın meydana geldiği anlamına gelmesidir. Kaynak kaydı, tetikleyici kaydı, rapor oluşturma veya rapor gönderme işlemi bir nedenle engellendi. Olası nedenler:
- Gizlilik sınırları
- Depolama sınırları
- Özel kurallar
- Kodunuzdaki uygulama sorunu
- Tarayıcı hatası
Bunlardan bazıları beklenen bir durumdur. Hangi işlemin yapılacağı, ayrıntılı raporların type değerine 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ılı hata ayıklama raporu veya ayrıntılı hata ayıklama raporu yok) bu, hata ayıklama raporlarının oluşturulmasını engelleyen bir şey olduğu anlamına gelir. Olası nedenler:
- Kullanıcı tercihleri (kullanıcı üçüncü taraf çerezlerini devre dışı bırakmışsa)
- Eksik çerez veya hata ayıklama anahtarları (eksik çerez nedeniyle hata ayıklama anahtarı temizlendi).
chrome://attribution-internals'te Günlükler sekmesini açın ve burada herhangi bir sorun olup olmadığını kontrol edin. - İlişkilendirme raporu gönderilirken değil, kaynakta veya tetikleme zamanında gerçekleşen ağ sorunları.
İlişkilendirme raporları alıyor musunuz?
Bu, hata ayıklama raporu alma sorununun 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 yok) raporlanamayan bir hata meydana gelmiş demektir. Olası nedenler:
- Temel entegrasyon sorunu. Bu sorunları nasıl gidereceğinizi Temel entegrasyon sorunlarını düzeltme başlıklı makalede inceleyin.
- Olası ağ sorunları.
- Tarayıcı ayarlarındaki kullanıcı tercihleri (ör. Özel Korumalı Alan) devre dışı bırakıldı.
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ı rapordaki her type için hangi işlemin yapılacağını öğrenmek üzere referansı kullanın.
Kaynak kaydı başarılı
Bir kaynak başarıyla kaydedilir.
source-success- Ayrıntılar ve rapor gövdesi
Gizlilik sınırlamaları raporları
Bu raporlar beklenen raporlardır. Siteler arası kullanıcı kimliği sızıntısını azaltmak için gizlilik sınırlamalarını belirtir.
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 durum, rapor sayısı sınırı aştığında oluşur. Görüntülemeler için en fazla bir dönüşüm, tıklamalar için ise en fazla üç 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 beklenen raporlardır. Bu sınırlar, aşırı kaynak kullanımını önlemek için depolama alanı sınırlarını belirtir.
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 kural raporları
Filtreleme, tekilleştirme, öncelikler veya pencere tabanlı filtreleme kullanıyorsanız bu raporlar beklenir. Bu ayrıntılı rapora karşılık gelen raporun gerçekten bırakmak istediğiniz rapor olduğunu onaylamak için ilgili özel kuralları tekrar kontrol edin. Bu doğruysa herhangi bir işlem yapmanız gerekmez.
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ını gösterebilir.
trigger-no-matching-source- Bu, uygulamayla ilgili bir sorun olabilir.
<reporting origin, destination>kurulumunuzda yanlış yapılandırma olmadığından emin olun. Bu, beklenen bir API davranışı da olabilir. Örneğin, kullanıcı bir reklamla etkileşime geçtikten sonra ve dönüşüm gerçekleştirmeden önce bir noktada verileri temizledi veya ilişkili bir reklamı hiç görmeden dönüşüm gerçekleştirdi. Ayrıntılar ve rapor gövdesi trigger-aggregate-no-contributions- Bu, kodunuzun sergilemesini istediğiniz davranış olmayabilir. 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 sergilemesini istediğiniz davranış olmayabilir. 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
Beklenmedik hatalar (olası tarayıcı hataları)
Bu raporlar beklenmediktir. Bu sorunlar, tarayıcıdaki bir hatadan kaynaklanıyor olabilir. Hata kaydı gönderin ve açıklamanızda sorunun 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, ilgili hata ayıklama raporlarını veya ilişkilendirme raporlarını aramak için çerez tabanlı dönüşüm bilgilerini kullanabilirsiniz.
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.
Çereze dayalı bir dönüşüm kaydettiğinizde, bu çereze dayalı dönüşümle aynı <source_debug_key, trigger_debug_key> çiftine sahip 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ğini gösterir. Bu nedenle, bazı istisnalar dışında her başarı raporuna karşılık gelen bir ilişkilendirme raporu alacağınızı varsayabilirsiniz.
- Bu istisnaları izlemeye karar verebilirsiniz. Bunu yapmak için, ilişkilendirme raporları önümüzdeki günlerde/haftalarda (sürece bağlı olarak) uç noktanıza gönderilirken her başarılı hata ayıklama raporuyla aynı hata ayıklama anahtarı çiftine sahip ilişkilendirme raporlarını arayın. Biraz bekleyin: Raporlar her aralığın 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 kayıp değerlendirmesi
100-70 = 30 başarılı hata ayıklama raporu eksik. Bu, çereze dayalı uygulamanızda izlenen bu 30 dönüşümün İlişkilendirme Raporları ile kaydedilmediği anlamına gelir. Bunlar için ilişkilendirme raporları almazsınız.
100 çerez tabanlı dönüşümünüz ve yalnızca 70 ilişkilendirme tabanlı dönüşümünüz olduğundan kaybınız %30'tur. Kısa bir kayıp değerlendirmesi yaptınız.
4. adım: Nedenleri analiz edin
Bu raporların neden eksik olduğunu incelemek için dönüşüm (tetikleyici kaydı) zamanında veya daha önce kaynak kaydı zamanında aldığınız ayrıntılı hata ayıklama raporlarını arayın. 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 analizinizi hassaslaştırabilirsiniz. Her ayrıntılı raporun
typealanını analiz edin. Örneğin, aşağıdakileri görebilirsiniz:pending destination limitnedeniyle 10 (örnekteki% 10) rapor eksiktrigger-aggregate-no-contributionsnedeniyle 5 (= %5) rapor eksik.unknown-errornedeniyle 5 (= %5) rapor eksik.
5. adım: İşlem yapın ve sorunları giderin
Raporların neden eksik olduğu konusunda bilgi sahibi olduğunuza göre bu analizleri kullanarak işlem yapabilirsiniz.
Hangi işlemin yapılacağı, ayrıntılı raporların type değerine 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. Yapmanız gereken herhangi bir işlem yoktur. Bu sayıyı kendi görünürlüğünüzü ve izlemenizi sağlamak için veri noktası olarak kullanın.trigger-aggregate-no-contributions, sizin tarafınızda bir uygulama sorununun işareti olabilir. Bu konuyu daha ayrıntılı inceleyin. Sorunu gidermek ve gerekirse düzeltmek için ayrıntılı raporun gövdesinde yer alan ayrıntıları kullanın.unknown-error, tarayıcı hatası veya ağ hatası belirtisi olabilir. Bu sorunla tekrar tekrar karşılaşırsanız tarayıcı geliştiricileri için bir hata kaydı oluşturun.