CohortSpec
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Specyfikacja kohort w raporcie dotyczącym kohorty.
Raporty dotyczące kohorty tworzą serię czasową utrzymania użytkowników w kohorcie. Możesz np. wybrać kohortę użytkowników pozyskanych w pierwszym tygodniu września i śledzić tę kohortę przez kolejne 6 tygodni. Wybór użytkowników pozyskanych w pierwszym tygodniu września jest określony w obiekcie cohort
. Kohorta na kolejne 6 tygodni jest określona w obiekcie cohortsRange
.
Przykłady znajdziesz w artykule Przykłady raportów dotyczących kohorty.
Odpowiedź w raporcie może zawierać cotygodniowy ciąg czasowy, w którym aplikacja utrzymała 60% tej kohorty po 3 tygodniach i 25% tej kohorty po 6 tygodniach. Te 2 wartości procentowe mogą być obliczane według danych cohortActiveUsers/cohortTotalUsers
i znajdują się w oddzielnych wierszach raportu.
Pola |
cohorts[] |
object (Cohort )
Określa kryteria wyboru służące do grupowania użytkowników w kohorty. Większość raportów dotyczących kohorty definiuje tylko jedną kohortę. Jeśli określisz wiele kohort, każda z nich zostanie rozpoznana w raporcie po jej nazwie.
|
cohortsRange |
object (CohortsRange )
Raporty dotyczące kohorty uwzględniają kohorty w rozszerzonym zakresie dat. Ten zakres określa czas przesunięcia, aby śledzić kohorty.
|
cohortReportSettings |
object (CohortReportSettings )
Opcjonalne ustawienia raportu dotyczącego kohorty.
|
Kohorta
Określa kryteria wyboru kohorty. Kohorta to grupa użytkowników, którzy mają wspólną cechę. Na przykład użytkownicy z takim samym atrybutem firstSessionDate
należą do tej samej kohorty.
Zapis JSON |
{
"name": string,
"dimension": string,
"dateRange": {
object (DateRange )
}
} |
Pola |
name |
string
Przypisuje nazwę do tej kohorty. Wymiar cohort otrzymuje tę nazwę w odpowiedzi na raport. Jeśli jest ustawione, nie może zaczynać się od cohort_ ani RESERVED_ . Jeśli nie jest ustawiony, kohorty są nazwane według indeksu zerowego cohort_0 , cohort_1 itd.
|
dimension |
string
Wymiar używany przez kohortę. Wymagana i obsługiwana tylko w przypadku języka firstSessionDate .
|
dateRange |
object (DateRange )
Kohorta wybiera użytkowników, których data pierwszego kontaktu przypada między datą rozpoczęcia a datą zakończenia określoną w dateRange . Ta wartość dateRange nie określa pełnego zakresu dat danych zdarzenia zawartych w raporcie dotyczącym kohorty. W raporcie dotyczącym kohorty wartość dateRange jest rozszerzona o stopień szczegółowości i przesunięcie występujące w kolumnie cohortsRange . Dane zdarzeń z rozszerzonego zakresu dat raportowania są dostępne w raporcie dotyczącym kohorty. W żądaniu dotyczącym kohorty pole dateRange jest wymagane, a pole dateRanges w RunReportRequest lub RunPivotReportRequest musi być nieokreślone. Ten parametr dateRange powinien być zwykle dopasowany do szczegółowości kohorty. Jeśli CohortsRange używa szczegółowości dziennie, dateRange może oznaczać 1 dzień. Jeśli funkcja CohortsRange używa szczegółowości tygodniowej, ten parametr dateRange można wyrównać do granicy tygodnia, zaczynając od niedzieli i kończąc w sobotę. Jeśli funkcja CohortsRange używa szczegółowości miesięcznej, wartość dateRange można wyrównać do miesiąca, zaczynając od pierwszego do ostatniego dnia miesiąca.
|
CohortsRange
Konfiguruje rozszerzony zakres dat w raporcie dotyczącym kohorty. Określa czas przesunięcia, aby śledzić kohorty.
Zapis JSON |
{
"granularity": enum (Granularity ),
"startOffset": integer,
"endOffset": integer
} |
Pola |
granularity |
enum (Granularity )
Wymagane. Szczegółowość używana do interpretacji startOffset i endOffset w rozszerzonym zakresie dat raportowania w raporcie dotyczącym kohorty.
|
startOffset |
integer
startOffset określa datę rozpoczęcia rozszerzonego zakresu dat raportowania na potrzeby raportu dotyczącego kohorty. startOffset ma zwykle wartość 0, aby raporty zawierały dane dotyczące pozyskania kohorty w przyszłości.
Jeśli granularity to DAILY , wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset dni. Jeśli granularity to WEEKLY , wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset * 7 dni. Jeśli granularity to MONTHLY , wartość startDate w rozszerzonym zakresie dat raportowania to startDate kohorty plus startOffset * 30 dni.
|
endOffset |
integer
Wymagane. endOffset określa datę zakończenia rozszerzonego zakresu dat w raporcie dotyczącym kohorty. endOffset może być dowolną dodatnią liczbą całkowitą, ale zwykle jest ustawiona na 5–10, aby raporty zawierały dane o kohorcie z kilku kolejnych okresów szczegółowości. Jeśli granularity to DAILY , wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset dni. Jeśli granularity to WEEKLY , wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset * 7 dni. Jeśli granularity to MONTHLY , wartość endDate w rozszerzonym zakresie dat raportowania to endDate kohorty plus endOffset * 30 dni.
|
Szczegółowość
Szczegółowość używana do interpretacji startOffset
i endOffset
w rozszerzonym zakresie dat raportowania w raporcie dotyczącym kohorty.
Wartości w polu enum |
GRANULARITY_UNSPECIFIED |
Nigdy nie należy określać. |
DAILY |
Szczegółowość dzienna. Zwykle używana, jeśli dateRange kohorty to 1 dzień, a żądanie zawiera cohortNthDay . |
WEEKLY |
Szczegółowość tygodniowa. Zwykle używany, jeśli dateRange kohorty obejmuje tydzień (rozpoczynający się w niedzielę, a kończący w sobotę) i żądanie zawiera wartość cohortNthWeek . |
MONTHLY |
Szczegółowość miesięczna. Zwykle używana, jeśli dateRange kohorty trwa miesiąc, a żądanie zawiera cohortNthMonth . |
CohortReportSettings
Opcjonalne ustawienia raportu dotyczącego kohorty.
Zapis JSON |
{
"accumulate": boolean
} |
Pola |
accumulate |
boolean
Jeśli ma wartość prawda, kumuluje wynik od pierwszego dnia kontaktu do dnia końcowego. Nieobsługiwane w RunReportRequest .
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-05-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Brak potrzebnych mi informacji"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zbyt skomplikowane / zbyt wiele czynności do wykonania"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nieaktualne treści"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem z tłumaczeniem"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem z przykładami/kodem"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Inne"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Łatwo zrozumieć"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Rozwiązało to mój problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Inne"
}]