Część 1 z 3 dotycząca debugowania raportowania atrybucji. Dowiedz się, dlaczego debugowanie jest ważne i kiedy warto używać raportów na potrzeby testów.
Dlaczego potrzebujesz raportów na temat debugowania
Jeśli testujesz interfejs Attribution Reporting API, należy sprawdzić, czy integracja działa poprawnie, poznać luki w wynikach pomiarów z implementacją opartą na plikach cookie i wdrożeniem Attribution Reporting, a także w rozwiązywaniu wszelkich problemów z integracją.
Do wykonania tych zadań wymagane są raporty na temat debugowania. Dlatego zdecydowanie zalecamy ich skonfigurowanie.
Słowniczek
Najważniejsze aspekty raportów debugowania
2 typy raportów debugowania
Dostępne są 2 rodzaje raportów na temat debugowania. Używaj ich, ponieważ sprawdzają się w różnych przypadkach.
Raporty o pomyślnym debugowaniu
Raporty na temat pomyślnego debugowania pozwalają śledzić udane wygenerowanie raportu atrybucji. Mają związek bezpośrednio do raportu atrybucji.
Raporty o powodzeniu debugowania są dostępne od wersji Chrome 101 (kwiecień 2022 r.).
Szczegółowe raporty na temat debugowania
Wyczerpujące raporty na temat debugowania zapewniają lepszy wgląd w zdarzenia źródłowe i wyzwalacze, dzięki czemu możesz sprawdzić, czy źródła zostały zarejestrowane, lub śledzić brakujące raporty i ustalać, dlaczego ich brakuje (niepowodzenie w zdarzeniach źródłowych lub aktywatorów czy niepowodzenia podczas wysyłania lub generowania raportu). Szczegółowe informacje o debugowaniu:
- Przypadki, w których przeglądarka zarejestrowała źródło.
- Przypadki, w których przeglądarka nie zarejestrowała źródła ani nie wywołała zdarzenia, co oznacza, że nie generuje raportu atrybucji.
- Sytuacje, w których z jakiegoś powodu nie można wygenerować ani wysłać raportu atrybucji.
Szczegółowe raporty debugowania zawierają pole type, które opisuje pomyślną rejestrację źródła lub przyczynę, dla której nie utworzono źródła, reguły bądź raportu atrybucji.
Szczegółowe raporty debugowania są dostępne od Chrome 109 (styczeń 2023 r.) z wyjątkiem szczegółowych raportów debugowania o pomyślnej rejestracji źródła, które zostały dodane później w Chrome 112.
Zobacz przykładowe raporty w części Część 2. Konfigurowanie raportów debugowania.
Raporty debugowania są oparte na plikach cookie
Aby można było korzystać z raportów na temat debugowania, źródło raportowania musi ustawić plik cookie.
Jeśli źródło skonfigurowane na potrzeby raportów należy do innej firmy, tym plikiem cookie będzie . Ma to kilka ważnych konsekwencji:
- Raporty debugowania są generowane tylko wtedy, gdy pliki cookie innych firm są dozwolone w przeglądarce użytkownika.
- Raporty debugowania nie będą już dostępne po wycofaniu plików cookie innych firm zostały wycofane.
Raporty o debugowaniu są wysyłane natychmiast
Raporty o debugowaniu są natychmiast wysyłane przez przeglądarkę do źródła raportowania. Ten różni się od raportów atrybucji, które są wysyłane razem z opóźnienia.
Raporty o pomyślnym debugowaniu są generowane i wysyłane, gdy tylko jest generowany odpowiedni raport atrybucji: rejestracji.
Szczegółowe raporty na temat debugowania są wysyłane bezpośrednio po źródle lub aktywatorze. rejestracji.
Raporty debugowania mają różne ścieżki punktów końcowych
Tak jak w przypadku raportów atrybucji, wszystkie raporty o debugowaniu są wysyłane do źródła raportowania. Raporty o debugowaniu są wysyłane do 3 osobnych punktów końcowych źródła raportowania:
- Punkt końcowy dla raportów debugowania o sukcesie na poziomie zdarzenia
- Punkt końcowy dla raportów debugowania o sukcesie (możliwy do agregacji)
- Punkt końcowy na potrzeby wyczerpujących raportów debugowania, na poziomie zdarzenia i z możliwością agregacji.
Więcej informacji znajdziesz w części Część 2. Konfigurowanie raportów na temat debugowania.
Przypadki użycia
Podstawowe sprawdzanie integracji w czasie rzeczywistym
W przeciwieństwie do raportów atrybucji raporty o debugowaniu są natychmiast wysyłane do punktu końcowego. które są opóźnione ze względu na ochronę prywatności użytkownika. Używaj raportów na temat debugowania jako sygnału w czasie rzeczywistym, że integracja z Interfejs Attribution Reporting API działa.
Aby dowiedzieć się, jak to zrobić, przeczytaj Część 3. Debugowanie w książce kucharskiej.
Analiza strat
W przeciwieństwie do plików cookie innych firm funkcja Attribution Reporting Interfejs API zapewnia wbudowaną ochronę prywatności które pozwalają znaleźć równowagę między przydatnością danych i prywatnością. Oznacza to, że interfejs Attribution Reporting API może nie być aby móc gromadzić wszystkie dane pomiarowe, które gromadzisz obecnie plików cookie. Nie wszystkie konwersje, które możesz za pomocą plików cookie innych firm wygeneruje raport atrybucji.
Przykład: w przypadku raportów na poziomie zdarzenia można zarejestrować maksymalnie jedną konwersję za wyświetlenie. Oznacza to, że w przypadku danego wyświetlenia reklamy otrzymasz tylko 1 raport atrybucji, niezależnie od tego, ile razy użytkownik dokona konwersji.
Raporty na temat debugowania pozwalają poznać różnice między z wykorzystaniem plików cookie i za pomocą narzędzia Atrybucja Interfejs API do raportowania. Określ, które konwersje są raportowane i ile konwersji które nie zostały zgłoszone, a które z nich i dlaczego.
Informacje o tym, jak przeprowadzić analizę strat, znajdziesz w części Część 3. Debugowanie książki kucharskiej.
Rozwiązywanie problemów
Chociaż straty spowodowane przez ochronę prywatności lub zasobów są spodziewane, inne straty może być niezamierzone. Błędy w konfiguracji lub błędy w implementacji może powodować utratę raportów.
Raporty na temat debugowania mogą służyć do wykrywania i rozwiązywania problemów z implementacją lub zgłosić potencjalny błąd zespołom przeglądarek. Aby dowiedzieć się, jak to zrobić, zobacz Część 3. Debugowanie książki kucharskiej
Zaawansowane sprawdzanie konfiguracji
Niektóre funkcje Attribution Reporting API umożliwiają dostosowanie zachowań. Mogą to być na przykład reguły filtrowania, deduplikacji i priorytetu.
Korzystając z tych funkcji, korzystaj z raportów na temat debugowania, aby sprawdzać, czy Twoje działanie logiczne prowadzi do zamierzonego działania produkcji, bez oczekiwania na raporty atrybucji. Aby dowiedzieć się, jak to zrobić, przeczytaj Część 3. Debugowanie w książce kucharskiej.
Testy lokalne z raportami agregowanymi
W przeciwieństwie do agregowanych raportów atrybucji, które są zaszyfrowane, raporty o debugowaniu można zagregować obejmują niezaszyfrowany ładunek.
używać agregowanych raportów debugowania do weryfikowania treści agregowanych raportów; oraz generować raporty podsumowujące do celów testowych za pomocą lokalnego narzędzia do agregacji.
Ponowne przetwarzanie raportów usługi agregacji
Inną zaletą korzystania z trybu debugowania jest możliwość ponownego przetwarzania raportów. Jeśli więc chcesz przetworzyć raporty więcej niż raz, musisz mieć włączone raporty na temat debugowania. Ponowne przetwarzanie raportów może być przydatne, jeśli:
- próbując zdebugować usługę agregacji.
- eksperymentując z różnymi strategiami grupowania.
- eksperymentując z różnymi wartościami ypsilon.
Odzyskiwanie danych
Specjaliści ds. technologii reklamowych powinni włączyć tryb debugowania, aby otrzymywać raporty o debugowaniu umożliwiające przywrócenie danych. Jest to przydatne w przypadku problemów z usługą agregacji, takich jak niedostępne lub niedostępne usługi, które mogą powodować błędy podczas generowania raportu podsumowującego.