CohortSpec
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir grup raporu için kohortların spesifikasyonu.
Grup raporları, grup için bir zaman serisi kullanıcıları elde tutma işlemi oluşturur. Örneğin, Eylül'ün ilk haftasında edinilen kullanıcı kohortunu seçebilir ve bu kohortu sonraki altı hafta boyunca takip edebilirsiniz. Eylül grubunun ilk haftasında edinilen kullanıcıların seçilmesi cohort
nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortun devamı cohortsRange
nesnesinde belirtilir.
Örnekler için Kohort Raporu Örnekleri bölümüne bakın.
Rapor yanıtında, uygulamanızın üç hafta sonra bu grubun% 60'ını, altı hafta sonra da bu kohortun% 25'ini koruduğunu belirten bir haftalık zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers
metriğiyle hesaplanabilir ve raporda ayrı satırlar olur.
Alanlar |
cohorts[] |
object (Cohort )
Kullanıcıları kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar. Çoğu kohort raporu yalnızca tek bir kohort tanımlar. Birden fazla kohort belirtilirse her kohort raporda adlarıyla tanınabilir.
|
cohortsRange |
object (CohortsRange )
Kohort raporları, geniş bir raporlama tarih aralığı boyunca kohortları takip eder. Bu aralık, kohortların takip edileceği ofset süresini belirtir.
|
cohortReportSettings |
object (CohortReportSettings )
Grup raporu için isteğe bağlı ayarlar.
|
Kohort
Kohort seçim ölçütü tanımlar. Kohort, ortak bir özelliğe sahip kullanıcı grubudur. Örneğin, aynı firstSessionDate
değerine sahip kullanıcılar aynı kohorta dahildir.
JSON gösterimi |
{
"name": string,
"dimension": string,
"dateRange": {
object (DateRange )
}
} |
Alanlar |
name |
string
Bu gruba bir ad atar. cohort boyutu, bir rapor yanıtında bu ada ayarlanır. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Politika ayarlanmazsa kohortlar sıfır tabanlı dizinlerine (cohort_0 , cohort_1 vb.) göre adlandırılır.
|
dimension |
string
Grup tarafından kullanılan boyut. Zorunludur ve yalnızca firstSessionDate desteklenir.
|
dateRange |
object (DateRange )
Grup, ilk temas tarihi dateRange içinde tanımlanan başlangıç tarihi ile bitiş tarihi arasında olan kullanıcıları seçer. Bu dateRange , bir grup raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Bir grup raporunda bu dateRange , cohortsRange öğesinde bulunan ayrıntı düzeyi ve ofsetle artırılır; Genişletilmiş raporlama tarih aralığına ait etkinlik verileri bir grup raporunda mevcut. Bir kohort isteğinde bu dateRange gereklidir ve RunReportRequest ya da RunPivotReportRequest içindeki dateRanges belirtilmemelidir. Bu dateRange , genellikle grubun ayrıntı düzeyiyle uyumlu olmalıdır. CohortsRange günlük ayrıntı düzeyi kullanıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyini kullanıyorsa bu dateRange , Pazar gününden başlayıp Cumartesi günü sona eren bir hafta sınırına hizalanabilir. CohortsRange aylık ayrıntı düzeyini kullanıyorsa bu dateRange , ayın ilk gününden başlayıp son gününde sona erecek şekilde bir aya hizalanabilir.
|
CohortsRange
Bir grup raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortların takip edileceği ofset süresini belirtir.
JSON gösterimi |
{
"granularity": enum (Granularity ),
"startOffset": integer,
"endOffset": integer
} |
Alanlar |
granularity |
enum (Granularity )
Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset öğelerini yorumlamada kullanılan ayrıntı düzeyi.
|
startOffset |
integer
startOffset , bir grup raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlarda, kohortun edinildiği tarihten sonraki veriler yer alır.
granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset gün olur.
granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset * 7 gün olur.
granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset * 30 gün olur.
|
endOffset |
integer
Zorunlu. endOffset , bir grup raporu için genişletilmiş raporlama tarih aralığının bitiş tarihini belirtir. endOffset , herhangi bir pozitif tam sayı olabilir ancak genellikle 5-10 olarak ayarlanır. Böylece raporlar, sonraki birkaç ayrıntı dönemi için kohortla ilgili verileri içerir. granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset gün olur.
granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset * 7 gün olur.
granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset * 30 gün olur.
|
Ayrıntı düzeyi
Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset
ve endOffset
öğelerini yorumlamada kullanılan ayrıntı düzeyi.
Sıralamalar |
GRANULARITY_UNSPECIFIED |
Hiçbir zaman belirtilmemelidir. |
DAILY |
Günlük ayrıntı düzeyi. Genellikle grubun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa kullanılır. |
WEEKLY |
Haftalık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir haftaysa (Pazar günü başlayıp Cumartesi günü sona eren) ve istek cohortNthWeek içeriyorsa kullanılır. |
MONTHLY |
Aylık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir aysa ve istek cohortNthMonth içeriyorsa kullanılır. |
CohortReportSettings
Grup raporunun isteğe bağlı ayarları.
JSON gösterimi |
{
"accumulate": boolean
} |
Alanlar |
accumulate |
boolean
True (doğru) ise, sonucu ilk temas gününden bitiş gününe kadar toplar. RunReportRequest sisteminde desteklenmiyor.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-09-11 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-09-11 UTC."],[[["Defines the criteria for grouping users into cohorts based on shared characteristics, such as their first session date."],["Allows for tracking user retention over an extended period by specifying an offset duration to follow the cohorts."],["Reports can be generated with daily, weekly, or monthly granularity, providing insights into cohort behavior over time."],["Includes optional settings for accumulating results and providing custom names for cohorts."],["Offers flexibility in defining the reporting date range to analyze specific periods of user engagement."]]],[]]