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ı. Biçim: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

İsteğe bağlıdır. 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. Rapor hakkında bilgi sağlar. Genellikle raporun kaynak adı, raporun durumu, raporun oluşturulduğu zaman damgası vb. bilgileri içerir.

ReportDefinition

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ıdır. İstenen ve görüntülenen boyutlar.
metrics[]

object (Metric)

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

object (DateRange)

İsteğe bağlıdır. 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ıdır. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için örnekler içeren Boyut Filtrelerinin Temelleri başlıklı makaleyi inceleyin. Bu filtrede metrikler kullanılamaz.
metricFilter

object (FilterExpression)

İsteğe bağlıdır. Metriklerin filtre koşulu. 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ıdır. 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ır limiti ve 0 ofset ile 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ıdır. Raporda döndürülecek satır sayısı. Belirtilmezse 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ıdır. Metriklerin toplanması. Toplanan metrik değerleri, boyut değerlerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

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

string

İsteğe bağlıdır. 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ıdır. Bu istekle ilişkili grup. İstek içinde bir grup varsa "grup" boyutu bulunmalıdır.
keepEmptyRows

boolean

İsteğe bağlıdır. 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österilebilir.

Ö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ıdır. 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öntemiyle 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 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'de name tarafından başvurulur.
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
Alanlar
DimensionExpression için bir boyut ifadesi türü belirtin. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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).
Birbirini dışlayan alanların sonu.

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

string

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

Sınırlayıcılar genellikle "|" veya "," gibi tek karakterlerdir ancak daha uzun dizeler de olabilir. Bir boyut değeri ayırıcı içeriyorsa her ikisi de yanıtta ayırt edilmeden yer alır. Örneğin, boyut 1 değeri = "US,FR", boyut 2 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. İsteklerde en fazla 10 metriğe izin verilir.

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 istek gönderilebilir.

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, mülkün raporlama zamanı saat dilimine göre çıkarılır.
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, mülkün raporlama zamanı saat dilimine göre çıkarılır.
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of mutually exclusive fields.
}
Alanlar
FilterExpression için bir filtre ifadesi türü belirtin. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
andGroup

object (FilterExpressionList)

andGroup içindeki FilterExpression'lar AND ilişkisine sahiptir.
orGroup

object (FilterExpressionList)

orGroup içindeki FilterExpressions, OR ilişkisine sahiptir.
notExpression

object (FilterExpression)

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

object (Filter)

Temel bir filtre. Aynı FilterExpression içinde, filtrenin tüm alan adları ya tamamen boyut ya da tamamen metrik olmalıdır.
Birbirini dışlayan alanların sonu.

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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of mutually exclusive fields.
}
Alanlar
fieldName

string

Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanmış bir ad olmalıdır.
Filter için bir filtre türü belirtin. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Listedeki 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.
Birbirini dışlayan alanların sonu.

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ğerleri listesinde 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 filtre için işlem türü.
value

object (NumericValue)

Sayısal bir 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üktür veya eşittir

NumericValue

Bir sayıyı temsil etmek için.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "int64Value": string,
  "doubleValue": number
  // End of mutually exclusive fields.
}
Alanlar
Sayısal değerlerden biri. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer
Birbirini dışlayan alanların sonu.

BetweenFilter

Sonucun iki sayı arasında (başlangıç ve bitiş değerleri dahil) olması gerektiğini ifade etmek için.

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ürün alanı yok.

Boş değerleri filtreleyin. "" veya (not set) değerleri olan boyut değerleriyle eşleşir. Bu filtreyi, eksik veya doldurulmamış boyut değerlerine sahip satırlarla eşleştirmek için kullanın ya da notExpression ile birleştirerek hem "" hem de (not set) için ayrı ayrı filtreleme yapmadan bu satırları rapordan hariç tutun.

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 Count 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of mutually exclusive fields.
}
Alanlar
desc

boolean

Doğruysa azalan düzende sıralar.
OrderBy için bir sıralama türü belirtin. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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.
Birbirini dışlayan alanların sonu.

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ıralamasıyla ilgili kuralı kontrol eder.

OrderType

Dize boyutu değerlerini sıralamak için kullanılan 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 alfasayısal 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", ALPHANUMERIC sıralamada ise "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 kohortunun ilk haftasında edinilen kullanıcıların seçimi, cohort nesnesinde belirtilir. Bu grubu takip eden altı hafta boyunca izlenecek grup, cohortsRange nesnesinde belirtilir.

Örnekler için Kullanıcı grubu raporu örnekleri başlıklı makaleyi inceleyin.

Rapor yanıtında, uygulamanızın üç hafta sonra bu kohortun% 60'ını, altı hafta sonra ise% 25'ini elde tuttuğunu gösteren haftalık bir 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ı kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar.

Çoğu kullanıcı grubu raporu yalnızca tek bir kullanıcı grubunu tanımlar. Birden fazla grup belirtilmişse 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 telafi süresini belirtir.
cohortReportSettings

object (CohortReportSettings)

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

Kohort

Bir grup seçimi ö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 kohorta 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

Kullanıcı grubu tarafından kullanılan boyut. Gerekli ve yalnızca firstSessionDate'ı destekler.
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 belirtilmemelidir.

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ü başlayıp son günü 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 kullanılacak bir ofset 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 tarihi aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlar, kohortun edinilmesinden itibaren verileri içerir.

granularity, DAILY ise genişletilmiş raporlama tarih aralığının startDate, kullanıcı grubunun startDate'ı artı startOffset gündür.

granularity, WEEKLY ise genişletilmiş raporlama tarih aralığının startDate, kullanıcı grubunun startDate'ı artı startOffset * 7 gündür.

granularity, MONTHLY ise genişletilmiş raporlama tarih aralığının startDate, kullanıcı grubunun startDate'ı artı startOffset * 30 gündü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, kullanıcı grubunun endDate'ı artı endOffset gündür.

granularity, WEEKLY ise genişletilmiş raporlama tarih aralığının endDate, kullanıcı grubunun endDate'ı artı endOffset * 7 gündür.

granularity, MONTHLY ise genişletilmiş raporlama tarih aralığının endDate, kullanıcı grubunun endDate'ı artı endOffset * 30 gündü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 Hiçbir zaman belirtilmemelidir.
DAILY Günlük ayrıntı düzeyi. Genellikle, grubun dateRange 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. Kullanıcı grubunun dateRange süresi bir ay ise ve istek cohortNthMonth içeriyorsa yaygın olarak 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 birikir. RunReportRequest'da desteklenmez.

SamplingLevel

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

Sıralamalar
SAMPLING_LEVEL_UNSPECIFIED Belirtilmemiş tür.
LOW Standart mülklere 10 milyon, Google Analytics 360 mülklerine 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 edinmek 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 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. Kullanıcılar, mevcut raporlarının sınırları dahilinde sayfalara ayırma için taskRowCount özelliğini kullanabilir.
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 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ş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.