Okna raportów niestandardowych zapewniają szybsze generowanie raportów na poziomie zdarzenia oraz raporty selektywne na potrzeby raportów zbiorczych.
Za pomocą niestandardowych okien raportów Attribution Reporting (dostępnych w Chrome 110) możesz poinstruować przeglądarkę, aby odfiltrowywała konwersje, które mają miejsce w określonym przedziale czasu.
- W przypadku raportów na poziomie zdarzenia okna raportu umożliwiają szybsze generowanie raportów, a także odfiltrowują konwersje, które mają miejsce w określonym przedziale czasu. W zależności od Twojego celu można to ująć inaczej: korzystanie z okien raportów zapewnia szybszy dostęp do raportów, ale może spowodować utratę części konwersji. Szczegółowe informacje znajdziesz w sekcji na poziomie zdarzenia.
- W przypadku raportów zbiorczych okna raportów umożliwiają filtrowanie konwersji, które mają miejsce w określonym przedziale czasu. Więcej informacji znajdziesz w sekcji poświęconej zbieraniu danych.
Co to jest okno raportu niestandardowego?
Okno raportu niestandardowego to okres po rejestracji źródła, w którym można tworzyć dla tego źródła raporty odpowiedniego typu (zdarzenia lub agregowane).
W przypadku raportów na poziomie zdarzenia okno raportu działa też jako ostatnie okno, w którym będą wysyłane raporty odpowiedniego typu.
Najważniejsze informacje o oknach raportowania:
- Jeśli nie jest ustawiona żadna wartość
report_window
, używana jest wartośćexpiry
. - Jeśli nie zostanie ustawiona wartość
expiry
, zostanie użyta wartość domyślna, która wynosi 30 dni. - Minimalne okno raportu niestandardowego to jeden dzień. Nawet jeśli ustawisz okres krótszy niż dzień, wartość będzie ograniczona do dnia. Zapoznaj się z przykładami raportów na poziomie zdarzenia.
- Okno raportu jest definiowane w sekundach.
Pamiętaj, że sposób działania expiry
się nie zmienił. expiry
zmienia wyświetlenia i kliknięcia kwalifikujące się do atrybucji.
Raporty na poziomie zdarzenia: szybsze raportowanie i raportowanie selektywne
Domyślnie raporty na poziomie zdarzenia są wysyłane zgodnie z harmonogramem wbudowanych okien raportów: 3 okna na kliknięcia i 1 okna wyświetleń.
W przypadku raportów na poziomie zdarzenia okna raportów niestandardowych umożliwiają:
- Szybsze otrzymywanie raportów. Okna raportów niestandardowych umożliwiają m.in. otrzymywanie raportów 1 dzień po kliknięciu lub wyświetleniu i nie obowiązuje już 2-dniowy limit nałożony przed Chrome 110 przez wbudowane okna ważności.
- Odfiltrowują konwersje zrealizowane w określonym przedziale czasu.
Aby używać okien raportów w raportach na poziomie zdarzenia, dodaj pole event_report_window
do nagłówka rejestracji źródłowej w Attribution-Reporting-Register-Source
.
event_report_window
Raporty na poziomie zdarzenia są wysyłane najpóźniej po upływie okna raportowania.
Harmonogram generowania raportów na poziomie zdarzenia (kliknięcia)
wygaśnięcie | event_report_window |
Jeśli konwersja zachodzi dzień po kliknięciu, przeglądarka wysyła raport: | Raporty odfiltrowane (niewysłane) dla konwersji mających miejsce: |
---|---|---|---|
Domyślnie (30 dni) | (nie ustawiono) | Około 2 dni i 1 godzina po kliknięciu Domyślny sposób raportowania – wbudowane okno 1 |
Około 30 dni po kliknięciu |
Niestandardowa, ustawiona na 5 dni | (nie ustawiono) | Około 2 dni i 1 godzina po kliknięciu Domyślny sposób raportowania – wbudowane okno 1 |
Więcej niż 5 dni po kliknięciu |
Domyślnie (30 dni) | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po kliknięciu Zachowanie niestandardowe związane z niestandardowym oknem raportu. Zwróć uwagę, że dzięki temu raport możesz wygenerować szybciej niż w pierwszym wierszu, gdzie trzeba poczekać na pierwsze wbudowane okno (2 dni). |
Więcej niż 1 dzień po kliknięciu |
Niestandardowa, ustawiona na 5 dni | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po kliknięciu Zachowanie niestandardowe związane z niestandardowym oknem raportu |
Więcej niż 1 dzień po kliknięciu |
Domyślnie (30 dni) | Ustaw na 4 godziny | Około 1 dnia i 1 godziny po kliknięciu Zachowanie niestandardowe związane z niestandardowym oknem raportu. Wynika to z ograniczenia: minimalne okno raportu to 1 dzień. Nawet jeśli ustawisz okno raportu na krócej niż jeden dzień, np. 4 godziny, jego wartość zostanie ograniczona do dnia. |
Ponad 1 dzień po kliknięciu |
Przykłady harmonogramu raportów na poziomie zdarzenia i widoków danych
wygaśnięcie | event_report_window | Jeśli konwersja zachodzi dzień po kliknięciu, przeglądarka wysyła raport: |
---|---|---|
Domyślnie (30 dni) | (nie ustawiono) | Około 30 dni i 1 godzina po wyświetleniu Domyślne zachowanie w raportach |
Niestandardowa, ustawiona na 5 dni | (nie ustawiono) | Około 5 dni i 1 godzina po wyświetleniu Domyślne zachowanie w raportach |
Domyślnie (30 dni) | Ustaw na 1 dzień | Ok. 1 dnia i 1 godziny po wyświetleniu Zachowanie niestandardowe związane z niestandardowym oknem raportu |
Niestandardowa, ustawiona na 5 dni | Ustaw na 1 dzień | Ok. 1 dnia i 1 godziny po wyświetleniu Zachowanie niestandardowe związane z niestandardowym oknem raportu |
Raporty agregujące: raporty selektywne
W przypadku raportów zbiorczych funkcja okna raportowania pozwala odfiltrowywać tylko konwersje zrealizowane w określonym przedziale czasu. Szybsze uzyskiwanie raportów nie daje żadnych korzyści.
Aby używać okien raportów na potrzeby raportów zbiorczych, dodaj to pole do nagłówka rejestracji źródła w Attribution-Reporting-Register-Source
:
aggregatable_report_window
Pozwoli to odfiltrować konwersje zrealizowane w określonym przedziale czasu.
Raporty zbiorcze są wysyłane w ciągu godziny od włączenia reguły, ale są losowo opóźnione od 10 minut do godziny.
wygaśnięcie | aggregatable_report_window |
Raporty odfiltrowane (niewysłane) dla konwersji mających miejsce: |
---|---|---|
Domyślnie (30 dni) | (nie ustawiono) | Ponad 30 dni po kliknięciu lub wyświetleniu |
Niestandardowa, ustawiona na 5 dni | (nie ustawiono) | Więcej niż 5 dni po kliknięciu lub wyświetleniu |
Domyślnie (30 dni) | Ustaw na 1 dzień | Więcej niż 1 dzień po kliknięciu lub wyświetleniu |
Niestandardowa, ustawiona na 5 dni | Ustaw na 1 dzień | Więcej niż 1 dzień po kliknięciu lub wyświetleniu |
Domyślnie (30 dni) | Ustaw na 4 godziny | Ponad 1 dzień po kliknięciu lub wyświetleniu Wynika to z ograniczenia: minimalne okno raportu to 1 dzień. Nawet jeśli ustawisz okno raportu na krócej niż jeden dzień, np. 4 godziny, jego wartość zostanie ograniczona do dnia. |
Angażuj i dziel się opiniami
Możesz uczestniczyć w korzystaniu z tego interfejsu API i eksperymentować z nim.
- Poczytaj o raportach zbiorczych i usłudze agregacji, zadawaj pytania i zaproponuj swoją opinię.
- Przeczytaj przewodniki po raportowaniu atrybucji.
- Zadawaj pytania i dołączaj do dyskusji w repozytorium pomocy dla deweloperów Piaskownicy prywatności.