REST Resource: properties.reportTasks

Kaynak: ReportTask

Belirli bir rapor görevi yapılandırması.

JSON gösterimi 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Oluşturma sırasında atanan rapor görevi kaynağının adı. Biçim: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

İsteğe bağlı. Rapor verilerini getirmek için kullanılan ve raporun yapısını açıklayan bir rapor tanımı. Genellikle rapora dahil edilecek alanları ve verileri filtrelemek için kullanılacak ölçütleri içerir.
reportMetadata

object (ReportMetadata)

Yalnızca çıkış. Belirli bir rapor görevinin rapor meta verileri. Bu meta veriler, rapor hakkında bilgi sağlar. Genellikle raporun kaynak adı, raporun durumu, raporun oluşturulduğu zaman damgası vb. bilgileri içerir.

ReportDefinition

Bir raporun nasıl çalıştırılacağının tanımı.

JSON gösterimi 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "samplingLevel": enum (SamplingLevel)
}
Alanlar
dimensions[]

object (Dimension)

İsteğe bağlı. İstenen ve görüntülenen boyutlar.
metrics[]

object (Metric)

İsteğe bağlı. İstenen ve gösterilen metrikler.
dateRanges[]

object (DateRange)

İsteğe bağlı. Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı indeksi içerir. İki tarih aralığı çakışıyorsa çakışan günlerin etkinlik verileri, her iki tarih aralığının yanıt satırlarına dahil edilir. Bir grup isteğinde bu dateRanges belirtilmemelidir.
dimensionFilter

object (FilterExpression)

İsteğe bağlı. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Boyut Filtrelerinin Temelleri başlıklı makaledeki örneklere göz atın. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

İsteğe bağlı. Metriklerin filtre ifadesi. Raporun satırları toplandıktan sonra uygulanır. SQL having-clause'a benzer. Bu filtrede boyutlar kullanılamaz.
offset

string (int64 format)

İsteğe bağlı. Google Analytics depolamasındaki başlangıç satırının satır sayısı. İlk satır, 0. satır olarak sayılır.

Rapor görevi oluştururken offset ve limit parametreleri, oluşturulan rapora dahil edilecek Google Analytics depolama alanındaki veri satırlarının alt kümesini tanımlar. Örneğin, Google Analytics depolama alanında toplam 300.000 satır varsa ilk rapor görevi, 10.000 satırla sınırlı ve 0 ofsetli ilk 10.000 satıra sahip olabilir. Ardından, başka bir rapor görevi sonraki 10.000 satırı 10.000 sınır ve 10.000 ofset ile kapsayabilir.
limit

string (int64 format)

İsteğe bağlı. Raporda döndürülecek satır sayısı. Belirtilmemişse 10.000 satır döndürülür. API, kaç tane isterseniz isteyin istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

API, limit kadar boyut değeri yoksa istenen limit değerinden daha az satır da döndürebilir. Örneğin, country boyutu için 300'den az olası değer vardır. Bu nedenle, yalnızca country hakkında rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır elde edemezsiniz.
metricAggregations[]

enum (MetricAggregation)

İsteğe bağlı. Metriklerin toplanması. Toplanan metrik değerleri, boyut değerlerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

İsteğe bağlı. Yanıttaki satırların nasıl sıralandığını belirtir.
currencyCode

string

İsteğe bağlı. ISO4217 biçiminde bir para birimi kodu (ör. "AED", "USD", "JPY"). Alan boşsa raporda mülkün varsayılan para birimi kullanılır.
cohortSpec

object (CohortSpec)

İsteğe bağlı. Bu istekle ilişkili grup. İstek içinde bir grup varsa "grup" boyutu bulunmalıdır.
keepEmptyRows

boolean

İsteğe bağlı. Yanlışsa veya belirtilmemişse tüm metrikleri 0'a eşit olan her satır döndürülmez. Doğruysa bu satırlar, bir filtre tarafından ayrı olarak kaldırılmadıkları sürece döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, bir raporda yalnızca Google Analytics mülkü tarafından kaydedilen veriler görüntülenebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliğini kaydetmezse eventName boyutu ve eventCount metriği için yapılan bir sorguda eventName: "purchase" ve eventCount: 0 değerlerini içeren bir satır bulunmaz.
samplingLevel

enum (SamplingLevel)

