Ta strona została przetłumaczona przez Cloud Translation API.

Książka kucharska na temat debugowania raportów atrybucji

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 nagłówki źródła i regułę raportowania atrybucji. Wszystkie raporty generowane przez przeglądarkę są wysyłane do tego źródła. W tym przewodniku jako przykładowego źródła raportowania używamy https://adtech.example.
Raport atrybucji (w skrócie raport) to raport końcowy (na poziomie zdarzenia lub z możliwością zagregowania), który zawiera żądane dane pomiarowe.
Raport debugowania zawiera dodatkowe dane o raporcie atrybucji albo o źródle lub zdarzeniu reguły. Otrzymanie raportu debugowania nie musi oznaczać, że coś działa nieprawidłowo. Są 2 typy raportów debugowania.
Przejściowy raport debugowania to raport debugowania, który do wygenerowania i przesłania pliku cookie wymaga ustawienia pliku cookie. Przejściowe raporty debugowania będą niedostępne, jeśli nie ustawisz pliku cookie lub gdy pliki cookie innych firm zostaną wycofane z użytku. Wszystkie raporty debugowania opisane w tym przewodniku to przejściowe raporty debugowania.
Raporty debugowania powodzenia zawierają informacje o udanych wygenerowaniu raportu atrybucji. Są one bezpośrednio związane z raportem atrybucji. Raporty debugowania sukcesu są dostępne od wersji Chrome 101 (kwiecień 2022 r.).
Wyczerpujące raporty debugowania pozwalają śledzić brakujące raporty i pomagać w określeniu przyczyn ich braku. Odsyłają one też sytuacje, w których przeglądarka nie zarejestrowała źródła ani zdarzenia aktywującego (co oznacza, że nie wygeneruje raportu atrybucji), oraz sytuacje, w których z jakiegoś powodu nie można wygenerować lub wysłać raportu atrybucji. Pełne raporty debugowania zawierają pole type, które podaje przyczynę, dla której nie wygenerowano zdarzenia źródłowego, zdarzenia reguły lub raportu atrybucji. Pełne raporty debugowania są dostępne od wersji Chrome 109 (wersja stabilna w styczniu 2023 r.).
Klucze debugowania to unikalne identyfikatory, które można ustawić zarówno po stronie źródła, jak i po stronie wyzwalacza. Klucze debugowania umożliwiają mapowanie konwersji opartych na plikach cookie i atrybucji. Gdy skonfigurujesz w systemie generowanie raportów debugowania i ustawisz klucze 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

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 to source-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ści type 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.

Uwaga: jeśli w szczegółowym raporcie wartość type zaczyna się od trigger-event, można go wygenerować tylko w przypadku zdarzeń źródła lub reguły powiązanych z raportami na poziomie zdarzenia. Jeśli parametr type w szczegółowym raporcie zaczyna się od trigger-aggregate, można go wygenerować tylko w przypadku zdarzeń źródła lub reguły powiązanych z raportami zbiorczymi. W pozostałych przypadkach dotyczą one raportów na poziomie zdarzenia lub raportów zbiorczych.

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.

Uwaga: możliwe, że masz raporty atrybucji na poziomie zdarzenia, które nie są zmapowane na konwersje oparte na plikach cookie. Są to najprawdopodobniej niejasne raporty generowane losowo przez interfejs API. Możesz to sprawdzić, wyszukując szczegółowe raporty na temat debugowania typu source-noised, które mają ten sam klucz debugowania źródła co raport na poziomie zdarzenia.

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%).

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.