Bu sayfa, Cloud Translation API ile çevrilmiştir.

İlişkilendirme Raporlarında hata ayıklamayla ilgili çözüm kitabı

İ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

The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

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 type alanına bakın.
- type değeri source-success ise: 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.
- type değeri başka bir şeyse: Kaynak veya tetikleyici kaydedilmemiştir. type nedenini açıklar. İlgili ilişkilendirme raporu (ve başarı hata ayıklama raporu) eksik olur. Ayrıntılı hata ayıklama raporunun type değ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.

Not: Ayrıntılı bir raporun type değeri trigger-event ile başlıyorsa yalnızca etkinlik düzeyindeki raporlarla ilişkili kaynak veya tetikleyici etkinlikler için oluşturulabilir. Ayrıntılı bir raporun type değeri trigger-aggregate ile başlıyorsa yalnızca toplanabilir raporlarla ilişkili kaynak veya tetikleyici etkinlikler için oluşturulabilir. Diğer tüm durumlarda, etkinlik düzeyinde veya toplanabilir bir rapor içindir.

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.

Not: Çerez tabanlı bir dönüşümle eşlenmeyen etkinlik düzeyinde ilişkilendirme raporlarınız olabilir. Bunlar büyük olasılıkla API tarafından rastgele oluşturulan gürültülü raporlardır. Bu durumu, etkinlik düzeyindeki raporunuzla aynı kaynak hata ayıklama anahtarına sahip source-noised türündeki ayrıntılı hata ayıklama raporlarını arayarak doğrulayabilirsiniz.

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 type alanını analiz edin. Örneğin, aşağıdakileri görebilirsiniz:
- pending destination limit nedeniyle 10 (örnekteki% 10) rapor eksik
- trigger-aggregate-no-contributions nedeniyle 5 (= %5) rapor eksik.
- unknown-error nedeniyle 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.