İsteğe bağlı. Raporun örnekleme düzeyi.

Boyut

Boyutlar verilere ilişkin özelliklerdir. Örneğin, şehir boyutu, bir etkinliğin kaynağı olan şehri belirtir. Rapor yanıtlarındaki boyut değerleri dizelerdir. Örneğin, şehir "Paris" veya "New York" olabilir.

JSON gösterimi 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Alanlar
name

string

Boyutun adı. runReport ve batchRunReports gibi temel raporlama yöntemleri tarafından desteklenen boyut adlarının listesi için API Boyutları'na bakın. runRealtimeReport yöntemi tarafından desteklenen boyut adlarının listesi için Gerçek Zamanlı Boyutlar'a bakın. runFunnelReport yöntemi tarafından desteklenen boyut adlarının listesi için Dönüşüm Hunisi Boyutları başlıklı makaleyi inceleyin.

dimensionExpression belirtilmişse name, izin verilen karakter kümesi içinde istediğiniz herhangi bir dize olabilir. Örneğin, bir dimensionExpression, country ve city değerlerini birleştiriyorsa bu boyuta countryAndCity diyebilirsiniz. Seçtiğiniz boyut adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Boyutlara dimensionFilter, orderBys, dimensionExpression ve pivots'de name tarafından referans verilir.
dimensionExpression

object (DimensionExpression)

Bir boyut, birden fazla boyutun ifadesinin sonucu olabilir. Örneğin, "ülke, şehir" boyutu: concatenate(ülke, ", ", şehir).

DimensionExpression

Birden fazla boyutun formülünün sonucu olan bir boyutu ifade etmek için kullanılır. Kullanım örnekleri: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

JSON gösterimi 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Alanlar
one_expression birleşik alanı. DimensionExpression için bir boyut ifadesi türü belirtin. one_expression aşağıdakilerden yalnızca biri olabilir:
lowerCase

object (CaseExpression)

Bir boyut değerini küçük harfe dönüştürmek için kullanılır.
upperCase

object (CaseExpression)

Bir boyut değerini büyük harfe dönüştürmek için kullanılır.
concatenate

object (ConcatenateExpression)

Boyut değerlerini tek bir boyutta birleştirmek için kullanılır. Örneğin, "ülke, şehir" boyutu: concatenate(ülke, ", ", şehir).

CaseExpression

Bir boyut değerini tek bir duruma dönüştürmek için kullanılır.

JSON gösterimi 
{
  "dimensionName": string
}
Alanlar
dimensionName

string

Boyutun adı. Ad, isteğin boyutlar alanındaki bir ada geri dönmelidir.

ConcatenateExpression

Boyut değerlerini tek bir boyutta birleştirmek için kullanılır.

JSON gösterimi 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Alanlar
dimensionNames[]

string

Boyutların adları. Adlar, isteğin boyutlar alanındaki adlara referans vermelidir.
delimiter

string

Boyut adları arasına yerleştirilen sınırlayıcı.

Ayırıcılar genellikle "|" veya "," gibi tek karakterlerdir ancak daha uzun dizeler de olabilir. Bir boyut değeri sınırlayıcı içeriyorsa her ikisi de yanıtta ayırt edilmeden yer alır. Örneğin, 1. boyut değeri = "US,FR", 2. boyut değeri = "JP" ve sınırlayıcı = "," ise yanıt "US,FR,JP" değerini içerir.

Metrik

Bir raporun nicel ölçümleri. Örneğin, eventCount metriği toplam etkinlik sayısıdır. En fazla 10 metrik için istek gönderilebilir.

JSON gösterimi 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Alanlar
name

string

Metriğin adı. runReport ve batchRunReports gibi temel raporlama yöntemleri tarafından desteklenen metrik adlarının listesi için API Metrikleri'ne bakın. runRealtimeReport yöntemi tarafından desteklenen metrik adlarının listesi için Gerçek Zamanlı Metrikler'e bakın. runFunnelReport yöntemiyle desteklenen metrik adlarının listesi için Dönüşüm Hunisi Metrikleri başlıklı makaleyi inceleyin.

expression belirtilmişse name, izin verilen karakter kümesi içinde istediğiniz herhangi bir dize olabilir. Örneğin, expression screenPageViews/sessions ise bu metriğin adını = viewsPerSession olarak adlandırabilirsiniz. Seçtiğiniz metrik adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Metrikler, metricFilter, orderBys ve metrik expression'te name tarafından referans alınır.
expression

