Okna raportów niestandardowych mogą zapewniać szybsze raporty na poziomie zdarzenia i selektywne raportowanie w przypadku raportów, które można agregować.
Dzięki niestandardowym oknom raportów w interfejsie Attribution Reporting API (wprowadzonym w Chrome 110) możesz nakazać przeglądarce odfiltrowanie konwersji, które wystąpiły po upływie określonego czasu.
- W przypadku raportów na poziomie zdarzenia okna raportu umożliwiają szybsze uzyskiwanie raportów, a także odfiltrowywanie konwersji, które mają miejsce po upływie określonego czasu. W zależności od celu możesz też traktować to jako kompromis: korzystanie z okresów raportowania zapewnia szybszy dostęp do raportów, ale może oznaczać utratę niektórych konwersji. Więcej informacji znajdziesz w sekcji dotyczącej zdarzeń.
- W przypadku raportów zbiorczych okna raportu umożliwiają filtrowanie konwersji, które mają miejsce po określonym czasie. Więcej informacji znajdziesz w sekcji dotyczącej danych, które można agregować.
Czym jest okno raportu niestandardowego?
Okres raportowania niestandardowego to czas po zarejestrowaniu źródła, w którym można tworzyć raporty odpowiedniego typu (zdarzenia lub podlegające agregacji) dla tego źródła.
W przypadku raportów na poziomie zdarzenia okres raportu jest też ostatnim okresem, w którym będą wysyłane raporty danego typu.
Najważniejsze informacje o okresach raportowania:
- Jeśli nie ustawiono wartości
report_window, używana jest wartośćexpiry. - Jeśli nie ustawisz żadnej wartości
expiry, domyślnie zostanie użyta wartość 30 dni. - Minimalny okres raportu niestandardowego to 1 dzień. Nawet jeśli ustawisz okno krótsze niż dzień, wartość zostanie ograniczona do 1 dnia. Zapoznaj się z przykładami raportów na poziomie zdarzenia.
- Okno raportu jest zdefiniowane w sekundach.
Pamiętaj, że sposób działania expiry nie uległ zmianie. expiry zmienia tylko to, które wyświetlenia lub kliknięcia kwalifikują 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 raportu: 3 okna dla kliknięć i 1 okno dla wyświetleń.
W przypadku raportów na poziomie zdarzenia niestandardowe okna raportu umożliwiają:
- Szybsze otrzymywanie raportów. Okna raportów niestandardowych umożliwiają m.in. uzyskiwanie raportów dzień po kliknięciu lub wyświetleniu, a nie po 2 dniach, jak to było w przypadku wbudowanych okien ważności przed wprowadzeniem Chrome 110.
- Filtruj konwersje, które nastąpiły po określonym czasie.
Aby używać okresów raportowania w raportach na poziomie zdarzenia, dodaj pole event_report_window do nagłówka rejestracji źródła Attribution-Reporting-Register-Source.
Raporty na poziomie zdarzenia są wysyłane najpóźniej wkrótce po osiągnięciu okna raportu.
Przykłady harmonogramów raportów na poziomie zdarzenia i kliknięć
| wygaśnięcie, | event_report_window |
Jeśli konwersja nastąpi dzień po kliknięciu, przeglądarka wyśle raport: | Raporty odfiltrowane (nie wysłane) w przypadku konwersji: |
|---|---|---|---|
| Domyślny (30 dni) | (nie ustawiono) | Około 2 dni i 1 godziny po kliknięciu Domyślne działanie raportowania – wbudowane okno 1 |
Około 30 dni po kliknięciu |
| Niestandardowy, ustawiony na 5 dni | (nie ustawiono) | Około 2 dni i 1 godziny po kliknięciu Domyślne działanie raportowania – wbudowane okno 1 |
Ponad 5 dni po kliknięciu |
| Domyślny (30 dni) | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po kliknięciu Niestandardowe zachowanie wynikające z niestandardowego okresu raportowania. Zwróć uwagę, że w tym przypadku raport jest dostępny szybciej niż w pierwszym wierszu, gdzie musisz poczekać na pierwsze wbudowane okno (2 dni). |
Ponad 1 dzień po kliknięciu |
| Niestandardowy, ustawiony na 5 dni | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po kliknięciu Niestandardowe zachowanie wynikające z niestandardowego okresu raportu |
Ponad 1 dzień po kliknięciu |
| Domyślny (30 dni) | Ustaw na 4 godziny | Około 1 dnia i 1 godziny po kliknięciu Niestandardowe zachowanie wynikające z okna raportu niestandardowego. Wynika to z ograniczenia: minimalny okres raportowania to 1 dzień. Nawet jeśli ustawisz okres raportowania na mniej niż dzień, np. 4 godziny, jego wartość zostanie ograniczona do 1 dnia. |
Więcej niż 1 dzień po kliknięciu |
Przykłady harmonogramów raportów na poziomie zdarzenia i wyświetleń
| wygaśnięcie, | event_report_window |
Jeśli konwersja nastąpi dzień po kliknięciu, przeglądarka wyśle raport: |
|---|---|---|
| Domyślny (30 dni) | (nie ustawiono) | Około 30 dni i 1 godzina po wyświetleniu Domyślne zachowanie raportowania |
| Niestandardowy, ustawiony na 5 dni | (nie ustawiono) | Około 5 dni i 1 godzina po wyświetleniu Domyślne działanie raportowania |
| Domyślny (30 dni) | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po wyświetleniu Niestandardowe zachowanie wynikające z niestandardowego okna raportu |
| Niestandardowy, ustawiony na 5 dni | Ustaw na 1 dzień | Około 1 dnia i 1 godziny po wyświetleniu Niestandardowe zachowanie wynikające z niestandardowego okna raportu |
Raporty zbiorcze: raportowanie selektywne
W przypadku raportów, które można agregować, zaletą okien raportu jest tylko filtrowanie konwersji, które nastąpiły po określonym czasie. Nie ma to wpływu na szybkość otrzymywania raportów.
Aby używać okien raportu w przypadku raportów, które można agregować, dodaj pole aggregatable_report_window do nagłówka rejestracji źródła Attribution-Reporting-Register-Source.
Spowoduje to odfiltrowanie konwersji, które nastąpiły po określonym czasie.
Raporty z możliwością agregacji są wysyłane w ciągu godziny od wywołania. Są one opóźniane losowo od 10 minut do godziny.
| wygaśnięcie, | aggregatable_report_window |
Raporty odfiltrowane (nie wysłane) w przypadku konwersji: |
|---|---|---|
| Domyślny (30 dni) | (nie ustawiono) | Ponad 30 dni po kliknięciu lub wyświetleniu |
| Niestandardowy, ustawiony na 5 dni | (nie ustawiono) | Ponad 5 dni po kliknięciu lub wyświetleniu |
| Domyślny (30 dni) | Ustaw na 1 dzień | Więcej niż 1 dzień po kliknięciu lub wyświetleniu |
| Niestandardowy, ustawiony na 5 dni | Ustaw na 1 dzień | Więcej niż 1 dzień po kliknięciu lub wyświetleniu |
| Domyślny (30 dni) | Ustaw na 4 godziny | Więcej niż 1 dzień po kliknięciu lub wyświetleniu. Wynika to z ograniczenia: minimalny okres raportowania to 1 dzień. Nawet jeśli ustawisz okres raportowania na mniej niż dzień, np. 4 godziny, jego wartość zostanie ograniczona do 1 dnia. |
Angażowanie się i przesyłanie opinii
Możesz korzystać z tego interfejsu API i eksperymentować z nim.
- Dowiedz się więcej o raportach podlegających agregacji i usłudze do agregacji, zadawaj pytania i przesyłaj opinie.
- Przeczytaj przewodniki po raportowaniu atrybucji.