W tym dokumencie opisujemy zaawansowane funkcje interfejsu Google Analytics Reporting API w wersji 4. Szczegółowe informacje o interfejsie API znajdziesz w Przewodniku.
Wstęp
Po utworzeniu prostego raportu możesz skorzystać z tych funkcji, aby utworzyć raporty zaawansowane:
Przestawienia
Interfejs Google Analytics Reporting API w wersji 4 umożliwia generowanie tabel przestawnych.
Aby utworzyć żądanie przy użyciu tabeli przestawnej, zdefiniuj pole Tabela przestawna w żądaniu ReportRequest.
Obiekt tabela przestawna ma własny zestaw wymiarów i danych oraz opcjonalnie startGroup i maxGroupCount, które określają liczbę wymiarów do uwzględnienia w tabeli przestawnej.
Prośba
Poniższe wywołania interfejsu API wykonują żądania dotyczące sesji według kraju i przetrąca wyniki w przeglądarce:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
Nagłówek kolumny odpowiedzi
W zwróconym obiekcie raportu dla żądania przestawnego obiekt metricHeader zawiera listę obiektów pivotHeaders, których pola pivotHeaderEntries określają kolejność wartości wymiarów przestawnych i odpowiadające im wartości danych, np.:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
Wiersze odpowiedzi
Każdy wiersz obiektu reportData definiuje tablicę obiektów dateRangeValue, z których każdy zawiera zbiór obiektów pivotValue. Kolejność wartości odpowiada kolejności danych wymienionych w nagłówkach przestawnych w nagłówku kolumny odpowiedzi.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
Pamiętaj, że w raporcie są tylko 3 wartości przestawne, ponieważ w pierwotnym żądaniu maxGroupCount ma wartość 3. Z powodu "totalPivotGroupsCount": 7 wartości może być do 7.
Przykład wiersza tabeli przestawnej
W przykładowej odpowiedzi powyżej wiersz powiązany z krajem Stany Zjednoczone znajduje się w tej tabeli przestawnej:
| Kraj | Łączna liczba sesji: |
Sesje Internet Explorera: |
Sesje FireFox: |
Sesje w przeglądarce na Androida ( ) |
|---|---|---|---|---|
| Indie | 12 | 3 | 2 | 4 |
| Stany Zjednoczone | 192 | 21 | 18 | 1 |
| Wielka Brytania | 35 | 12 | 2 | 0 |
Kohorty
Kohorta to grupa użytkowników, którzy mają wspólną cechę. Na przykład wszyscy użytkownicy z tą samą datą pozyskania należą do tej samej kohorty. Raport analizy kohortowej umożliwia wyodrębnianie i analizowanie zachowań w obrębie danej kohorty. Listę wymiarów i danych związanych z kohortą znajdziesz w artykule Wymiary i dane związane z kohortą i wartością od początku śledzenia.
Aby zdefiniować żądanie dotyczące kohorty, musisz zdefiniować obiekt kohorty za pomocą atrybutów name, type i dateRange:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
Zapoznaj się z podanym wyżej przykładem w narzędziu API Explorer.
Ograniczenia dotyczące kohorty
Prawidłowa prośba dotycząca kohorty musi spełniać te ograniczenia:
- Wymiar
ga:cohortjest uwzględniany tylko wtedy, gdy żądanie zawiera co najmniej 1 definicję kohorty. - Nazwa kohorty musi być unikalna.
- Maksymalna liczba kohort w żądaniu to 12.
- Jeśli zasada
ga:cohortNthWeekjest określona, data rozpoczęcia musi przypadać w niedzielę, a data zakończenia – sobota. Jeśli jest określona dataga:cohortNthMonth, data rozpoczęcia musi przypadać na pierwszy dzień miesiąca, a data zakończenia musi być ostatnim dniem miesiąca. Jeśli określonoga:cohortNthDay, zakres dat musi obejmować dokładnie 1 dzień. - Żądania kohort z dzisiejszą datą są niedozwolone.
- Żądania kohortowe i żądania niezwiązane z kohortą nie powinny znajdować się w tym samym żądaniu
batchGet. - Zakres dat w kohortach musi przypadać po 1 lutego 2015 r.
Wartość od początku śledzenia (LTV)
Raport Wartość od początku śledzenia pokazuje wzrost wartości użytkownika (przychody) i zaangażowania (wyświetlenia aplikacji, realizacje celu, sesje oraz czas trwania sesji) w ciągu 90 dni od pozyskania użytkownika. Zobacz wymiary i dane związane z wartością od początku śledzenia.
Żądanie dotyczące wartości od początku śledzenia jest zdefiniowane jako kohorta z polem lifetimeValue ustawionym na true, np.:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
Zobacz ten przykład w narzędziu API Explorer.
Wymiary i dane związane z kohortą i wartością od początku śledzenia
Wymiary
| Nazwa wymiaru | Definicja |
|---|---|
ga:cohort |
Nazwa kohorty, do której należy użytkownik. W zależności od tego, jak zostały zdefiniowane kohorty, użytkownik może należeć do wielu kohort, podobnie jak w przypadku jego przynależności do wielu segmentów. |
ga:cohortNthDay |
Przesunięcie o 0 dni względem daty definicji kohorty. Jeśli np. kohorta jest zdefiniowana z datą pierwszej wizyty jako 2015-09-01, to dla daty 2015-09-04 wartość ga:cohortNthDay będzie mieć wartość 3. |
ga:cohortNthMonth |
Przesunięcie o wartości 0 w stosunku do daty definicji kohorty. |
ga:cohortNthWeek |
Przesunięcie o 0 tygodni względem daty definicji kohorty. |
ga:acquisitionTrafficChannel |
Kanał ruchu, dzięki któremu udało się pozyskać użytkownika. Jest wyodrębniane z pierwszej sesji użytkownika. Kanał ruchu jest obliczany na podstawie domyślnych reguł grupowania kanałów (na poziomie widoku danych, jeśli są dostępne) w chwili pozyskania użytkowników. |
ga:acquisitionSource |
Źródło, dzięki któremu udało się pozyskać użytkownika. Pochodzi z pierwszej sesji użytkownika. |
ga:acquisitionMedium |
Medium, dzięki któremu udało się pozyskać użytkownika. Pochodzi z pierwszej sesji użytkownika. |
ga:acquisitionSourceMedium |
Łączna wartość ga:userAcquisitionSource i ga:acquisitionMedium. |
ga:acquisitionCampaign |
Kampania, dzięki której udało się pozyskać użytkownika. Pochodzi z pierwszej sesji użytkownika. |
Wskaźniki
| Nazwa wskaźnika | Definicja |
|---|---|
ga:cohortActiveUsers |
Te dane są przydatne w kontekście wymiarów przesunięcia, licząc od 0 (ga:cohortNthDay, ga:cohortNthWeek lub ga:cohortNthMonth). Wskazuje liczbę użytkowników w kohorcie, którzy są aktywni w okresie odpowiadającym n-tym dniu/tygodniowi/miesiącu kohorty. Na przykład w przypadku ga:cohortNthWeek = 1 jest to liczba użytkowników (w kohorcie), którzy są aktywni w drugim tygodniu. Jeśli żądanie nie zawiera żadnej z tych wartości: ga:cohortNthDay, ga:cohortNthWeek ani ga:cohortNthMonth, te dane będą miały tę samą wartość co ga:cohortTotalUsers. |
ga:cohortTotalUsers |
Liczba użytkowników należących do kohorty, czyli tzw. rozmiar kohorty. |
ga:cohortAppviewsPerUser |
Wyświetlenia aplikacji na użytkownika w kohorcie. |
ga:cohortGoalCompletionsPerUser |
Realizacje celów na użytkownika w kohorcie. |
ga:cohortPageviewsPerUser |
Odsłony na użytkownika w kohorcie. |
ga:cohortRetentionRate |
Współczynnik utrzymania kohorty. |
ga:cohortRevenuePerUser |
Przychody na użytkownika w kohorcie. |
ga:cohortVisitDurationPerUser |
Czas trwania sesji na użytkownika w kohorcie. |
ga:cohortSessionsPerUser |
Sesje na użytkownika w przypadku kohorty. |
dane o wartości od początku śledzenia,
| Nazwa wskaźnika | Definicja |
|---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
Dzieje się tak w kontekście żądania, które ma wymiary ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium lub ga:acquisitionCampaign. Reprezentuje ona liczbę użytkowników w kohortach pozyskanych za pomocą bieżącego kanału, źródła, medium lub kampanii. Na przykład w przypadku ga:acquisitionTrafficChannel=Direct przedstawia liczbę użytkowników w kohorcie, którzy zostali pozyskani bezpośrednio. Jeśli żaden z wymienionych wymiarów nie występuje, jego wartość jest równa ga:cohortTotalUsers (tylko wyświetlenia aplikacji). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Wyświetlenia aplikacji na użytkownika w przypadku wymiaru pozyskania w przypadku kohorty (tylko wyświetlenia aplikacji). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
Realizacje celów na użytkownika w przypadku wymiaru pozyskania w przypadku kohorty (tylko wyświetlenia aplikacji). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Liczba odsłon na użytkownika w przypadku wymiaru pozyskania w przypadku kohorty (tylko wyświetlenia aplikacji). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
Przychody na użytkownika w przypadku wymiaru pozyskania w przypadku kohorty (tylko wyświetlenia aplikacji). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
Czas trwania sesji na użytkownika w przypadku wymiaru pozyskania w przypadku kohorty (tylko wyświetlenia aplikacji). |