string

Türetilmiş metrikler için matematiksel ifade. Örneğin, kullanıcı başına etkinlik sayısı metriği eventCount/totalUsers'dır.
invisible

boolean

Bir metriğin rapor yanıtında görünmez olup olmadığını gösterir. Görünür olmayan bir metrik, yanıtta sütun oluşturmaz ancak metricFilter, orderBys veya expression metriğinde kullanılabilir.

DateRange

Birbirini takip eden günler: startDate, startDate + 1, ..., endDate. En fazla 4 tarih aralığı için istekte bulunabilirsiniz.

JSON gösterimi 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Alanlar
startDate

string

Sorgunun başlangıç tarihi (dahil) YYYY-MM-DD biçiminde. endDate tarihinden sonra olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, tesisin raporlama saat dilimine göre belirlenir.
endDate

string

YYYY-MM-DD biçiminde sorgunun dahil bitiş tarihi. startDate tarihinden önce olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, tesisin raporlama saat dilimine göre belirlenir.
name

string

Bu tarih aralığına bir ad atar. dateRange boyutu, rapor yanıtında bu adla değerlendirilir. Ayarlanırsa date_range_ veya RESERVED_ ile başlayamaz. Ayarlanmamışsa tarih aralıkları, istekteki sıfır tabanlı dizinlerine göre adlandırılır: date_range_0, date_range_1 vb.

FilterExpression

Boyut veya metrik filtrelerini ifade etmek için. Aynı FilterExpression'daki alanlar ya tamamen boyut ya da tamamen metrik olmalıdır.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
expr birleşik alanı. FilterExpression için bir filtre ifadesi türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (FilterExpressionList)

andGroup'taki FilterExpression'lar arasında VE ilişkisi vardır.
orGroup

object (FilterExpressionList)

orGroup'taki FilterExpression'ların VEYA ilişkisi vardır.
notExpression

object (FilterExpression)

FilterExpression, notExpression türünde DEĞİL.
filter

object (Filter)

Basit bir filtre. Aynı FilterExpression içinde, filtrenin tüm alan adları ya tüm boyutlar ya da tüm metrikler olmalıdır.

FilterExpressionList

Filtre ifadelerinin listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (FilterExpression)

Filtre ifadelerinin listesi.

Filtre

Boyut veya metrik değerlerini filtrelemek için kullanılan bir ifade.

JSON gösterimi 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
fieldName

string

Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanmış bir ad olmalıdır.
one_filter birleşik alanı. Filter için bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için filtre.
numericFilter

object (NumericFilter)

Sayısal veya tarih değerleri için filtre.
betweenFilter

object (BetweenFilter)

İki değer arasında filtreleme.
emptyFilter

object (EmptyFilter)

"(not set)" ve "" değerleri gibi boş değerler için filtre.

StringFilter

Dize filtresi

JSON gösterimi 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Alanlar
matchType

enum (MatchType)

Bu filtrenin eşleşme türü.
value

string

Eşleme için kullanılan dize değeri.
caseSensitive

boolean

Doğruysa dize değeri büyük/küçük harfe duyarlıdır.

MatchType

Dize filtresinin eşleşme türü

Sıralamalar
MATCH_TYPE_UNSPECIFIED Belirtilmedi
EXACT Dize değerinin tam eşleşmesi.
BEGINS_WITH Dize değeriyle başlar.
ENDS_WITH Dize değeriyle biter.
CONTAINS Dize değerini içerir.
FULL_REGEXP Normal ifadenin dize değeriyle tam eşleşmesi.
PARTIAL_REGEXP Normal ifadenin dize değeriyle kısmi eşleşmesi.

InListFilter

Sonuç, dize değerlerinin bulunduğu bir listede olmalıdır.

JSON gösterimi 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Alanlar
values[]

string

Dize değerlerinin listesi. Boş olmamalıdır.
caseSensitive

boolean

Doğruysa dize değeri büyük/küçük harfe duyarlıdır.

NumericFilter

Sayısal veya tarih değerleri için filtreler.

JSON gösterimi 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Alanlar
operation

enum (Operation)

Bu filtrenin işlem türü.
value

object (NumericValue)

Sayısal değer veya tarih değeri.

İşlem

İşlem, sayısal bir filtreye uygulandı

Sıralamalar
OPERATION_UNSPECIFIED Belirtilmedi.
EQUAL Eşit
LESS_THAN Küçüktür
LESS_THAN_OR_EQUAL Küçük veya eşit
GREATER_THAN Şundan büyük:
GREATER_THAN_OR_EQUAL Büyük veya eşit

NumericValue

Bir sayıyı temsil etmek için.

JSON gösterimi 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Alanlar
one_value birleşik alanı. Sayısal değerlerden biri olan one_value yalnızca aşağıdakilerden biri olabilir:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer

BetweenFilter

Sonucun iki sayı arasında (bu sayılar dahil) olması gerektiğini belirtmek için kullanılır.

JSON gösterimi 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Alanlar
fromValue

object (NumericValue)

Bu sayıyla başlar.
toValue

object (NumericValue)

Bu numarayla bitenler

EmptyFilter

Bu türde alan yok.

Boş değerleri filtreleyin.

MetricAggregation

Metriklerin toplu halini gösterir.

Sıralamalar
METRIC_AGGREGATION_UNSPECIFIED Belirtilmemiş operatör.
TOTAL TOPLA operatörü.
MINIMUM Minimum operatör.
MAXIMUM Maksimum operatör.
COUNT Sayı operatörü.

Şuna göre sırala

Order by'lar, yanıttaki satırların nasıl sıralanacağını tanımlar. Örneğin, satırları azalan etkinlik sayısına göre sıralamak bir sıralama, satırları etkinlik adı dizesine göre sıralamak ise farklı bir sıralamadır.

JSON gösterimi 
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
Alanlar
desc

boolean

Doğruysa azalan düzende sıralar.
one_order_by birleşik alanı. OrderBy için bir sıralama türü belirtin. one_order_by aşağıdakilerden yalnızca biri olabilir:
metric

object (MetricOrderBy)

Sonuçları bir metriğin değerlerine göre sıralar.
dimension

object (DimensionOrderBy)

Sonuçları bir boyutun değerlerine göre sıralar.

MetricOrderBy

Metrik değerlerine göre sıralar.

JSON gösterimi 
{
  "metricName": string
}
Alanlar
metricName

string

Sıralama isteğindeki bir metrik adı.

DimensionOrderBy

Boyut değerlerine göre sıralar.

JSON gösterimi 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Alanlar
dimensionName

string

Sıralama isteğindeki bir boyut adı.
orderType

enum (OrderType)

Boyut değeri sıralama kuralını kontrol eder.

OrderType

Dize boyut değerlerini sıralama kuralı.

Sıralamalar
ORDER_TYPE_UNSPECIFIED Belirtilmedi.
ALPHANUMERIC Unicode kod noktasına göre alfasayısal sıralama. Örneğin, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Küçük harf Unicode kod noktasına göre büyük/küçük harfe duyarlı olmayan alfanümerik sıralama. Örneğin, "2" < "A" < "b" < "X" < "z".
NUMERIC Boyut değerleri, sıralanmadan önce sayılara dönüştürülür. Örneğin, SAYISAL sıralamada "25" < "100" ve ALPHANUMERIC sıralamada "100" < "25" olur. Sayısal olmayan boyut değerlerinin tümü, sayısal değerlerin altında eşit sıralama değerine sahiptir.

CohortSpec

Kullanıcı grubu raporu için kullanıcı gruplarının belirtilmesi.

Kullanıcı grubu raporları, kullanıcı grubu için kullanıcı elde tutma oranının zaman serisini oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı kohortunu seçip bu kohortu sonraki altı hafta boyunca takip edebilirsiniz. Eylül ayının ilk haftasında edinilen kullanıcıların seçimi cohort nesnesinde belirtilir. Sonraki altı hafta boyunca bu grubu takip etme durumu cohortsRange nesnesinde belirtilir.

Örnekler için Kullanıcı grubu raporu örnekleri konusuna bakın.

Rapor yanıtında, örneğin uygulamanızın üç hafta sonra bu grubun% 60'ını, altı hafta sonra ise% 25'ini elde tuttuğu bir haftalık zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriğiyle hesaplanabilir ve raporda ayrı satırlar olarak gösterilir.

JSON gösterimi 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Alanlar
cohorts[]

object (Cohort)

Kullanıcıları gruplara ayırmak için seçim ölçütlerini tanımlar.

Çoğu kullanıcı grubu raporu yalnızca tek bir kullanıcı grubu tanımlar. Birden fazla grup belirtilirse her grup raporda adıyla tanınabilir.
cohortsRange

object (CohortsRange)

Kullanıcı grubu raporları, kullanıcı gruplarını uzun bir raporlama tarihi aralığı boyunca takip eder. Bu aralık, kohortları takip etmek için kullanılacak bir ofset süresini belirtir.
cohortReportSettings

object (CohortReportSettings)

Bir kullanıcı grubu raporu için isteğe bağlı ayarlar.

Kohort

Bir kohort seçim ölçütü tanımlar. Kohort, ortak bir özelliği paylaşan kullanıcı grubudur. Örneğin, aynı firstSessionDate olan kullanıcılar aynı kohorta dahildir.

JSON gösterimi 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Alanlar
name

string

Bu kitleye bir ad atar. cohort boyutu, rapor yanıtında bu adla değerlendirilir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Ayarlanmamışsa gruplar, sıfır tabanlı dizinlerine göre adlandırılır (cohort_0, cohort_1 vb.).
dimension

string

Grup tarafından kullanılan boyut. Gerekli ve yalnızca firstSessionDate desteklenir.
dateRange

object (DateRange)

Grup, ilk etkileşim tarihi dateRange içinde tanımlanan başlangıç tarihi ile bitiş tarihi arasında olan kullanıcıları seçer. Bu dateRange, bir kullanıcı grubu raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Bir kullanıcı grubu raporunda bu dateRange, cohortsRange içinde bulunan ayrıntı düzeyi ve dengeleme ile genişletilir. Genişletilmiş raporlama tarih aralığına ait etkinlik verileri bir kullanıcı grubu raporunda bulunur.

Bir grup isteğinde bu dateRange gereklidir ve RunReportRequest veya RunPivotReportRequest içindeki dateRanges belirtilmemiş olmalıdır.

Bu dateRange genellikle grubun ayrıntı düzeyiyle uyumlu olmalıdır. CohortsRange günlük ayrıntı düzeyini kullanıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyini kullanıyorsa bu dateRange, pazar günü başlayıp cumartesi günü sona eren bir hafta sınırına göre ayarlanabilir. 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 göre ayarlanabilir.

CohortsRange

Bir kullanıcı grubu raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Grupları takip etmek için bir başlangıç süresi belirtir.

JSON gösterimi 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Alanlar
granularity

enum (Granularity)

Zorunlu. Bir kullanıcı grubu raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset değerlerini yorumlamak üzere kullanılan ayrıntı düzeyi.
startOffset

integer

startOffset, bir kullanıcı grubu raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset, raporların kitle edinme tarihinden itibaren veriler içermesi için genellikle 0 olarak ayarlanır.

granularity DAILY ise genişletilmiş raporlama tarih aralığının startDate, grubun startDate tarihine startOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının startDate, grubun startDate tarihine startOffset * 7 gün eklenerek hesaplanır.

granularity MONTHLY ise genişletilmiş raporlama tarih aralığının startDate, grubun startDate tarihine startOffset * 30 gün eklenerek hesaplanır.
endOffset

integer

Zorunlu. endOffset, bir kullanıcı grubu raporu için genişletilmiş raporlama tarihi aralığının bitiş tarihini belirtir. endOffset herhangi bir pozitif tam sayı olabilir ancak raporların, sonraki birkaç ayrıntı düzeyi zaman aralığı için kohortla ilgili veriler içermesi amacıyla genellikle 5 ila 10 olarak ayarlanır.

granularity DAILY ise genişletilmiş raporlama tarih aralığının endDate, grubun endDate tarihine endOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının endDate, grubun endDate tarihine endOffset * 7 gün eklenerek hesaplanır.

granularity MONTHLY ise genişletilmiş raporlama tarih aralığının endDate, grubun endDate tarihine endOffset * 30 gün eklenerek hesaplanır.

Ayrıntı düzeyi

Bir kullanıcı grubu raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset değerlerini yorumlamak üzere kullanılan ayrıntı düzeyi.

