Zwraca dostosowany raport przestawny zawierający dane zdarzeń Google Analytics. Raporty przestawne są bardziej zaawansowane i zapewniają więcej precyzji niż zwykłe raporty. W raporcie przestawnym wymiary są widoczne tylko wtedy, gdy zostały uwzględnione w tabeli przestawnej. Aby dokładniej przeanalizować dane, możesz określić wiele tabel przestawnych.
Żą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órej zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Dowiedz się, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub spójna z właściwością na poziomie wsadu. Przykład: właściwość/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 przez jeden z tych rodzajów wartości: levelExpression, metricFilter, przestaws, orderBys. |
metrics[] |
Żądane dane; należy określić co najmniej 1 rodzaj danych. Wszystkie zdefiniowane wskaźniki muszą być używane przez jeden z tych elementów: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Zakres dat, z którego chcesz pobrać dane zdarzenia z raportu. Jeśli określisz wiele zakresów dat, w raporcie zostaną użyte dane zdarzeń z każdego zakresu dat. W nazwach pól w tabeli przestawnej można uwzględnić wymiar specjalny o nazwie „dateRange”; jeśli ten wymiar jest uwzględniony, raport porównuje zakresy dat. W żądaniu dotyczącym kohorty pole |
pivots[] |
Opisuje wizualny format wymiarów raportu w kolumnach lub wierszach. Połączenie wartości fieldNames (nazw wymiarów) we wszystkich tabelach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Żadne 2 tabele przestawne nie mogą mieć wspólnego wymiaru. Wymiar jest widoczny tylko wtedy, gdy pojawia się w tabeli przestawnej. |
dimensionFilter |
Klauzula filtra wymiarów. Aby można było użyć wymiarów w tym filtrze, trzeba poprosić o ich zastosowanie. W tym filtrze nie można używać danych. |
metricFilter |
Klauzula filtra danych. Stosowane na etapie po agregacji, podobnie jak w przypadku klauzuli SQL. Aby można było użyć danych w tym filtrze, należy poprosić o dane. W tym filtrze nie można używać wymiarów. |
currencyCode |
Kod waluty w formacie ISO4217, np. „AED”, „USD”, „JPY”. Jeśli to pole jest puste, raport używa domyślnej waluty usługi. |
cohortSpec |
Grupa kohorty powiązana z tym żądaniem. Jeśli żądanie zawiera grupę kohorty, musi być obecny wymiar „kohorta”. |
keepEmptyRows |
Jeśli wartość fałsz lub nieokreślona, żaden wiersz ze wszystkimi danymi równymi 0 nie zostanie zwrócony. Jeśli ma wartość true (prawda), te wiersze zostaną zwrócone, jeśli nie zostaną usunięte oddzielnie przez filtr. Niezależnie od tego ustawienia Jeśli np. usługa nigdy nie rejestruje zdarzenia |
returnPropertyQuota |
Określa, czy zwracać bieżący stan limitu tej usługi Analytics. Limit jest zwracany w ramach PropertyQuota. |
comparisons[] |
Opcjonalnie. Konfiguracja porównań żądanych i wyświetlanych. Aby żądanie otrzymało w odpowiedzi kolumnę porównań, wymagane jest zarówno pole porównania, jak i wymiar porównań. |
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu RunPivotReportResponse
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics