- Kaynak: ReportTask
- ReportDefinition
- Boyut
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- Metrik
- DateRange
- FilterExpression
- FilterExpressionList
- Filtrele
- StringFilter
- MatchType
- InListFilter
- NumericFilter (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ış. Bir rapor hakkında bilgi sağlayan, belirli bir rapor görevi için rapor meta verileri. 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 eklenir. Grup 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 için Boyut Filtreleriyle İlgili Temel Bilgiler başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz. |
metricFilter |
İsteğe bağlı. Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde, raporun satırları toplandıktan sonra 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ı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. Ayrıca, |
metricAggregations[] |
İsteğe bağlı. Metriklerin toplamı. Toplu metrik değerleri,dimensionValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
İsteğe bağlı. Yanıtta satırların nasıl sıralandığını belirtir. |
currencyCode |
İsteğe bağlı. "AED", "USD", "JPY" gibi ISO4217 biçiminde bir para birimi kodu. Alan boşsa rapor mülkün varsayılan para birimini kullanır. |
cohortSpec |
İsteğe bağlı. Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır. |
keepEmptyRows |
İsteğe bağlı. Yanlış veya belirtilmemişse 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ılmazsa döndürülür. Bu Örneğin bir mülk hiçbir zaman |
Boyut
Boyutlar verilere ilişkin özelliklerdir. Örneğin, şehir boyutu etkinliğin gerçekleştiği şehri belirtir. Rapor yanıtlarındaki boyut değerleri dizedir. Örneğin, şehir "Paris" veya "New York" olabilir.
JSON gösterimi |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Alanlar | |
---|---|
name |
Boyutun adı.
Boyutlara |
dimensionExpression |
Bir boyut, birden fazla boyut ifadesinin bir sonucu olabilir. Örneğin, "ülke, şehir" boyutu: bitiştir(ülke, ", ", şehir). |
DimensionExpression
Birden fazla boyut formülünün sonucu olan bir boyutu ifade etmek için kullanılır. Örnek kullanımlar: 1) küçük harf(boyut) 2) bitiş(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 |
Bir 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 boyut olarak birleştirmek için kullanılır. Örneğin, "ülke, şehir" boyutu: bitiştir(ülke, ", ", şehir). |
CaseExpression
Bir 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 |
Boyut adı. Ad, tekrar isteğin boyutlar alanındaki bir ada karşılık gelmelidir. |
ConcatenateExpression
Boyut değerlerini tek bir boyut olarak 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 geri dönmelidir. |
delimiter |
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 sınırlayıcıyı içeriyorsa, her iki değer de herhangi bir ayrım olmadan yanıt olarak mevcut olur. Örneğin boyut 1 değeri = "US,FR", boyut 2 değeri = "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ıdır. İ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
Bitişik bir gün grubu: startDate
, startDate + 1
, ..., endDate
. İstekler için 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ı FiltreExpression'daki alanlar, tüm boyutlar veya tüm metrikler olmalıdır.
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 içindeki FilterExpressions, VE ilişkisine sahip. |
orGroup |
orGroup içindeki FilterExpressions'ın VEYA ilişkisi var. |
notExpression |
FilterExpression, notExpression'tan DEĞİLDİR. |
filter |
Temel bir filtre. Aynı filterExpression'da, filtrenin tüm alan adlarının ya bütün 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ğerlerinde için bir filtre. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasındaki filtre. |
StringFilter
Dize filtresi
JSON gösterimi |
---|
{
"matchType": enum ( |
Alanlar | |
---|---|
matchType |
Bu filtrenin eşleme türü. |
value |
Eşleşme için kullanılan dize değeri. |
caseSensitive |
Değer true 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 |
Dize değerine sahip normal ifade için tam eşleşme. |
PARTIAL_REGEXP |
Normal ifade için dize değerine sahip 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ş olmamalıdır. |
caseSensitive |
Değer true ise dize değeri büyük/küçük harfe duyarlıdır. |
NumericFilter
Sayısal değerlere veya tarih değerlerine ilişkin filtreler.
JSON gösterimi |
---|
{ "operation": enum ( |
Alanlar | |
---|---|
operation |
Bu filtrenin işlem türü. |
value |
Sayısal bir değer veya tarih değeridir. |
İş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üçük veya eşit |
GREATER_THAN |
Büyüktür |
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ğerinden yalnızca biri aşağıdakilerden biri olabilir: |
|
int64Value |
Tam sayı değeri |
doubleValue |
Çift değer |
BetweenFilter
Sonucun iki sayı (dahil) arasında olması gerektiğini ifade etmek.
JSON gösterimi |
---|
{ "fromValue": { object ( |
Alanlar | |
---|---|
fromValue |
Bu sayıyla başlar. |
toValue |
Bu numarayla biter. |
MetricAggregation
Metriklerin toplamını ifade eder.
Sıralamalar | |
---|---|
METRIC_AGGREGATION_UNSPECIFIED |
Belirtilmemiş operatör. |
TOTAL |
SUM operatörü. |
MINIMUM |
Minimum operatör. |
MAXIMUM |
Maksimum operatör. |
COUNT |
Sayı operatörü. |
OrderBy
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 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) değerine ayarlanırsa azalan düzene göre sıralar. |
Birleştirme alanı one_order_by . OrderBy için bir sipariş türü belirtin. one_order_by şunlardan yalnızca biri olabilir: |
|
metric |
Sonuçları bir metriğin 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 isteğindeki metrik adı. |
DimensionOrderBy
Boyut değerlerine göre sıralar.
JSON gösterimi |
---|
{
"dimensionName": string,
"orderType": enum ( |
Alanlar | |
---|---|
dimensionName |
Sıralama 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 harfli 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ıralamadan önce sayılara dönüştürülür. Örneğin, SAYISAL sıralamada "25" < "100", ALPHANUMERIC sıralamada "100" < "25" şeklinde. Sayısal olmayan boyut değerlerinin hepsi, tüm sayısal değerlerin altında eşit sıralama değerine sahiptir. |
CohortSpec
Kohort raporu için kohortların spesifikasyonu.
Kohort raporları, grup için kullanıcıları elde tutma ile ilgili bir zaman serisi oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı grubunu seçebilir ve sonraki altı hafta boyunca bu grubu takip edebilirsiniz. Eylül kohortunun ilk haftasında edinilen kullanıcıların seçilmesi cohort
nesnesinde belirtilir. Sonraki altı hafta için bu kohortun ardından, cohortsRange
nesnesinde belirtilir.
Örnekler için Kohort Raporu Örnekleri'ni inceleyin.
Rapor yanıtı, uygulamanızın üç hafta sonra bu kohortun% 60'ını ve altı hafta sonra bu kohortun% 25'ini elinde tuttuğunu belirten haftalık bir zaman serisi gösterebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers
metriği ile hesaplanabilir ve rapordaki ayrı satırlar olarak gösterilir.
JSON gösterimi |
---|
{ "cohorts": [ { object ( |
Alanlar | |
---|---|
cohorts[] |
Kullanıcıları kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar. Çoğu grup raporu yalnızca bir kohortu tanımlar. Birden çok kohort belirtilirse her kohort raporda adıyla tanınabilir. |
cohortsRange |
Grup raporları, daha geniş bir raporlama tarih aralığı boyunca grupları takip eder. Bu aralık, kohortların takip edilmesi için bir ofset süresi belirtir. |
cohortReportSettings |
Grup raporu için isteğe bağlı ayarlar. |
Kohort
Kohort seçim ölçütü 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 ( |
Alanlar | |
---|---|
name |
Bu gruba bir ad atar. |
dimension |
Grup tarafından kullanılan boyut. Zorunludur ve yalnızca |
dateRange |
Grup, ilk temas tarihi Kohort isteğinde bu Bu |
CohortsRange
Grup raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortların takip edilmesi için bir ofset süresi belirtir.
JSON gösterimi |
---|
{
"granularity": enum ( |
Alanlar | |
---|---|
granularity |
Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığına ait |
startOffset |
|
endOffset |
Zorunlu.
|
Ayrıntı düzeyi
Grup raporunun genişletilmiş raporlama tarih aralığına ait startOffset
ve endOffset
değerlerini yorumlamak için kullanılan ayrıntı düzeyi.
Sıralamalar | |
---|---|
GRANULARITY_UNSPECIFIED |
Hiçbir zaman belirtilmemelidir. |
DAILY |
Günlük ayrıntı düzeyi. Grubun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa genellikle kullanılır. |
WEEKLY |
Haftalık ayrıntı düzeyi. Grubun dateRange değeri bir haftaysa (Pazar günü başlayıp Cumartesi günü sona erer) ve istek cohortNthWeek değerini içeriyorsa genellikle kullanılır. |
MONTHLY |
Aylık ayrıntı düzeyi. Grubun dateRange değeri bir ayysa ve istek cohortNthMonth içeriyorsa genellikle kullanılır. |
CohortReportSettings
Grup raporunun isteğe bağlı ayarları.
JSON gösterimi |
---|
{ "accumulate": boolean } |
Alanlar | |
---|---|
accumulate |
Doğru değerine ayarlanırsa ilk temas gününden bitiş gününe kadar sonucu toplar. |
ReportMetadata
Belirli bir rapor görevi için rapor meta verileri.
JSON gösterimi |
---|
{
"creationQuotaTokensCharged": integer,
"state": enum ( |
Alanlar | |
---|---|
creationQuotaTokensCharged |
Yalnızca çıkış. Raporun oluşturulması sırasında alınan toplam kota jetonları. Bu jeton sayısı |
state |
Yalnızca çıkış. Bu rapor görevinin mevcut durumu. |
beginCreatingTime |
Yalnızca çıkış. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
taskRowCount |
Yalnızca çıkış. Rapor sonucundaki toplam satır sayısı. Bu alan, eyalet etkin olduğunda doldurulur. Mevcut raporun sınırları içinde sayfalandırma için |
errorMessage |
Yalnızca çıkış. Bir rapor görevi oluşturma sırasında başarısız olursa hata mesajı doldurulur. |
totalRowCount |
Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun dışında ek veri satırlarını sorgulamak istiyorsanız bu satırlar
Ö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 sunulacaktır. Oluşturma işlemi, CreateReport ç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ülk için tüm rapor görevlerini listeler. |
|
Bir rapor görevinin içeriğini alır. |