Sıralamalar
GRANULARITY_UNSPECIFIED Asla 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 süresi bir hafta (pazar günü başlayıp cumartesi günü sona erer) ise ve istek cohortNthWeek içeriyorsa kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Genellikle, grubun dateRange süresi bir ay ise ve istek cohortNthMonth içeriyorsa kullanılır.

CohortReportSettings

Bir kullanıcı grubu raporunun isteğe bağlı ayarları.

JSON gösterimi 
{
  "accumulate": boolean
}
Alanlar
accumulate

boolean

Doğruysa sonuç, ilk dokunma gününden bitiş gününe kadar biriktirilir. RunReportRequest sürümünde desteklenmez.

SamplingLevel

İstekler için örnekleme düzeylerinin kategorileri.

Sıralamalar
SAMPLING_LEVEL_UNSPECIFIED Belirtilmemiş tür.
LOW Standart mülklerde 10 milyon, Google Analytics 360 mülklerinde ise 100 milyon örnekleme düzeyi uygular.
MEDIUM Örnekleme düzeyi 1 milyar olan Google Analytics 360 mülklerine özeldir.
UNSAMPLED Yalnızca Google Analytics 360 mülklerinde kullanılabilir. Örneklenmemiş keşifler daha doğrudur ve standart keşiflerde görünmeyen analizler ortaya çıkarabilir. Daha fazla bilgi için https://support.google.com/analytics/answer/10896953 adresini ziyaret edin.

ReportMetadata

Belirli bir rapor görevinin rapor meta verileri.

JSON gösterimi 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Alanlar
creationQuotaTokensCharged

integer

Yalnızca çıkış. Rapor oluşturulurken kullanılan toplam kota jetonu sayısı. Bu jeton sayısı CREATING durumundaki etkinliğe dayalı olduğundan, bir rapor görevi ACTIVE veya FAILED durumuna girdiğinde bu jeton ücreti sabitlenir.
state

enum (State)

Yalnızca çıkış. Bu rapor görevinin mevcut durumu.
beginCreatingTime

string (Timestamp format)

Yalnızca çıkış. reportTasks.create öğesinin çağrıldığı ve raporun CREATING durumuna başladığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
taskRowCount

integer

Yalnızca çıkış. Rapor sonucundaki toplam satır sayısı. Bu alan, durum etkin olduğunda doldurulur. Mevcut raporlarının sınırları dahilinde sayfalara ayırma için taskRowCount kullanabilirsiniz.
errorMessage

string

Yalnızca çıkış. Oluşturma sırasında bir rapor görevi başarısız olursa hata mesajı gösterilir.
totalRowCount

integer

Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun ötesinde ek veri satırları sorgulamak istiyorsanız totalRowCount temelinde yeni bir rapor görevi başlatabilirsiniz.

taskRowCount, özellikle mevcut raporla ilgili satır sayısını temsil ederken totalRowCount, Google Analytics depolama alanından alınan tüm verilerdeki toplam satır sayısını kapsar.

Örneğin, mevcut raporun taskRowCount değerinin 20 olduğunu ve ilk 20 satırdaki verilerin görüntülendiğini varsayalım. Aynı anda totalRowCount değeri 30'dur. Bu, 30 satırın tamamı için veri olduğunu gösterir. İlk 20 satırda sayfalandırma yapmak için taskRowCount kullanılabilir. Raporu genişletmek ve 30 satırın tamamındaki verileri dahil etmek için 30 satırlık verilerin tamamına erişmek üzere totalRowCount kullanılarak yeni bir rapor görevi oluşturulabilir.

Eyalet

İşleme durumu.

Sıralamalar
STATE_UNSPECIFIED Belirtilmeyen durum hiçbir zaman kullanılmaz.
CREATING Rapor şu anda oluşturuluyor ve gelecekte kullanıma sunulacak. Oluşturma işlemi, CreateReport çağrısından hemen sonra gerçekleşir.
ACTIVE Rapor tamamen oluşturulmuş ve sorgulanmaya hazırdır.
FAILED Rapor oluşturulamadı.

Yöntemler

create

 Rapor görevi oluşturma işlemini başlatır.

get

 Belirli bir rapor göreviyle ilgili rapor meta verilerini alır.

list

 Bir mülkle ilgili tüm rapor görevlerini listeler.

query

 Bir rapor görevinin içeriğini alır.