Część 3 z 3 poświęcona debugowaniu raportów atrybucji. Dowiedz się, jak korzystać z raportów debugowania.
Znajdziesz w niej instrukcje korzystania z raportów debugowania w różnych sytuacjach opisanych w części 1. Wprowadzenie do raportów debugowania.
Glosariusz
- Źródło raportowania to źródło, które ustawia źródło i aktywator funkcji Attribution Reporting.
Wszystkie raporty generowane przez przeglądarkę są wysyłane do tego źródła. W tych wskazówkach jako przykładowego źródła zgłoszenia używamy
https://adtech.example
. - Raport atrybucji (w skrócie raport) to raport końcowy (na poziomie zdarzenia lub agregowany) zawierający żądane dane pomiarowe.
- Raport debugowania zawiera dodatkowe dane o raporcie atrybucji albo o źródle lub zdarzeniu reguły. Otrzymanie raportu na temat debugowania nie musi oznaczać, że coś działa nieprawidłowo. Istnieją 2 typy raportów debugowania.
- Przejściowy raport debugowania to raport debugowania, który wymaga skonfigurowania pliku cookie w celu wygenerowania i wysłania. Jeśli plik cookie nie zostanie skonfigurowany i po wycofaniu plików cookie innych firm, raporty dotyczące debugowania przejściowych będą niedostępne. Wszystkie raporty na temat debugowania opisane w tym przewodniku to raporty na temat debugowania.
- Raporty na temat pomyślnego debugowania pozwalają śledzić udane wygenerowanie raportu atrybucji. Mają bezpośredni związek z raportem atrybucji. Raporty o udanym debugowaniu są dostępne od wersji Chrome 101 (kwiecień 2022 r.).
- Szczegółowe raporty debugowania pozwalają śledzić brakujące raporty i ustalać, dlaczego ich brakuje. Wskazują przypadki, w których przeglądarka nie zarejestrowała zdarzenia źródła ani nie wywołała tego zdarzenia (co oznacza, że nie generuje raportu atrybucji), oraz przypadki, gdy z jakiegoś powodu nie można wygenerować lub wysłać raportu atrybucji.
Szczegółowe raporty debugowania zawierają pole
type
, które podaje powód, dla którego zdarzenie źródłowe, zdarzenie reguły lub raport atrybucji nie zostały wygenerowane. Szczegółowe raporty dotyczące debugowania są dostępne w Chrome od wersji 109 (stabilnej wersji od stycznia 2023 r.). - Klucze debugowania to unikalne identyfikatory, które możesz ustawić zarówno po stronie źródła, jak i po stronie reguły. Klucze debugowania umożliwiają mapowanie konwersji opartych na plikach cookie i atrybucji. Gdy skonfigurujesz system do generowania raportów debugowania i ustawiania kluczy debugowania, przeglądarka będzie uwzględniać te klucze debugowania we wszystkich raportach atrybucji i raportach debugowania.
Więcej pojęć i kluczowych terminów używanych w naszej dokumentacji znajdziesz w słowniczku Piaskownicy prywatności.
Jak to zrobić: sprawdzanie integracji w czasie rzeczywistym
- Skonfiguruj system pod kątem generowania raportów debugowania powodzenia. Więcej informacji znajdziesz w sekcji Część 2. Konfigurowanie raportów debugowania.
- Po wdrożeniu kodu Attribution Reporting sprawdź w czasie rzeczywistym, czy otrzymujesz w punkcie końcowym raporty debugowania zakończone powodzeniem. Jeśli tak, oznacza to, że Twoja konfiguracja raportów atrybucji działa.
- Raporty debugowania o sukcesie są wysyłane tylko wtedy, gdy dojdzie do konwersji. Zamiast tego warto sprawdzić, czy integracja jest prawidłowo skonfigurowana niezależnie od konwersji, czyli czy źródła zostały prawidłowo zarejestrowane. Aby to osiągnąć, możesz polegać na skutecznej rejestracji źródła i szczegółowych raportach debugowania. Instrukcje ich konfigurowania znajdziesz w części 2. Konfigurowanie raportów debugowania.
Instrukcje: analizowanie strat i rozwiązywanie problemów z integracją
Aby porównać wyniki pomiaru konwersji na podstawie plików cookie z raportami funkcji Attribution Reporting, użyj kluczy debugowania i mapuj konwersje z plików cookie, korzystając z raportów debugowania. Pamiętaj, że raporty debugowania są wysyłane natychmiast do punktu końcowego.
Przegląd
![Etapy analizy strat](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=9&hl=pl)
Użyj kluczy debugowania (para <source_debug_key, trigger_debug_key>
), aby zmapować konwersje z plików cookie na raporty debugowania.
Czy w przypadku każdej konwersji pliku cookie w momencie konwersji otrzymałeś(-aś) odpowiedni raport debugowania o powodzeniu?
Jeśli tak: w przypadku wszystkich tych raportów debugowania dotyczących powodzenia możesz się spodziewać raportu atrybucji później – z kilkoma wyjątkami. Szczegółowe informacje znajdziesz w scenariuszu raportowania debugowania powodzenia.
Jeśli nie: oznacza to, że konwersja nie została zarejestrowana w Attribution Reporting. Użyj pary <source_debug_key, trigger_debug_key>
(lub źródłowego klucza debugowania, jeśli brakuje klucza debugowania aktywatora), aby zmapować konwersje z plików cookie na szczegółowe raporty debugowania. Czy w przypadku każdej z tych konwersji udało Ci się w którymś momencie otrzymać odpowiedni szczegółowy raport debugowania (czas źródła lub aktywatora)?
Jeśli nie dotarł do Ciebie szczegółowy raport na temat debugowania, może to być spowodowane zachowaniem użytkownika lub problemem z integracją. Szczegółowe informacje znajdziesz w scenariuszu dotyczącym raportu bez debugowania.
Jeśli otrzymasz szczegółowy raport z debugowania, zajrzyj do jego pola
type
.Jeśli
type
tosource-success
, oznacza to, że źródło zostało zarejestrowane, ale aktywator nie został zarejestrowany. Aby określić przyczynę, dla której nie widzisz raportu dotyczącego debugowania zakończonego powodzeniem, poszukaj odpowiedniego szczegółowego raportu debugowania innego typu ⏤ będzie on w stanie wskazać problem po stronie reguły.Jeśli
type
to cokolwiek innego, oznacza to, że źródło lub aktywator nie zostały zarejestrowane.type
dowiesz się, dlaczego. Brakuje odpowiedniego raportu atrybucji (i raportu dotyczącego debugowania sukcesu). W zależności od wartościtype
szczegółowego raportu debugowania możesz potraktować te informacje jako punkt danych analizy strat (czyli nie musisz nic robić) albo zgłosić błąd albo rozwiązać problem z implementacją. Aby dowiedzieć się więcej, zapoznaj się ze scenariuszem generowania szczegółowego raportu na temat debugowania.
Możliwe scenariusze
Raport debugowania zakończony powodzeniem
Jeśli w przypadku danej konwersji pliku cookie otrzymasz raport debugowania z powodu powodzenia, oznacza to, że została ona zarejestrowana w Attribution Reporting.
Raport atrybucji dotyczący tej konwersji możesz się spodziewać później⏤ z kilkoma wyjątkami:
- Zachowanie użytkowników: czyszczenie danych po konwersji i przed wysłaniem raportu atrybucji, zamknięcie przeglądarki itp. Jeśli użytkownik zamknie przeglądarkę po konwersji i nie otworzy jej przez tydzień, raport nie zostanie wysłany przez co najmniej tydzień. Możesz potraktować to opóźnienie jako stratę.
- Dotyczy tylko zdarzeń na poziomie zdarzenia: raport na poziomie zdarzenia jest zastępowany innym raportem o wyższym priorytecie.
- Możliwe problemy z siecią.
Szczegółowy raport debugowania typu source-success
Jeśli w przypadku źródła danej konwersji pliku cookie otrzymasz szczegółowy raport debugowania typu source-success
, oznacza to, że rejestracja źródła się powiodła. W zależności od tego, czy rejestracja reguły też się powiedzie, możesz otrzymać raport o tej konwersji.
Jest jedno zastrzeżenie:
Szczegółowy raport debugowania dowolnego innego typu
Jeśli w przypadku danej konwersji pliku cookie otrzymasz szczegółowy raport debugowania innego typu, nie otrzymasz raportu debugowania o pomyślnym działaniu, a dlatego później nie otrzymasz raportu atrybucji ⏤, ponieważ szczegółowy raport oznacza, że w raporcie wystąpił błąd. Coś uniemożliwiło rejestrację źródła, rejestrację aktywatora, wygenerowanie raportu lub wysłanie raportu. Możliwe przyczyny:
- Ograniczenia prywatności
- Limity miejsca na dane
- Reguły niestandardowe
- Problem z implementacją w kodzie
- Błąd przeglądarki
Niektóre z nich są zgodne z oczekiwaniami. Działanie, które należy wykonać, zależy od type
każdego szczegółowego raportu. Zapoznaj się z dokumentacją raportów szczegółowych.
Brak raportów debugowania
Jeśli w przypadku danej konwersji pliku cookie otrzymasz tylko raport atrybucji (brak raportu debugowania z powodzeniem ani szczegółowy raport debugowania), oznacza to, że coś uniemożliwiło wygenerowanie tych raportów. Możliwe przyczyny:
- Ustawienia użytkownika (użytkownik wyłączył pliki cookie innych firm)
- Brak pliku cookie lub klucze debugowania (klucz debugowania wyczyszczono z powodu braku pliku cookie). W narzędziu
chrome://attribution-internals
otwórz kartę Logi i sprawdź, czy wykryto tam jakiś problem. - Problemy z siecią, które wystąpiły w czasie źródła lub reguły, ale nie podczas wysyłania raportu atrybucji.
Czy otrzymujesz raporty atrybucji?
To podprzypadek braku raportu z debugowania: jeśli w przypadku danej konwersji pliku cookie nie przyszły żadne raporty (żadny raport debugowania lub raport atrybucji), oznacza to, że wystąpiła niemożliwy do zgłoszenia błąd. Możliwe przyczyny:
- Podstawowy problem z integracją. Dowiedz się, jak je rozwiązać w artykule Rozwiązywanie podstawowych problemów z integracją.
- Możliwe problemy z siecią.
- ustawienia użytkownika w ustawieniach przeglądarki, na przykład w Piaskownicy prywatności wyłączona;
Szczegółowe informacje o raportach debugowania
Każdy szczegółowy raport debugowania zawiera pole type
, które podaje przyczynę pominięcia danego raportu atrybucji. Skorzystaj z niego, aby ustalić, co zrobić w przypadku każdego type
szczegółowego raportu.
Rejestracja źródła zakończona powodzeniem
Źródło zostało zarejestrowane.
source-success
- Szczegóły i treść raportu
Raporty o ograniczeniach ochrony prywatności
Te raporty są oczekiwane. Wskazują ograniczenia dotyczące prywatności, aby ograniczyć wyciek tożsamości użytkowników między witrynami.
source-destination-limit
- Szczegóły i treść raportu
source-noised
- Szczegóły i treść raportu
trigger-attributions-per-source-destination-limit
- Szczegóły i treść raportu
trigger-reporting-origin-limit
- Szczegóły i treść raportu
trigger-event-noise
- Szczegóły i treść raportu
trigger-event-excessive-reports
- Ta strategia jest generowana, jeśli liczba raportów przekracza limit. Możesz zarejestrować maksymalnie jedną konwersję z wyświetleń i trzy z kliknięć. Pamiętaj, że możesz określić, jakie raporty chcesz otrzymywać, ustawiając priorytety. Szczegóły i treść raportu
Raporty o ograniczeniach miejsca na dane
Te raporty są oczekiwane. Wskazują ograniczenia miejsca na dane, aby zapobiec nadmiernemu wykorzystaniu zasobów.
source-storage-limit
- Szczegóły i treść raportu
trigger-event-storage-limit
- Szczegóły i treść raportu
trigger-aggregate-storage-limit
- Szczegóły i treść raportu
Raporty o regułach niestandardowych
Te raporty są oczekiwane, jeśli używasz filtrowania, usuwania duplikatów, priorytetów lub filtrowania wg okna. Na wszelki wypadek dokładnie sprawdź odpowiednie reguły niestandardowe, aby upewnić się, że raport powiązany z tym szczegółowym raportem rzeczywiście jest raportem, który chcesz odrzucić. Jeśli wszystko się zgadza, nie musisz nic robić.
trigger-no-matching-filter-data
- Szczegóły i treść raportu
trigger-event-no-matching-configuration
- Szczegóły i treść raportu
trigger-event-deduplicated
- Szczegóły i treść raportu
trigger-aggregate-deduplicated
- Szczegóły i treść raportu
trigger-event-low-priority
- Szczegóły i treść raportu
trigger-event-report-window-passed
- Szczegóły i treść raportu
trigger-aggregate-report-window-passed
- Szczegóły i treść raportu
Inne szczegółowe raporty
Raporty te mogą wskazywać na potencjalne problemy z implementacją kodu.
trigger-no-matching-source
- Może to być problem z implementacją. Sprawdź, czy konfiguracja
<reporting origin, destination>
nie zawiera błędów. Może to być też normalne działanie interfejsu API. Na przykład użytkownik wyczyścił dane po interakcji z reklamą, a przed konwersją, lub dokonał konwersji, ale nie zobaczył powiązanej reklamy. Szczegóły i treść raportu trigger-aggregate-no-contributions
- Prawdopodobnie nie powinno to być działanie zgodne z Twoimi oczekiwaniami. Rozwiąż problemy z kodem rejestracji aktywatora. Upewnij się, że konfiguracja darowizn jest prawidłowa. Szczegóły i treść raportu
trigger-aggregate-insufficient-budget
- Prawdopodobnie nie powinno to być działanie zgodne z Twoimi oczekiwaniami. Dokładnie sprawdź kod rejestracji reguły, aby upewnić się, że suma wszystkich darowizn nie przekracza budżetu darowizn. Szczegóły i treść raportu
Nieoczekiwane błędy (potencjalne błędy przeglądarki)
Te raporty są nieoczekiwane. Przyczyną może być błąd przeglądarki. Zgłoś błąd i w opisie podaj czynności prowadzące do jego odtworzenia.
source-unknown-error
- Szczegóły i treść raportu
trigger-unknown-error
- Szczegóły i treść raportu
Analiza strat – przykład
Krok 1. Konfiguracja i mapowanie za pomocą plików cookie
Wykonaj instrukcje podane w części 2. Konfigurowanie raportów debugowania, aby skonfigurować generowanie w systemie raportów debugowania zakończonych powodzeniem i wyczerpujących raportów debugowania.
Dzięki temu możesz korzystać z informacji o konwersjach na podstawie plików cookie, aby wyszukiwać odpowiednie raporty debugowania lub atrybucji.
Krok 2. Zidentyfikuj udane rejestracje i brakujące raporty
W tym przykładzie załóżmy, że udało Ci się śledzić 100 konwersji za pomocą systemu opartego na plikach cookie.
Za każdym razem, gdy rejestrujesz konwersję na podstawie plików cookie, poszukaj raportu debugowania o powodzeniem (wysłanego natychmiast), który zawiera tę samą parę <source_debug_key, trigger_debug_key>
co ta konwersja oparta na plikach cookie.
Załóżmy, że dotarł do Ciebie raport debugowania dotyczący 70 konwersji z tych plików cookie.
- Raporty o sukcesie oznaczają, że atrybucja została zarejestrowana, więc możesz spokojnie założyć, że otrzymasz raport odpowiadający poszczególnym raportom – z pewnymi wyjątkami.
- Możesz zdecydować się na monitorowanie tych wyjątków. W tym celu raporty atrybucji są wysyłane do punktu końcowego w ciągu najbliższych dni lub tygodni (w zależności od wygaśnięcia). W tym celu poszukaj raportów atrybucji, które zawierają tę samą parę kluczy debugowania co każdy raport debugowania o powodzeniem. Zaczekaj chwilę: raporty mogą nie być wysyłane od razu pod koniec każdego okresu. Załóżmy, że masz tylko 60 raportów atrybucji. Brak 10 raportów atrybucji może wynikać z zachowań użytkowników.
Krok 3: krótka ocena straty
100–70 = brakuje 30 raportów debugowania zakończonych powodzeniem. Oznacza to, że te 30 konwersji (śledzonych w ramach implementacji opartej na plikach cookie) nie zostało zarejestrowane w funkcji Attribution Reporting. Nie będziesz wtedy otrzymywać raportów atrybucji.
Masz 100 konwersji opartych na plikach cookie i tylko 70 konwersji opartych na atrybucji, więc strata wynosi 30%. Masz teraz krótką ocenę straty.
Krok 4. Przeanalizuj przyczyny
Aby dowiedzieć się, dlaczego brakuje tych raportów, poszukaj odpowiadających im szczegółowych raportów debugowania, które zostały odebrane w momencie konwersji (rejestracji reguły) lub wcześniej w momencie rejestracji źródła. Użyj kluczy konwersji opartych na plikach cookie, aby zmapować je na szczegółowe raporty debugowania.
- Załóżmy, że istnieje 10 kluczy, dla których nie istnieje szczegółowy raport debugowania. Sprawdź, czy nie wystąpił problem z integracją. Jeśli nie, może to być spowodowane zachowaniem użytkowników.
- Masz do dyspozycji 20 szczegółowych raportów debugowania. Możesz teraz doprecyzować analizę strat. Przeanalizuj pole
type
każdego szczegółowego raportu. Możesz na przykład dowiedzieć się, że:- Brak 10 raportów (w naszym przykładzie to 10%) z powodu błędu
pending destination limit
- Przyczyna:
trigger-aggregate-no-contributions
brakuje 5 raportów (= 5%). - Przyczyna:
unknown-error
brakuje 5 raportów (= 5%).
- Brak 10 raportów (w naszym przykładzie to 10%) z powodu błędu
Krok 5. Podejmij działanie i rozwiąż problemy
Wiesz już, dlaczego brakuje raportów, więc możesz zacząć działać na ich podstawie.
Działanie, które należy wykonać, zależy od type
każdego szczegółowego raportu. Szczegółowe informacje o raportach znajdziesz w szczegółowych informacjach. Na przykład:
pending-destination-limit
to ochrona prywatności. Nie musisz nic robić. Użyj tej liczby jako punktu danych do własnych celów związanych z widocznością i monitorowaniem.- Oznaczenie
trigger-aggregate-no-contributions
może być oznaką problemu z implementacją po Twojej stronie. Przeanalizuj dokładniej ten proces. Aby rozwiązać ten problem, w razie potrzeby skorzystaj ze szczegółów w treści raportu. unknown-error
może oznaczać błąd przeglądarki lub sieci. Jeśli ten błąd będzie się powtarzał, zgłoś błąd dla programistów przeglądarek.