İlişkilendirme Raporlarında hata ayıklamayla ilgili Bölüm 3/3. Hata ayıklama raporlarının kullanımıyla ilgili talimatları inceleyin.
Bu tarif defterinde, 1. Bölüm: Hata ayıklama raporlarına giriş bölümünde özetlenen çeşitli kullanım örneklerinde 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.example
kullanı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
type
alanı 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. 2. Bölüm: Hata ayıklama raporlarını ayarlama bölümünde bu işlemi nasıl yapacağınızı öğrenebilirsiniz.
- İlişkilendirme Raporlama kodunu her dağıttığınızda, uç noktanızda başarı hata ayıklama raporları alıp almadığınızı gerçek zamanlı olarak kontrol edin. Bu durumda, İlişkilendirme Raporlama kurulumunuz çalışıyor.
- 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 ayarlanıp ayarlanmadığını kontrol etmek, yani kaynakların başarıyla kaydedilip kaydedilmediğini kontrol etmek isteyebilirsiniz. Bunun için kaynak kaydı başarılı ayrıntılı hata ayıklama raporlarına güvenebilirsiniz. Bunları nasıl ayarlayacağınızı 2. Bölüm: Hata ayıklama raporlarını ayarlama bölümünde öğrenebilirsiniz.
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ış
![Kayıp analizi adımları](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=9&hl=tr)
Ç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 buna karşılık gelen bir başarı hata ayıklama raporu aldınız mı?
Yanıtınız evet ise: Tüm bu başarı ayıklama raporları için birkaç istisna dışında daha sonra bir ilişkilendirme raporu almayı bekleyebilirsiniz. Ayrıntılar için Başarılı hata ayıklama raporu senaryosunu inceleyin.
Değilse: Bu, dönüşümün İlişkilendirme Raporlama'ya 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 (veya tetikleyici hata ayıklama anahtarı yoksa kaynak hata ayıklama anahtarını) kullanın. Bu dönüşümlerin her biri için herhangi bir noktada (kaynak veya tetikleyici zamanı) ilgili bir ayrıntılı 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 kaynaklanıyor olabilir. Ayrıntılar için hata ayıklama yok raporu senaryosunu inceleyin.
Ayrıntılı bir hata ayıklama raporu aldıysanız
type
alanına bakın.type
değerisource-success
ise: bu, kaynağın başarıyla kaydettirildiği ancak tetikleyicinin olmadığı anlamına gelir. Başarı hata ayıklama raporunun neden eksik olduğunu daraltmak için başka herhangi bir türde karşılık gelen bir ayrıntılı hata ayıklama raporu arayın. Bu rapor, tetikleyici tarafında bir sorun olduğunu gösterir.type
başka bir değerse kaynak veya tetikleyici kaydedilmemiştir. Bunun nedeninitype
açıklıyor. İlgili ilişkilendirme raporu (ve başarı hata ayıklama raporu) eksik olacaktır. Ayrıntılı hata ayıklama raporununtype
değerine bağlı olarak, bu bilgileri yalnızca bir kayıp analizi veri noktası olarak almak (diğer bir deyişle, sizin için bir işlem yapılmasına gerek yoktur) veya bir hata bildirmek ya da uygulamanızla ilgili sorunları 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üyle ilgili başarı hata ayıklama raporu aldıysanız bu dönüşüm, İlişkilendirme Raporlarına başarıyla kaydedilmiştir.
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ısını kapatma vb. Kullanıcı dönüşüm gerçekleştirdikten sonra tarayıcısını kapatır ve tarayıcısını bir hafta boyunca açmazsa rapor bir hafta veya daha uzun bir süre boyunca gönderilmez. Bu gecikmeyi bir kayıp olarak düşünebilirsiniz.
- Yalnızca Etkinlik Düzeyi için geçerlidir: Etkinlik düzeyindeki bir raporun yerini daha yüksek öncelikli başka bir rapor alır.
- 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. Tetikleyici kaydının daha sonra da başarılı olup olmamasına bağlı olarak, söz konusu dönüşüm için bir rapor alabilirsiniz veya almayabilirsiniz.
Bu konuda dikkat edilmesi gereken bir nokta vardır:
Diğer türlerin ayrıntılı hata ayıklama raporu
Belirli bir çerez dönüşümü için başka herhangi bir türden ayrıntılı bir hata ayıklama raporu aldıysanız başarı hata ayıklama raporu almazsınız ve bu nedenle daha sonra ilişkilendirme raporu almazsınız⏤ Bunun nedeni ayrıntılı bir rapor, raporlanabilir bir hata oluştuğu anlamına gelir. Kaynak kaydını, tetikleyici kaydını, rapor oluşturmayı veya rapor göndermeyi engelleyen bir durum nedeniyle engellendi. Olası nedenler:
- Gizlilik sınırları
- Depolama sınırları
- Özel kurallar
- Kodunuzdaki uygulama sorunu
- Tarayıcı hatası
Bunlardan bazılarının olması beklenen bir durumdur. Yapılacak işlem, her ayrıntılı raporun type
ayarına bağlıdır. Ayrıntılı rapor referansını inceleyin.
Hata ayıklama raporu yok
Belirli bir çerez dönüşümü için yalnızca bir ilişkilendirme raporu (başarı hata ayıklama raporu veya ayrıntılı hata ayıklama raporu almadıysanız) aldıysanız 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 kapatmıştır)
- Eksik çerez veya eksik hata ayıklama anahtarları (eksik çerez nedeniyle hata ayıklama anahtarı temizlendi).
chrome://attribution-internals
sayfasında Günlükler sekmesini açın ve burada herhangi bir sorun olup olmadığını kontrol edin. - Kaynak veya tetikleyici zamanında meydana gelen, ancak ilişkilendirme raporu gönderildiği sırada olmayan ağ sorunları.
İlişkilendirme raporları alıyor musunuz?
Bu, hata ayıklama raporu almamanın bir alt durumudur: Belirli bir çerez dönüşümü için hiçbir türde rapor almadıysanız (hiçbir türde hata ayıklama raporu veya ilişkilendirme raporu almadıysanız) bu, raporlanamayan bir hata meydana geldiği anlamına gelir. Olası nedenler:
- Temel entegrasyon sorunu. Bu sorunları nasıl gidereceğinizi Temel entegrasyon sorunlarını düzeltme başlıklı makalede inceleyebilirsiniz.
- Olası ağ sorunları.
- Özel Korumalı Alan kapalı gibi tarayıcı ayarlarındaki kullanıcı tercihleri.
Ayrıntılı hata ayıklama raporu referansı
Her ayrıntılı hata ayıklama raporunda, ilgili ilişkilendirme raporunun neden bırakıldığını gösteren bir type
alanı bulunur. Ayrıntılı raporun her type
numarası için hangi işlemin gerçekleştirileceğini belirlemek için referansı kullanın.
Kaynak kaydı başarılı
Bir kaynak başarıyla kaydedildi.
source-success
- Ayrıntılar ve rapor gövdesi
Gizlilik sınırlamaları raporları
Bu tür raporlar almanız normaldir. Siteler arası kullanıcı kimliği sızıntısını azaltmak için gizlilik sınırlamalarını gösterir.
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
- Rapor sayısı sınırın üzerindeyse bu sayı oluşturulur. Görüntülemeler için en fazla bir, tıklamalar için de en fazla üç dönüşüm kaydedebilirsiniz. Öncelikleri ayarlayarak alınacak raporları yapılandırabileceğinizi unutmayın. Ayrıntılar ve rapor gövdesi
Depolama alanı sınırlamaları raporları
Bu tür raporlar almanız normaldir. 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 kural raporları
Filtreleme, tekilleştirme, öncelikler veya pencere tabanlı filtreleme kullanıyorsanız bu raporların kullanılması beklenir. Her ihtimale karşı, ayrıntılı rapora karşılık gelen raporun gerçekten çıkarmak istediğiniz bir rapor olduğunu onaylamak için ilgili özel kuralları bir kez daha kontrol edin. Bu bilgi 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 bir uygulama sorunu 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 belirli 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, büyük olasılıkla kodunuzda istediğiniz davranış değildir. Tetikleyici kayıt kodunuzla ilgili sorunları giderin. Katkı yapılandırmanızın doğru olduğundan emin olun. Ayrıntılar ve rapor gövdesi
trigger-aggregate-insufficient-budget
- Bu, büyük olasılıkla kodunuzda istediğiniz davranış değildir. Tüm katkıların toplam katkı bütçesini aşmadığından emin olmak için tetikleyici kayıt kodunuzu bir kez daha kontrol edin. Ayrıntılar ve rapor gövdesi
Beklenmeyen hatalar (olası tarayıcı hataları)
Bu raporlar beklenmedik niteliktedir. Bu hata, tarayıcı hatasından kaynaklanıyor olabilir. Hata bildiriminde bulunun ve açıklamanızda hatanın yeniden oluşmasına ilişkin 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ı 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.
Böylece ilgili hata ayıklama raporlarını veya ilişkilendirme raporlarını aramak için çereze dayalı 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.
Çerez tabanlı bir dönüşümü her 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önderilen) bulun.
Bu çerez dönüşümlerinden 70 tanesi için bir başarı 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ı istisnalarla birlikte her başarı raporuna karşılık gelen bir ilişkilendirme raporu alacağınızı güvenli bir şekilde varsayabilirsiniz.
- Bu istisnaları izlemeye karar verebilirsiniz. Bunu yapmak için, ilişkilendirme raporları önümüzdeki günlerde/haftalarda (süresine bağlı olarak) uç noktanıza gönderildiğinden, her bir başarı hata ayıklama raporundaki hata ayıklama anahtar çiftiyle aynı olan ilişkilendirme raporlarını bulun. Bir süre bekleyin. Raporlar, her pencerenin sonunda hemen gönderilmeyebilir. Yalnızca 60 ilişkilendirme raporu bulduğunuzu varsayalım. Eksik olan 10 ilişkilendirme raporu kullanıcı davranışlarından kaynaklanıyor olabilir.
3. Adım: Kısa kayıp değerlendirmesi
100-70 = 30 başarı hata ayıklama raporu eksik. Diğer bir deyişle, çerez tabanlı uygulamanızda izlenen bu 30 dönüşüm İlişkilendirme Raporlama ile kaydedilmemiştir. Bunlarla ilgili ilişkilendirme raporları almayacaksı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 olur. Artık kısa bir kayıp değerlendirmesi yaptınız.
4. Adım: Nedenleri analiz etme
Bu raporların neden eksik olduğunu araştırmak için kaynak kaydı zamanında veya daha önce dönüşüm (tetikleyici kaydı) zamanında veya daha önce aldığınız ilgili ayrıntılı hata ayıklama raporlarını arayın. Bunları ayrıntılı hata ayıklama raporlarıyla eşlemek için çereze dayalı dönüşümlerin anahtarlarını kullanın.
- Ayrıntılı hata ayıklama raporunun bulunmadığı 10 anahtar olduğunu varsayalım. Herhangi bir entegrasyon sorunu olup olmadığını kontrol edin. Doğru değilse bunun nedeni kullanıcı davranışı olabilir.
- 20 ayrıntılı hata ayıklama raporunuz var. Artık kayıp analizinizi hassaslaştırabilirsiniz. Her ayrıntılı raporun
type
alanını analiz edin. Örneğin, şu bilgileri görebilirsiniz:pending destination limit
nedeniyle 10 (örneğimizde% 10) rapor eksiktrigger-aggregate-no-contributions
nedeniyle 5 (= %5) rapor eksik.unknown-error
nedeniyle 5 (= %5) rapor eksik.
5. Adım: İşlem yapma ve sorun giderme
Raporların neden eksik olduğunu öğrendiğinize göre artık bu analizlere göre hareket edebilirsiniz.
Yapılacak işlem, her ayrıntılı raporun type
ayarına bağlıdır. Ayrıntılar için ayrıntılı rapor referansını inceleyin. Örneğin:
pending-destination-limit
gizlilik korumasıdır. Bu durumda herhangi bir işlem yapmanız gerekmez. Bu numarayı veri noktası olarak kullanarak kendi görünürlüğünüz ve izleme işlemleriniz için kullanabilirsiniz.trigger-aggregate-no-contributions
, sizin tarafınızda bir uygulama sorununun işareti olabilir. Bunu daha ayrıntılı bir şekilde analiz edin. Sorunu gidermek ve gerekirse bunu düzeltmek için ayrıntılı raporun gövdesindeki ayrıntıları kullanın.unknown-error
, bir tarayıcı hatasının veya ağ hatasının işareti olabilir. Bu sorunla tekrar tekrar karşılaşıyorsanız tarayıcı geliştiricileri için hata bildiriminde bulunun.