Zwraca niestandardowy raport przestawny danych zdarzeń Google Analytics. Raporty przestawne są bardziej zaawansowane i ekspresyjne niż zwykłe raporty. W raporcie przestawnym wymiary są widoczne tylko wtedy, gdy znajdują się w tabeli przestawnej. Możesz określić wiele przestawnych danych, aby dokładniej przeanalizować dane.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
property |
Identyfikator usługi w GA4 w Google Analytics, którego zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być albo nieokreślona, lub zgodna z właściwością na poziomie wsadu. Przykład: properties/1234 |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dimensions": [ { object ( |
Pola | |
---|---|
dimensions[] |
Żądane wymiary. Wszystkie zdefiniowane wymiary muszą być używane w jednym z tych wymiarów: orderExpression, dimensionsFilter, przestaw lub orderBys. |
metrics[] |
Żądane dane, należy określić co najmniej jeden rodzaj danych. Wszystkie zdefiniowane dane muszą być używane przez: metric_expression, metricFilter lub orderBys. |
dateRanges[] |
Zakres dat, z którego mają zostać pobrane dane zdarzeń na potrzeby raportu. Jeśli określisz wiele zakresów dat, w raporcie zostaną wykorzystane dane o zdarzeniach z każdego z nich. Wymiar specjalny o nazwie pola „dateRange” można umieścić w nazwach pól tabeli przestawnej; jeśli zostaną uwzględnione, raport porówna poszczególne zakresy dat. W żądaniu dotyczącym kohorty wartość |
pivots[] |
Opisuje format wizualny wymiarów raportu w kolumnach lub wierszach. Połączenie wartości „fieldNames” (nazw wymiarów) we wszystkich przestawieniach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Jeden wymiar nie może być używany przez 2 przestawienia. Wymiar jest widoczny tylko wtedy, gdy znajduje się w tabeli przestawnej. |
dimensionFilter |
Klauzula filtrowania wymiarów. Użycie wymiarów w tym filtrze wymaga wysłania prośby o przesłanie prośby. W tym filtrze nie można używać danych. |
metricFilter |
Klauzula filtra wskaźników. Stosowane na etapie po agregacji, podobnie jak w klauzuli SQL. Aby ich używać w tym filtrze, musisz poprosić o ich użycie. W tym filtrze nie można używać wymiarów. |
currencyCode |
Kod waluty w formacie ISO4217, np. „AED”, „USD” lub „JPY”. Jeśli to pole jest puste, w raporcie używana jest domyślna waluta usługi. |
cohortSpec |
Grupa kohort powiązana z tym żądaniem. Jeśli w żądaniu znajduje się grupa kohortowa, „kohorta” wymiar musi być podany. |
keepEmptyRows |
Jeśli wartość to fałsz lub nieokreślona wartość, nie zostaną zwrócone żadne wiersze z żadnymi danymi równymi 0. Jeśli tak, wiersze te zostaną zwrócone, jeśli nie zostały usunięte osobno przez filtr. Niezależnie od tego ustawienia Jeśli np. usługa nigdy nie rejestruje zdarzenia |
returnPropertyQuota |
Określa, czy ma być zwracany bieżący stan limitu tej usługi w Analytics. Limit jest zwracany w polu PropertyQuota. |
comparisons[] |
Opcjonalnie: Konfiguracja porównań żądanych i wyświetlanych. Aby otrzymać w odpowiedzi kolumnę porównania, żądanie wymaga zarówno pola porównań, jak i wymiaru porównań. |
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu RunPivotReportResponse
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics