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 belirtilmemiş olmalıdır.
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ı makaleyi inceleyin. 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örevinde 10.000 satır sınırı ve 0 ofset ile ilk 10.000 satır 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ç satır 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ö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ı. 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 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 boyuta countryAndCity diyebilirsiniz. Seçtiğiniz boyut adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Boyutlara dimensionFilter, orderBys, dimensionExpression ve pivots içinde 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(boyut) 2) concatenate(boyut1, simge, boyut2).

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 içinde 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).
Karşılıklı olarak hariç tutulan 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 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, boyut 1 değeri = "US,FR", boyut 2 değeri = "JP" ve sınırlayıcı = "," ise yanıtta "US,FR,JP" yer alır.

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

Metrikler, metricFilter, orderBys ve metrik expression'te name ile 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 zamanı 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 zamanı 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 
{

  // 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 içinde en fazla bir alan ayarlanır:
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.
Karşılıklı olarak hariç tutulan 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 içinde 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ındaki verileri filtrelemek için kullanılır.
emptyFilter

object (EmptyFilter)

"(not set)" ve "" değerleri gibi boş değerler için filtre.
Karşılıklı olarak hariç tutulan 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ğ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 
{

  // 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 içinde en fazla bir alan ayarlanır:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer
Karşılıklı olarak hariç tutulan alanların sonu.

BetweenFilter

Sonucun iki sayı arasında (bu sayılar dahil) olması gerektiğini ifade etmek 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,

  // 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 içinde 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.
Karşılıklı olarak hariç tutulan 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 boyut değerlerini sıralamak için kullanılan 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 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", 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 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, haftalık bir zaman serisi gösterilebilir. Örneğin, uygulamanız bu kohortun% 60'ını üç hafta sonra, %25'ini ise altı hafta sonra elde tutmuş olabilir. 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 telafi 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, dateRange içinde tanımlanan başlangıç tarihi ile bitiş tarihi arasında ilk etkileşim tarihi 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üzeyi 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 tarihi aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlar, edinme işleminden sonraki kohort verilerini içerir.

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

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

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

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

granularity, MONTHLY ise genişletilmiş raporlama tarih aralığının endDate, grubun 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. Genellikle, grubun dateRange süresi bir ay olduğunda ve istek cohortNthMonth içerdiğinde 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ırların 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ırın tamamındaki verilere 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.