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 kaynak adı. Format: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

İsteğe bağlı. Rapor verilerini almak için rapor tanımı. Bu tanım, raporun yapısını açıklar. 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örevi için rapor meta verileri. Rapor hakkında bilgi sağlar. Genellikle aşağıdaki bilgileri içerir: raporun kaynak adı, raporun durumu, raporun oluşturulduğu zaman damgası vb.

ReportDefinition

Bir raporun nasıl çalıştırılması gerektiğinin 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örüntülenen 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ığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına dahil edilir. Bir kohort 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 örnekleri içeren Boyut Filtrelerinin Temel Özellikleri başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

İsteğe bağlı. Metriklerin filtre ifadesi. SQL having yan tümcesine benzer şekilde, raporun satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz.
offset

string (int64 format)

İsteğe bağlı. Google Analytics Depolama'daki 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örevinde 10.000 satır sınırı ve 0 ofset değeriyle ilk 10.000 satır bulunabilir. Ardından, başka bir rapor görevi 10.000 satır sınırı ve 10.000 ofset ile sonraki 10.000 satırı 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.

limit kadar boyut değeri yoksa API, 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 alamazsınız.
metricAggregations[]

enum (MetricAggregation)

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

object (OrderBy)

İsteğe bağlı. Satırların yanıtta nasıl sıralandığını belirtir.
currencyCode

string

İsteğe bağlı. ISO4217 biçiminde bir para birimi kodu ("AED", "USD", "JPY" gibi). 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 kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu mevcut olmalıdır.
keepEmptyRows

boolean

İsteğe bağlı. Yanlış veya belirtilmemişse tüm metrikleri 0 olan her satır döndürülmez. Doğru ise bir filtre tarafından ayrı olarak kaldırılmazlarsa bu satırlar döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, raporlarda yalnızca Google Analytics mülkü tarafından kaydedilen veriler gösterilebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliği günlüğe kaydetmezse eventName boyutu ve eventCount metriği için bir sorgu, eventName: "purchase" ve eventCount: 0 içeren bir satır içermez.
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 "İstanbul" veya "Ankara" 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ı başlıklı makaleyi inceleyin. runRealtimeReport yöntemi tarafından desteklenen boyut adlarının listesi için Gerçek Zamanlı Boyutlar başlıklı makaleyi inceleyin. runFunnelReport yöntemi tarafından desteklenen boyut adlarının listesi için Dönüşüm hunisi boyutları başlıklı makaleyi inceleyin.

dimensionExpression belirtilirse 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 boyutu countryAndCity olarak adlandırabilirsiniz. Seçtiğiniz boyut adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Boyutlara dimensionFilter, orderBys, dimensionExpression ve pivots'te name ile referans verilir.
dimensionExpression

object (DimensionExpression)

Bir boyut, birden fazla boyutun ifadesi sonucu olabilir. Örneğin, "country, city" boyutu: concatenate(country, ", ", city).

DimensionExpression

Birden fazla boyut içeren bir formülün sonucu olan bir boyutu ifade etmek için kullanılır. Örnek kullanımlar: 1) küçükHarfeDönüştür(boyut) 2) birleştir(boyut1, simge, boyut2).

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
Birlik alanı one_expression. DimensionExpression için bir boyut ifadesi türü belirtin. one_expression yalnızca aşağıdakilerden 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, "country, city" boyutu: concatenate(country, ", ", city).

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

Bir boyutun adı. Ad, istekteki dimensions alanındaki bir ada referans vermelidir.

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, istekteki boyutlar alanındaki adlara referans vermelidir.
delimiter

string

Boyut adları arasına yerleştirilen ayırıcı.

Ayırıcılar genellikle "|" veya "," gibi tek karakterlerden oluşur ancak daha uzun dizeler de olabilir. Bir boyut değeri ayırıcı içeriyorsa yanıtta her ikisi de ayrım yapılmadan yer alır. Örneğin, 1. boyutun değeri = "US,FR", 2. boyutun değeri = "JP" ve ayırı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ını ifade eder. İsteklere en fazla 10 metrik dahil edilebilir.

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 bölümüne bakın. runRealtimeReport yöntemi tarafından desteklenen metrik adlarının listesi için Gerçek Zamanlı Metrikler başlıklı makaleyi inceleyin. runFunnelReport yöntemi tarafından desteklenen metrik adlarının listesi için Dönüşüm hunisi metrikleri başlıklı makaleyi inceleyin.

expression belirtilirse 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 çağırabilirsiniz. Seçtiğiniz metrik adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Metriklere metricFilter, orderBys ve expression metriğinde name ile referans verilir.
expression

string

Türetilen metrikler için matematiksel bir ifade. Örneğin, kullanıcı başına etkinlik sayısı metriği eventCount/totalUsers değerine sahiptir.
invisible

boolean

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

DateRange

Art arda gelen bir gün grubu: startDate, startDate + 1, ..., endDate. En fazla 4 tarih aralığına izin verilir.

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

string

Sorgunun dahili başlangıç tarihi (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

Sorgunun dahili bitiş tarihi (YYYY-MM-DD biçiminde). 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ğerlenir. 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'deki alanların tümü boyut veya tümü 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
Birlik alanı expr. FilterExpression için bir filtre ifadesi türü belirtin. expr yalnızca aşağıdakilerden biri olabilir:
andGroup

object (FilterExpressionList)

andGroup içindeki FilterExpressions öğeleri AND ilişkisine sahiptir.
orGroup

object (FilterExpressionList)

orGroup içindeki FilterExpressions'in VEYA ilişkisi vardır.
notExpression

object (FilterExpression)

FilterExpression, notExpression değildir.
filter

object (Filter)

Basit bir filtre. Aynı FilterExpression içinde, filtrenin tüm alan adlarının ya tüm boyutlar ya da tüm metrikler olması gerekir.

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.
Birlik alanı one_filter. Filter için bir filtre türü belirtin. one_filter yalnızca aşağıdakilerden biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Listede bulunan değerler için bir filtre.
numericFilter

object (NumericFilter)

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

object (BetweenFilter)

İki değer arasında bir filtre.
emptyFilter

object (EmptyFilter)

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

StringFilter

Dize için filtre

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ğru ise dize değeri büyük/küçük harfe duyarlıdır.

MatchType

Dize filtresinin eşleme 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 listesinde olmalıdır.

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

string

Dize değerlerinin listesi. Boş bırakılamaz.
caseSensitive

boolean

Doğru ise 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 veya tarihsel bir değer.

İşlem

Sayısal filtreye uygulanan işlem

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

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
Birlik alanı one_value. one_value sayısal değeri aşağıdakilerden yalnızca biri olabilir:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer

BetweenFilter

Sonuç iki sayı arasında (bu sayılar dahil) olmalıdır.

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

object (NumericValue)

Bu sayıyla başlar.
toValue

object (NumericValue)

Bu sayıyla biter.

EmptyFilter

Bu türde alan yoktur.

Boş değerler için filtreleme yapın.

MetricAggregation

Metriklerin toplamını temsil eder.

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

OrderBy

Sıralama ölçütleri, satırların yanıtta nasıl sıralanacağını tanımlar. Örneğin, satırları etkinlik sayısına göre azalan düzende sıralama bir sıralama, satırları etkinlik adı dizesine göre sıralama 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ğru ise azalan düzende sıralar.
Birlik alanı one_order_by. OrderBy için bir sipariş türü belirtin. one_order_by yalnızca aşağıdakilerden 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 ölçütü olarak kullanılacak istekteki metrik adı.

DimensionOrderBy

Boyut değerlerine göre sıralar.

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

string

Sıralama ölçütü olarak kullanılacak istekteki boyut adı.
orderType

enum (OrderType)

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

OrderType

Dize boyutu değerlerini sıralamak için kullanılacak kural.

Sıralamalar
ORDER_TYPE_UNSPECIFIED Belirtilmedi.
ALPHANUMERIC Unicode kod noktasına göre alfanümerik sıralama. Örneğin, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Büyük/küçük harfe duyarlı olmayan, küçük harf Unicode kod noktasına göre alfanümerik sıralama. Örneğin, "2" < "A" < "b" < "X" < "z".
NUMERIC Boyut değerleri, sıralamadan önce sayılara dönüştürülür. Örneğin, NUMERIC sıralamasında "25" < "100", ALPHANUMERIC sıralamasında ise "100" < "25" olur. Tüm sayısal olmayan boyut değerlerinin, tüm sayısal değerlerin altında eşit bir sıralama değeri vardır.

CohortSpec

Grup raporu için grupların özellikleri.

Kohort raporları, ilgili grup için kullanıcı elde tutma zaman serisi oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı grubunu seçebilir ve bu grubu önümüzdeki altı hafta boyunca takip edebilirsiniz. Eylül ayının ilk haftasında edinilen kullanıcıların seçilmesi, cohort nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortu takip etmek için cohortsRange nesnesi kullanılır.

Örnekler için Kullanıcı Grubu Raporu Örnekleri bölümüne bakın.

Rapor yanıtında, uygulamanızın üç hafta sonra bu kohortun% 60'ını, altı hafta sonra ise% 25'ini elinde tuttuğunu belirten haftalık bir zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriği kullanılarak 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 kullanılan seçim ölçütlerini tanımlar.

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

object (CohortsRange)

Grup raporları, genişletilmiş bir raporlama tarih aralığındaki grupları izler. Bu aralık, kohortları takip etmek için bir ofset süresi belirtir.
cohortReportSettings

object (CohortReportSettings)

Kohort raporu için isteğe bağlı ayarlar.

Kohort

Kohort seçim ölçütlerini tanımlar. Kohort, ortak bir özelliği paylaşan 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 kohort için bir ad atar. cohort boyutu, rapor yanıtında bu adla değerlenir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Ayarlanmamışsa kohortlar sıfır tabanlı dizinlerine göre (cohort_0, cohort_1 vb.) adlandırılır.
dimension

string

Grubun kullandığı 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, kohort raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Grup raporunda bu dateRange, cohortsRange'teki ayrıntı düzeyi ve ofset ile genişletilir; genişletilmiş raporlama tarih aralığı için etkinlik verileri grup raporunda bulunur.

Kohort isteğinde bu dateRange gereklidir ve RunReportRequest veya RunPivotReportRequest içindeki dateRanges belirtilmemelidir.

Bu dateRange genellikle kohortun ayrıntı düzeyiyle uyumlu olmalıdır. CohortsRange günlük ayrıntı düzeyinde kullanılıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyinde kullanılıyorsa bu dateRange, pazardan başlayıp cumartesi günü sona eren bir hafta sınırıyla hizalanabilir. CohortsRange aylık ayrıntı düzeyinde kullanılıyorsa bu dateRange, ayın ilk gününden başlayıp son gününde sona eren bir ayla uyumlu olabilir.

CohortsRange

Bir kohort raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortları 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 kohort raporu için genişletilmiş raporlama tarih aralığındaki startOffset ve endOffset değerlerini yorumlamak için kullanılan ayrıntı düzeyi.
startOffset

integer

startOffset, bir kohort raporu için genişletilmiş raporlama tarihi aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlar, kohortun edinilmesinden sonraki verileri içerir.

granularity DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri, kohortun startDate değerine startOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının startDate değeri, kohortun startDate değerine startOffset * 7 gün eklenerek hesaplanır.

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

integer

Zorunlu. endOffset, kohort 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 değeri, kohortun endDate değerine endOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının endDate değeri, kohortun endDate değerine endOffset * 7 gün eklenerek hesaplanır.

granularity MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri, kohortun endDate değerine endOffset * 30 gün eklenerek hesaplanır.

Ayrıntı düzeyi

Bir kohort raporu için genişletilmiş raporlama tarih aralığındaki startOffset ve endOffset değerlerini yorumlamak için kullanılan ayrıntı düzeyi.

Sıralamalar
GRANULARITY_UNSPECIFIED Asla belirtilmemelidir.
DAILY Günlük ayrıntı düzeyi. Kohortun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa genellikle kullanılır.
WEEKLY Haftalık ayrıntı düzeyi. Kohortun dateRange özelliği bir hafta (Pazar'dan Cumartesi'ye kadar) süreliyse ve istek cohortNthWeek içeriyorsa genellikle kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Kullanıcı grubunun dateRange süresi bir ay ise ve istek cohortNthMonth içeriyorsa genellikle kullanılır.

CohortReportSettings

Kohort raporunun isteğe bağlı ayarları.

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

boolean

Doğru ise sonucu ilk temas gününden bitiş gününe kadar toplar. RunReportRequest sürümünde desteklenmez.

SamplingLevel

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

Sıralamalar
SAMPLING_LEVEL_UNSPECIFIED Belirtilmemiş tür.
LOW Standart mülkler için 10 milyon, Google Analytics 360 mülkleri için 100 milyon örnekleme düzeyi uygular.
MEDIUM 1 milyar örnekleme düzeyine sahip 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 alınan toplam kota jetonu sayısı. Bu jeton sayısı CREATING durumundaki etkinliğe dayalı olduğundan, bir rapor görevi ACTIVE veya FAILED durumuna girdikten sonra bu jeton ücreti düzeltilir.
state

enum (State)

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

string (Timestamp format)

Yalnızca çıkış. reportTasks.create işlevinin çağrıldığı ve raporun CREATING durumuna geçtiği zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
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 sayfalandırma için taskRowCount'ü kullanabilirsiniz.
errorMessage

string

Yalnızca çıkış. Bir rapor görevi oluşturulurken başarısız olursa hata mesajı doldurulur.
totalRowCount

integer

Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun dışındaki ek veri satırlarını sorgulamak istiyorsanız totalRowCount'ye dayalı yeni bir rapor görevi başlatabilirler.

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

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

Eyalet

İşleme durumu.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş 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şturulur ve sorgulanmaya hazır olur.
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ülk için tüm rapor görevlerini listeler.

query

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