- Kaynak: ReportTask
- ReportDefinition
- Boyut
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- Metrik
- DateRange
- FilterExpression
- FilterExpressionList
- Filtrele
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- İşlem
- NumericValue
- BetweenFilter
- MetricAggregation
- OrderBy
- MetricOrderBy
- DimensionOrderBy
- OrderType
- CohortSpec
- Grup
- CohortsRange
- Ayrıntı düzeyi
- CohortReportSettings
- ReportMetadata
- Durum
- Yöntemler
Kaynak: ReportTask
Belirli bir rapor görevi yapılandırması.
JSON gösterimi |
---|
{ "name": string, "reportDefinition": { object ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Tanımlayıcı. Oluşturma sırasında atanan rapor görevi kaynağı adı. Biçim: "properties/{property}/reportTasks/{reportTask}" |
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 |
Yalnızca çıkış. Belirli bir rapor görevinin rapor meta verileridir. Bir rapor hakkında bilgi sağlar. Genellikle şu 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 ( |
Alanlar | |
---|---|
dimensions[] |
İsteğe bağlı. İstenen ve görüntülenen boyutlar. |
metrics[] |
İsteğe bağlı. İstenen ve gösterilen metrikler. |
dateRanges[] |
İ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 |
dimensionFilter |
İsteğe bağlı. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek üzere örnekler için Boyut Filtrelerinin Temelleri bölümüne bakın. Bu filtrede metrikler kullanılamaz. |
metricFilter |
İsteğe bağlı. Metriklerin filtre koşulu. Rapordaki satırlar toplandıktan sonra, SQL sahip tümcesine benzer şekilde uygulanır. Boyutlar bu filtrede kullanılamaz. |
offset |
İsteğe bağlı. Google Analytics Depolama Alanı'ndaki başlangıç satırının satır sayısı. İlk satır, 0. satır olarak sayılır. Bir rapor görevi oluştururken |
limit |
İsteğe bağlı. Raporda döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 250.000 satır döndürür. Ayrıca, |
metricAggregations[] |
İsteğe bağlı. Metriklerin toplanması. Toplu metrik değerleri, boyutValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
İsteğe bağlı. Satırların yanıtta nasıl sıralandığını belirtir. |
currencyCode |
İsteğe bağlı. ISO4217 biçiminde, "AED", "USD", "JPY" gibi bir para birimi kodu. Alan boşsa raporda mülkün varsayılan para birimi kullanılır. |
cohortSpec |
İsteğe bağlı. Bu istekle ilişkili grup grubu. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır. |
keepEmptyRows |
İsteğe bağlı. Yanlış veya belirtilmediyse tüm metriklerin 0'a eşit olduğu her bir satır döndürülmez. Doğru değerine ayarlanırsa bu satırlar, bir filtre tarafından ayrı olarak kaldırılmadıklarında döndürülür. Bu Örneğin, bir mülk hiçbir zaman |
Boyut
Boyutlar verilere ilişkin özelliklerdir. Örneğin "şehir" boyutu, bir etkinliğin kaynağı olan şehri belirtir. Rapor yanıtlarındaki boyut değerleri dizedir; Örneğin, şehir "Ankara" olabilir. "İstanbul".
JSON gösterimi |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Alanlar | |
---|---|
name |
Boyutun adı.
|
dimensionExpression |
Bir boyut, birden fazla boyut ifadesinin sonucu olabilir. Örneğin, "ülke, şehir": concatenate(ülke, ", ", şehir). |
DimensionExpression
Birden fazla boyuta sahip bir formülün sonucu olan boyutu ifade etmek için kullanılır. Örnek kullanımlar: 1) Küçük harf(boyut) 2) bitişik(boyut1, simge, boyut2).
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı one_expression . DimensionExpression için bir boyut ifadesi türü belirtin. one_expression şunlardan yalnızca biri olabilir: |
|
lowerCase |
Boyut değerini küçük harfe dönüştürmek için kullanılır. |
upperCase |
Bir boyut değerini büyük harfe dönüştürmek için kullanılır. |
concatenate |
Boyut değerlerini tek bir boyutla birleştirmek için kullanılır. Örneğin, "ülke, şehir": concatenate(ülke, ", ", şehir). |
CaseExpression
Boyut değerini tek bir büyük/küçük harfe dönüştürmek için kullanılır.
JSON gösterimi |
---|
{ "dimensionName": string } |
Alanlar | |
---|---|
dimensionName |
Bir boyutun adı. Ad, isteğin boyutlar alanındaki bir adı ifade etmelidir. |
ConcatenateExpression
Boyut değerlerini tek bir boyutla birleştirmek için kullanılır.
JSON gösterimi |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
Alanlar | |
---|---|
dimensionNames[] |
Boyutların adları. Adlar, isteğin boyutlar alanındaki adlara tekrar atıfta bulunmalıdır. |
delimiter |
Boyut adları arasına yerleştirilen ayırıcı. Ayırıcılar genellikle "|" gibi tek karakterlerden oluşur veya "," ancak daha uzun dizeler olabilir. Sınırlayıcı bir boyut değeri içeriyorsa her ikisi de hiçbir ayrım olmadan yanıtta mevcut olacaktır. Örneğin boyut 1 değer = "US,FR", boyut 2 değer = "JP" ve ayırıcı = "," ise yanıt "US,FR,JP" ifadesini içerir. |
Metrik
Bir raporun nicel ölçümleri. Örneğin, eventCount
metriği toplam etkinlik sayısını ifade eder. İstekler için en fazla 10 metriğe izin verilir.
JSON gösterimi |
---|
{ "name": string, "expression": string, "invisible": boolean } |
Alanlar | |
---|---|
name |
Metriğin adı.
Metriklere |
expression |
Türetilen metrikler için matematiksel ifade. Örneğin, kullanıcı başına etkinlik sayısı metriği |
invisible |
Bir metriğin rapor yanıtında görünmez olup olmadığını belirtir. Bir metrik görünmezse yanıtta sütun oluşturmaz, ancak |
DateRange
Kesintisiz bir gün grubu: startDate
, startDate + 1
, ..., endDate
. İsteklere en fazla 4 tarih aralığına izin verilir.
JSON gösterimi |
---|
{ "startDate": string, "endDate": string, "name": string } |
Alanlar | |
---|---|
startDate |
Sorgunun |
endDate |
Sorgunun |
name |
Bu tarih aralığına bir ad atar. |
FilterExpression
Boyut veya metrik filtrelerini ifade etmek için. AynıFilterExpression'daki alanların tüm boyutlar veya tüm metrikler olması gerekir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı expr . FilterExpression için bir filtre ifadesi türü belirtin. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
andGroup'taki Filtre İfadeleri'nin bir VE ilişkisi vardır. |
orGroup |
orGroup'taki Filtre İfadeleri'nin bir VEYA ilişkisi vardır. |
notExpression |
filterExpression, notExpression DEĞİL. |
filter |
Temel filtre. Aynı Filtre İfadesi'nde, 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 ( |
Alanlar | |
---|---|
expressions[] |
Filtre ifadelerinin listesi. |
Filtre
Boyut veya metrik değerlerini filtrelemek için kullanılan bir ifade.
JSON gösterimi |
---|
{ "fieldName": string, // Union field |
Alanlar | |
---|---|
fieldName |
Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanan bir ad olmalıdır. |
Birleştirme alanı one_filter . Filter için bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerleri filtresi. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasında bir filtre. |
StringFilter
Dize filtresi
JSON gösterimi |
---|
{
"matchType": enum ( |
Alanlar | |
---|---|
matchType |
Bu filtre için eşleme türü. |
value |
Eşleşme için kullanılan dize değeri. |
caseSensitive |
True (doğru) ise 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 |
Dize değerine sahip normal ifade için tam eşleşme. |
PARTIAL_REGEXP |
Normal ifade için dize değeriyle kısmi eşleşme. |
InListFilter
Sonucun, dize değerleri listesinde olması gerekir.
JSON gösterimi |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Alanlar | |
---|---|
values[] |
Dize değerlerinin listesi. Boş bırakılamaz. |
caseSensitive |
True (doğru) ise dize değeri büyük/küçük harfe duyarlıdır. |
NumericFilter
Sayısal değerler veya tarih değerleri için filtreler.
JSON gösterimi |
---|
{ "operation": enum ( |
Alanlar | |
---|---|
operation |
Bu filtre için işlem türü. |
value |
Sayısal bir değer veya tarih değeri. |
İşlem
Bir sayısal filtreye uygulanan işlem
Sıralamalar | |
---|---|
OPERATION_UNSPECIFIED |
Belirtilmedi. |
EQUAL |
Eşit |
LESS_THAN |
Küçüktür |
LESS_THAN_OR_EQUAL |
Küçük veya eşittir |
GREATER_THAN |
Şundan büyük: |
GREATER_THAN_OR_EQUAL |
Büyüktür veya eşittir |
NumericValue
Bir sayıyı temsil eder.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı one_value . one_value sayısal değerlerinden biri, aşağıdakilerden yalnızca biri olabilir: |
|
int64Value |
Tam sayı değeri |
doubleValue |
Çift değer |
BetweenFilter
Sonucun iki sayı (her iki sayı da dahil) arasında olması gerektiğini belirtmek için.
JSON gösterimi |
---|
{ "fromValue": { object ( |
Alanlar | |
---|---|
fromValue |
Bu sayıyla başlar. |
toValue |
Bu sayıyla biter. |
MetricAggregation
Metriklerin toplamını gösterir.
Sıralamalar | |
---|---|
METRIC_AGGREGATION_UNSPECIFIED |
Belirtilmemiş operatör. |
TOTAL |
SUM operatörü. |
MINIMUM |
Minimum operatör. |
MAXIMUM |
Maksimum operatör. |
COUNT |
Sayı operatörü. |
Sıralama Ölçütü
Sıralama ölçütü, satırların yanıtta nasıl sıralanacağını tanımlar. Örneğin, satırları azalan etkinlik sayısına göre sıralamak tek bir sıralamadır. Satırları etkinlik adı dizesine göre sıralamak ise farklı bir sıralamadır.
JSON gösterimi |
---|
{ "desc": boolean, // Union field |
Alanlar | |
---|---|
desc |
True (doğru) ise azalan düzende sıralar. |
Birleştirme alanı one_order_by . OrderBy için ölçütüne göre bir sipariş türü belirtin. one_order_by şunlardan yalnızca biri olabilir: |
|
metric |
Sonuçları metrik değerlerine göre sıralar. |
dimension |
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 |
Sıralama ölçütü isteğindeki metrik adı. |
DimensionOrderBy
Boyut değerlerine göre sıralar.
JSON gösterimi |
---|
{
"dimensionName": string,
"orderType": enum ( |
Alanlar | |
---|---|
dimensionName |
Sıralama ölçütü isteğindeki boyut adı. |
orderType |
Boyut değeri sıralaması kuralını kontrol eder. |
OrderType
Dize boyutu değerlerini sıralama 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 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, SAYISAL sıralamada, "25" < "100" ve ALPHANUMERIC sıralamasında "100" < "25". Sayısal olmayan boyut değerlerinin tümünün, tüm sayısal değerlerin altında eşit sıralama değeri vardır. |
CohortSpec
Bir grup raporu için kohortların spesifikasyonu.
Grup raporları, grup için bir zaman serisi kullanıcıları elde tutma işlemi oluşturur. Örneğin, Eylül'ün ilk haftasında edinilen kullanıcı kohortunu seçebilir ve bu kohortu sonraki altı hafta boyunca takip edebilirsiniz. Eylül grubunun ilk haftasında edinilen kullanıcıların seçilmesi cohort
nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortun devamı cohortsRange
nesnesinde belirtilir.
Örnekler için Kohort Raporu Örnekleri bölümüne bakın.
Rapor yanıtında, uygulamanızın üç hafta sonra bu grubun% 60'ını, altı hafta sonra da bu kohortun% 25'ini koruduğunu belirten bir haftalık zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers
metriğiyle hesaplanabilir ve raporda ayrı satırlar olur.
JSON gösterimi |
---|
{ "cohorts": [ { object ( |
Alanlar | |
---|---|
cohorts[] |
Kullanıcıları kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar. Çoğu kohort raporu yalnızca tek bir kohort tanımlar. Birden fazla kohort belirtilirse her kohort raporda adlarıyla tanınabilir. |
cohortsRange |
Kohort raporları, geniş bir raporlama tarih aralığı boyunca kohortları takip eder. Bu aralık, kohortların takip edileceği ofset süresini belirtir. |
cohortReportSettings |
Grup raporu için isteğe bağlı ayarlar. |
Kohort
Kohort seçim ölçütü tanımlar. Kohort, ortak bir özelliğe sahip kullanıcı grubudur. Örneğin, aynı firstSessionDate
değerine sahip kullanıcılar aynı kohorta dahildir.
JSON gösterimi |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Alanlar | |
---|---|
name |
Bu gruba bir ad atar. |
dimension |
Grup tarafından kullanılan boyut. Zorunludur ve yalnızca |
dateRange |
Grup, ilk temas tarihi Bir kohort isteğinde bu Bu |
CohortsRange
Bir grup raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortların takip edileceği ofset süresini belirtir.
JSON gösterimi |
---|
{
"granularity": enum ( |
Alanlar | |
---|---|
granularity |
Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığı için |
startOffset |
|
endOffset |
Zorunlu.
|
Ayrıntı düzeyi
Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset
ve endOffset
öğelerini yorumlamada kullanılan ayrıntı düzeyi.
Sıralamalar | |
---|---|
GRANULARITY_UNSPECIFIED |
Hiçbir zaman belirtilmemelidir. |
DAILY |
Günlük ayrıntı düzeyi. Genellikle grubun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa kullanılır. |
WEEKLY |
Haftalık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir haftaysa (Pazar günü başlayıp Cumartesi günü sona eren) ve istek cohortNthWeek içeriyorsa kullanılır. |
MONTHLY |
Aylık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir aysa ve istek cohortNthMonth içeriyorsa kullanılır. |
CohortReportSettings
Grup raporunun isteğe bağlı ayarları.
JSON gösterimi |
---|
{ "accumulate": boolean } |
Alanlar | |
---|---|
accumulate |
True (doğru) ise, sonucu ilk temas gününden bitiş gününe kadar toplar. |
ReportMetadata
Belirli bir rapor görevi için rapor meta verileri.
JSON gösterimi |
---|
{
"creationQuotaTokensCharged": integer,
"state": enum ( |
Alanlar | |
---|---|
creationQuotaTokensCharged |
Yalnızca çıkış. Rapor oluşturulurken ücretlendirilen toplam kota jetonları. Bu jeton sayısı |
state |
Yalnızca çıkış. Bu rapor görevinin mevcut durumu. |
beginCreatingTime |
Yalnızca çıkış. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
taskRowCount |
Yalnızca çıkış. Rapor sonucundaki toplam satır sayısı. Bu alan, eyalet etkin olduğunda doldurulur. Mevcut raporunun sınırları içinde sayfalara ayırma işlemi için |
errorMessage |
Yalnızca çıkış. Oluşturma işlemi sırasında bir rapor görevi başarısız olursa hata mesajı doldurulur. |
totalRowCount |
Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun ötesinde ek veri satırlarını sorgulamak istiyorsanız bu raporlar,
Örneğin, geçerli raporun |
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, CreateRapor çağrısından hemen sonra gerçekleşir. |
ACTIVE |
Rapor tamamen oluşturuldu ve sorgulanmaya hazır. |
FAILED |
Rapor oluşturulamadı. |
Yöntemler |
|
---|---|
|
Rapor görevi oluşturma işlemini başlatır. |
|
Belirli bir rapor göreviyle ilgili rapor meta verilerini alır. |
|
Bir mülke ait tüm rapor görevlerini listeler. |
|
Rapor görevinin içeriğini alır. |