Method: reports.batchGet

Analytics verilerini döndürür.

HTTP isteği

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
Alanlar
reportRequests[]

object(ReportRequest)

İstekler için her isteğin ayrı bir yanıtı olur. En fazla 5 istek olabilir. Tüm istekler aynı dateRanges, viewId, segments, samplingLevel ve cohortGroup değerine sahip olmalıdır.

useResourceQuotas

boolean

Kaynak tabanlı kotaları etkinleştirir (varsayılan olarak False). Bu alan True değerine ayarlanırsa görüntüleme başına (profil) kotalar, isteğin işlem maliyetine göre yönetilir. Maliyete dayalı kotalar kullanıldığında örnekleme oranlarının daha yüksek olacağını unutmayın. (SMALL için 10 milyon, LARGE için 100 milyon. Ayrıntılar için sınırlar ve kotalar belgelerine bakın.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Reporting API batchGet çağrısına ait raporların tutulduğu ana yanıt sınıfı.

JSON gösterimi 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
Alanlar
reports[]

object(Report)

Her bir isteğe karşılık gelen yanıtlar.

queryCost

number

Sorguyu yürütmek için düşülen kaynak kota jetonlarının miktarı. Tüm yanıtları içerir.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

Mülk için kalan kaynak kotası miktarı.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ReportRequest

Reporting API isteğini belirten ana istek sınıfı.

JSON gösterimi 
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
Alanlar
viewId

string

Verilerin alınacağı Analytics görünüm kimliği. Bir batchGet yöntemindeki her ReportRequest, aynı viewId değerini içermelidir.

dateRanges[]

object(DateRange)

İstekteki tarih aralıkları. İstekte en fazla 2 tarih aralığı olabilir. Yanıt, istekteki her tarih aralığına ilişkin boyutların her kombinasyonu için bir metrik değer grubu içerir. Dolayısıyla, iki tarih aralığı varsa biri orijinal tarih aralığı için, diğeri ikinci tarih aralığı için olmak üzere iki metrik değeri grubu olur. Kohortlar veya Yaşam boyu değer istekleri için reportRequest.dateRanges alanı belirtilmemelidir. Tarih aralığı belirtilmemişse varsayılan tarih aralığı şu şekildedir: (startDate: geçerli tarih - 7 gün, endDate: geçerli tarih - 1 gün). Bir batchGet yöntemindeki her ReportRequest, aynı dateRanges tanımını içermelidir.

samplingLevel

enum(Sampling)

İstenen rapor örneği boyutu. samplingLevel alanı belirtilmemişse DEFAULT örnekleme düzeyi kullanılır. Bir batchGet yöntemindeki her ReportRequest, aynı samplingLevel tanımını içermelidir. Ayrıntılar için geliştirici kılavuzuna bakın.

dimensions[]

object(Dimension)

İstenen boyutlar. İsteklerin toplam 9 boyutu olabilir.

dimensionFilterClauses[]

object(DimensionFilterClause)

Boyut Değerlerini filtrelemek için boyut filtresi koşulları. Bunlar mantıksal olarak AND operatörüyle birleştirilir. Filtrelemenin herhangi bir boyut toplanmadan önce gerçekleştiğini, bu nedenle döndürülen metriklerin yalnızca alakalı boyutların toplamı temsil ettiğini unutmayın.

metrics[]

object(Metric)

İstenen metrikler. İstekler en az bir metrik belirtmelidir. İsteklerin toplam 10 metriği olabilir.

metricFilterClauses[]

object(MetricFilterClause)

Metrik filtresi koşulları. Bunlar mantıksal olarak AND operatörüyle birleştirilir. Metrik filtreleri, karşılaştırma tarih aralığını değil, yalnızca ilk tarih aralığını dikkate alır. Metriklere göre filtrelemenin, metrikler toplandıktan sonra gerçekleştiğini unutmayın.

filtersExpression

string

İsteğiniz için döndürülen verileri kısıtlayan boyut veya metrik filtreleri. filtersExpression özelliğini kullanmak için filtre uygulanacak bir boyut veya metrik ve ardından filtre ifadesini girin. Örneğin, aşağıdaki ifade Firefox ile başlayan ga:browser boyutunu seçer; ga:browser=~^Firefox. Boyutlar ve metrik filtreleri hakkında daha fazla bilgi için Filtreler referansı başlıklı makaleyi inceleyin.

orderBys[]

object(OrderBy)

Çıkış satırlarında sıralama düzeni. İki satırı karşılaştırmak için aşağıdaki öğeler bir fark bulunana kadar sırayla uygulanır. Çıkıştaki tüm tarih aralıkları aynı satır sırasını alır.

segments[]

object(Segment)

İstek için döndürülen verileri segmentlere ayırın. Segment tanımı, segment isteğinin bir alt kümesinin incelenmesine yardımcı olur. Bir istek en fazla dört segment içerebilir. Bir batchGet yöntemindeki her ReportRequest, aynı segments tanımını içermelidir. Segment içeren isteklerin ga:segment boyutu olmalıdır.

pivots[]

object(Pivot)

Pivot tablo tanımları. İsteklerde en fazla 2 pivot olabilir.

cohortGroup

object(CohortGroup)

Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa ga:cohort boyutu bulunmalıdır. Bir batchGet yöntemindeki her ReportRequest, aynı cohortGroup tanımını içermelidir.

pageToken

string

Sonuçların sonraki sayfasını almak için bir devam jetonu. Bu anahtarın isteğe eklenmesi, pageToken öğesinden sonraki satırları döndürür. pageToken, reports.batchGet isteğine verilen yanıttaki nextPageToken parametresinde döndürülen değer olmalıdır.

pageSize

number

Sayfa boyutu, sayfalama içindir ve döndürülen maksimum satır sayısını belirtir. Sayfa boyutu en az 0 olmalıdır. Bir sorgu,1.000 satırlık varsayılan değeri döndürür. Analytics Temel Raporlama API'si, istediğiniz satır sayısı ne olursa olsun istek başına maksimum 100.000 satır döndürür. Ayrıca, beklediğiniz sayıda boyut segmenti yoksa istenenden daha az satır döndürebilir. Örneğin, ga:country için 300'den az olası değer vardır. Bu nedenle, yalnızca ülkeye göre segmentlere ayırma işlemi yaparken pageSize öğesini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

includeEmptyRows

boolean

Yanlış değerine ayarlanırsa alınan tüm metrikler sıfıra eşitse yanıt satır içermez. Varsayılan olarak false, bu satırları hariç tutar.

hideTotals

boolean

Doğru değerine ayarlanırsa her tarih aralığı için eşleşen satırların tamamında metriklerin toplamını gizler. Varsayılan değer yanlıştır ve toplamları döndürür.

hideValueRanges

boolean

True (doğru) değerine ayarlanırsa eşleşen tüm satırlarda minimum ve maksimum değerleri gizler. Varsayılan değer false (yanlış) şeklindedir ve değer aralıkları döndürülür.

Örneklendirme

Örnekleme seviyesi değerleri.

Sıralamalar
SAMPLING_UNSPECIFIED samplingLevel alanı belirtilmezse DEFAULT örnekleme düzeyi kullanılır.
DEFAULT Hız ve doğruluğu dengeleyen bir örnek boyutuyla yanıt döndürür.
SMALL Daha küçük bir örnekleme boyutuyla hızlı yanıt döndürür.
LARGE Büyük bir örnekleme boyutu kullanarak daha doğru bir yanıt döndürür. Ancak bu, yanıtın daha yavaş olmasına neden olabilir.

Boyut

Boyutlar, verilerinizin özellikleridir. Örneğin ga:city boyutu, oturumun hangi şehirden (ör. "Ankara" veya "İstanbul") başlatıldığını gösterir.

JSON gösterimi 
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
Alanlar
name

string

Getirilecek boyutun adı (örneğin, ga:browser).

histogramBuckets[]

string (int64 format)

Boş değilse, boyut değerlerini int64 dizesinden sonra gruplara yerleştiririz. Bir integral değerin dize gösterimi olmayan boyut değerleri sıfıra dönüştürülür. Grup değerlerinin artan sırada olması gerekir. Her bir paket alt uçta kapalı, üst uçta açılır. "İlk" bölüm, ilk sınırdan küçük olan tüm değerleri, "son" grup ise sonsuza kadar olan tüm değerleri içerir. Bir pakette yer alan boyut değerleri yeni bir boyut değerine dönüştürülür. Örneğin, biri "0, 1, 3, 4, 7" listesi verirse aşağıdaki grupları döndürürüz:

  • 1. grup: değerler < 0, boyut değeri "<0"
  • 2. paket: [0,1 içinde değerler), boyut değeri "0"
  • 3. grup: [1,3" içindeki değerler), boyut değeri "1-2"
  • 4. paket: [3,4" içindeki değerler), boyut değeri "3"
  • 5. grup: [4,7" içindeki değerler), boyut değeri "4-6"
  • 6. grup: değerler >= 7, boyut değeri "7+"

NOT: Herhangi bir boyuta histogram değişikliği uyguluyorsanız ve bu boyutu sıralamada kullanıyorsanız bu amaç için HISTOGRAM_BUCKET sıralama türünü kullanmanız gerekir. Aksi takdirde, boyut değerleri sözlük (sözlük) düzenine göre sıralanır. Örneğin, artan sözlük sırası şöyledir:

"<50", "1001+", "121-1000", "50-120"

Ve artan HISTOGRAM_BUCKET sırası:

"<50", "50-120", "121-1000", "1001+"

İstemcinin, açıkça histogram değiştirilmiş bir boyut için "orderType": "HISTOGRAM_BUCKET" isteğinde bulunması gerekir.

DimensionFilterClause

Boyut filtreleri grubu. Filtrelerin mantıksal olarak nasıl birleştirileceğini belirtmek için operatör değerini ayarlayın.

JSON gösterimi 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
Alanlar
operator

enum(FilterLogicalOperator)

Birden fazla boyut filtresini birleştirme operatörü. Belirtilmemesi halinde OR olarak kabul edilir.

filters[]

object(DimensionFilter)

Tekrarlanan filtre grubu. Bunlar, belirtilen operatöre göre mantıksal olarak birleştirilir.

FilterLogicalOperator

Filtrelerin mantıksal olarak nasıl birleştirildiği.

Sıralamalar
OPERATOR_UNSPECIFIED Belirtilmemiş operatör. Bu, OR olarak ele alınır.
OR Mantıksal OR operatörü.
AND Mantıksal AND operatörü.

DimensionFilter

Boyut filtresi, bir boyuttaki filtreleme seçeneklerini belirtir.

JSON gösterimi 
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
Alanlar
dimensionName

string

Filtre uygulanacak boyut. DimensionFilter bir boyut içermelidir.

not

boolean

Mantıksal NOT operatörü. Bu boole doğru değerine ayarlanırsa eşleşen boyut değerleri raporda hariç tutulur. Varsayılan, false (yanlış) değeridir.

operator

enum(Operator)

Boyutu ifadeyle eşleştirme. Varsayılan değer REGEXP'dir.

expressions[]

string

Eşleştirilecek dizeler veya normal ifade. Operatör IN_LIST olmadığı sürece karşılaştırma için yalnızca listenin ilk değeri kullanılır. IN_LIST operatörü varsa boyutları IN_LIST operatörünün açıklamasında açıklandığı gibi filtrelemek için listenin tamamı kullanılır.

caseSensitive

boolean

Eşleşme büyük/küçük harfe duyarlı olmalı mı? Varsayılan değer, false (yanlış) değeridir.

Operatör

Farklı eşleme türleri desteklenir.

Sıralamalar
OPERATOR_UNSPECIFIED Eşleme türü belirtilmezse REGEXP olarak değerlendirilir.
REGEXP Eşleşme ifadesi, normal bir ifade olarak değerlendirilir. Eşleme türlerinin hiçbiri normal ifade olarak kabul edilmez.
BEGINS_WITH Sağlanan eşleşme ifadesiyle başlayan değerle eşleşir.
ENDS_WITH Sağlanan eşleşme ifadesiyle biten değerleri eşleştirir.
PARTIAL Alt dize eşleşiyor.
EXACT Değer, eşleşme ifadesiyle tamamen eşleşmelidir.
NUMERIC_EQUAL

Tam sayı karşılaştırma filtreleri. Bunlar için büyük/küçük harfe duyarlılık dikkate alınmaz ve ifadenin bir tam sayıyı temsil eden bir dize olduğu varsayılır. Hata koşulları:

  • İfade geçerli bir int64 değilse istemci, bir hata beklemelidir.
  • Geçerli int64 değeri olmayan giriş boyutları hiçbir zaman filtreyle eşleşmez.
NUMERIC_GREATER_THAN Boyutun, eşleşme ifadesinden sayısal olarak büyük olup olmadığını kontrol eder. Kısıtlamalar için NUMERIC_EQUALS açıklamasını okuyun.
NUMERIC_LESS_THAN Boyutun, eşleşme ifadesinden sayısal olarak küçük olup olmadığını kontrol eder. Kısıtlamalar için NUMERIC_EQUALS açıklamasını okuyun.
IN_LIST

Bu seçenek, ifadesi seçilen bir değer listesinden herhangi bir değer alabilen boyut filtresini belirtmek için kullanılır. Bu, her bir yanıt satırı için VEYA uygulanan birden çok tam eşleme boyut filtresinin değerlendirilmesini önlemeye yardımcı olur. Örneğin:

expressions: ["A", "B", "C"]

Boyutu A, B veya C değerine sahip olan tüm yanıt satırları bu DimensionFilter ile eşleşir.

Metrik

Metrikler, nicel ölçümlerdir. Örneğin ga:users metriği, istenen dönem için toplam kullanıcı sayısını belirtir.

JSON gösterimi 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
Alanlar
expression

string

İstekteki bir metrik ifadesi. Bir ifade, bir veya daha fazla metrik ve sayıdan oluşturulur. Kabul edilen operatörler şunları içerir: Artı (+), Eksi (-), Olumsuz (Birli -), Bölünmüş (/), (*) ile çarpma, Parantez, Pozitif sayı (0-9), ondalık basamakları içerebilir ve 1024 karakterle sınırlıdır. Örnek ga:totalRefunds/ga:users, çoğu durumda metrik ifadesi ga:users gibi tek bir metrik adından ibarettir. Karma MetricType (ör. CURRENCY + PERCENTAGE) metrikleri beklenmedik sonuçlara neden olur.

alias

string

Metrik ifadesinin takma adı, ifade için alternatif bir addır. Takma ad, filtreleme ve sıralama için kullanılabilir. Bu alan isteğe bağlıdır ve ifade tek bir metrik değil de filtreleme ve sıralamada kullanılamayacak karmaşık bir ifade olduğunda kullanışlıdır. Takma ad, yanıt sütunu başlığında da kullanılır.

formattingType

enum(MetricType)

Metrik ifadesinin nasıl biçimlendirilmesi gerektiğini belirtir (örneğin, INTEGER).

MetricType

Metriklerin türleri.

Sıralamalar
METRIC_TYPE_UNSPECIFIED Metrik türü belirtilmedi.
INTEGER Tam sayı metriği.
FLOAT Kayan noktalı metrik.
CURRENCY Para birimi metriği.
PERCENT Yüzde metriği.
TIME HH:MM:SS biçiminde zaman metriği.

MetricFilterClause

Bir metrik filtresi grubunu temsil eder. Filtrelerin mantıksal olarak nasıl birleştirileceğini belirtmek için operatör değerini ayarlayın.

JSON gösterimi 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
Alanlar
operator

enum(FilterLogicalOperator)

Birden çok metrik filtresini birleştirme operatörü. Belirtilmemesi halinde OR olarak kabul edilir.

filters[]

object(MetricFilter)

Tekrarlanan filtre grubu. Bunlar, belirtilen operatöre göre mantıksal olarak birleştirilir.

MetricFilter

MetricFilter, bir metrikteki filtreyi belirtir.

JSON gösterimi 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
Alanlar
metricName

string

Filtrelenecek metrik. MetricFilter bir metrik adı içermelidir. Metrik adı, metrik olarak daha önce tanımlanmış bir takma ad veya metrik ifadesi de olabilir.

not

boolean

Mantıksal NOT operatörü. Bu boole doğru değerine ayarlanırsa eşleşen metrik değerleri raporda hariç tutulur. Varsayılan, false (yanlış) değeridir.

operator

enum(Operator)

EQUAL, LESS_THAN veya GREATER_THAN karşılaştırma değeri, varsayılan EQUAL değeridir. Operatör IS_MISSING ise metriğin eksik olup olmadığını kontrol eder ve Karşılaştırma Değerini yoksayar.

comparisonValue

string

Karşılaştırma değeri.

Operatör

Farklı karşılaştırma türü seçenekleri.

Sıralamalar
OPERATOR_UNSPECIFIED Operatör belirtilmediyse EQUAL olarak kabul edilir.
EQUAL Metriğin değeri karşılaştırma değerine tam olarak eşit olmalı.
LESS_THAN Metriğin değeri karşılaştırma değerinden küçükse.
GREATER_THAN Metriğin değeri karşılaştırma değerinden büyükse.
IS_MISSING Metriğin eksik olup olmadığını doğrular. Karşılaştırmayı dikkate almaz.

OrderBy

Sıralama seçeneklerini belirtir.

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

string

Sıralama ölçütü olarak kullanılacak alan. Varsayılan sıralama düzeni artan düzendir. Örnek: ga:browser. Burada sıralama için yalnızca bir alan belirtebileceğinizi unutmayın. Örneğin, ga:browser, ga:city geçerli değildir.

orderType

enum(OrderType)

Sipariş türü. Varsayılan orderType öğesi VALUE'dir.

sortOrder

enum(SortOrder)

Alan için sıralama düzeni.

OrderType

OrderType, sıralama düzeninin nasıl belirlendiğini kontrol eder.

Sıralamalar
ORDER_TYPE_UNSPECIFIED Belirtilmemiş sipariş türü, değere göre sıralama olarak ele alınır.
VALUE Sıralama düzeni, seçilen sütunun değerine bağlıdır; yalnızca ilk tarih aralığına bakar.
DELTA Sıralama ölçütü, seçilen sütunda ilk iki tarih aralığı arasındaki değerlerin farkına dayanır. Yalnızca tam olarak iki tarih aralığı varsa kullanılabilir.
SMART Sıralama düzeni, seçilen sütunun ağırlıklı değerine bağlıdır. Sütun n/d biçimindeyse bu oranın ağırlıklı değeri (n + totals.n)/(d + totals.d) Yalnızca oranları temsil eden metrikler için kullanılabilir.
HISTOGRAM_BUCKET Histogram sipariş türü yalnızca boş olmayan histogram grupları içeren boyut sütunları için geçerlidir.
DIMENSION_AS_INTEGER Boyutlar sabit uzunluktaki sayılarsa, sıradan sıralama işe yarayacaktır. Boyutlar değişken uzunluktaki sayılarsa DIMENSION_AS_INTEGER kullanılabilir.

SortOrder

Sıralamanın sıralama ölçütü.

Sıralamalar
SORT_ORDER_UNSPECIFIED Sıralama düzeni belirtilmezse varsayılan olarak artan düzende kullanılır.
ASCENDING Artan sıralama. Bu alan, artan düzende sıralanacaktır.
DESCENDING Azalan sıralama. Bu alan, azalan düzende sıralanacaktır.

Segment

Raporun segmentlere ayrılması gerekiyorsa segment tanımı. Segment, Analytics verilerinin bir alt kümesidir. Örneğin, tüm kullanıcı grubu içinde bir Segment belirli bir ülkedeki veya şehirdeki kullanıcılar olabilir.

JSON gösterimi 
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
Alanlar
Birleştirme alanı dynamicOrById. Segment, DynamicSegment veya yerleşik ya da özel bir segmentin kimliği kullanılarak dinamik bir şekilde tanımlanabilir. dynamicOrById şunlardan yalnızca biri olabilir:
dynamicSegment

object(DynamicSegment)

İstekteki bir dinamik segment tanımı.

segmentId

string

Yerleşik veya özel segmentin segment kimliği (örneğin, gaid::-3).

DynamicSegment

İstek içindeki segmenti tanımlamak için kullanılan dinamik segment tanımı. Bir segmentte kullanıcılar, oturumlar veya her ikisi birden seçilebilir.

JSON gösterimi 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
Alanlar
name

string

Dinamik segmentin adı.

userSegment

object(SegmentDefinition)

Segmente dahil edilecek kullanıcıları seçmek için Kullanıcı Segmenti.

sessionSegment

object(SegmentDefinition)

Segmente dahil edilecek oturumları seçmek için Oturum Segmenti.

SegmentDefinition

SegmentDefinition, segmenti mantıksal bir AND işlemiyle birleştirilmiş bir SegmentFiltreler grubu olarak tanımlar.

JSON gösterimi 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
Alanlar
segmentFilters[]

object(SegmentFilter)

Segment, mantıksal bir AND işlemiyle birleştirilen bir grup segment filtresiyle tanımlanır.

SegmentFilter

SegmentFilter, segmenti basit veya sıra segmenti olarak tanımlar. Basit bir segment koşulu, oturumları veya kullanıcıları seçmek için boyut ve metrik koşulları içerir. Dizi segmenti koşulu, sıralı koşullara göre kullanıcıları veya oturumları seçmek için kullanılabilir.

JSON gösterimi 
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
Alanlar
not

boolean

Doğru değeri döndürülürse basit veya sıralı segmentinin tamamlayıcısıyla eşleştirin. Örneğin, "New York"tan olmayan tüm ziyaretlerle eşleştirmek için segmenti aşağıdaki gibi tanımlayabiliriz:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

Birleştirme alanı simpleOrSequence. Basit bir segment mi yoksa dizi segmenti tanımı mı? simpleOrSequence şunlardan yalnızca biri olabilir:
simpleSegment

object(SimpleSegment)

Basit segment koşulları, birleştirilebilecek bir veya daha fazla boyut/metrik koşulundan oluşur.

sequenceSegment

object(SequenceSegment)

Adım sırası koşulları, bir veya daha fazla adımdan oluşur ve her adım, bir veya daha fazla boyut/metrik koşulu ile tanımlanır. Birden fazla adım, özel dizi operatörleriyle birleştirilebilir.

SimpleSegment

Basit segment koşulları, birleştirilebilecek bir veya daha fazla boyut/metrik koşulundan oluşur.

JSON gösterimi 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
Alanlar
orFiltersForSegment[]

object(OrFiltersForSegment)

Mantıksal AND operatörüyle birleştirilmiş segment filtresi gruplarının listesi.

OrFiltersForSegment

OR grubundaki segment filtreleri listesi, mantıksal OR operatörüyle birleştirilir.

JSON gösterimi 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
Alanlar
segmentFilterClauses[]

object(SegmentFilterClause)

OR operatörüyle birleştirilecek segment filtrelerinin listesi.

SegmentFilterClause

Segment tanımında kullanılacak Filtre Yan Tümcesi, bir metriği veya boyut filtresini iptal edebilir.

JSON gösterimi 
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
Alanlar
not

boolean

Filtrenin tamamlayıcısıyla (!) eşleşir.

Birleştirme alanı dimensionOrMetricFilter. Boyut veya metrik filtresi. dimensionOrMetricFilter şunlardan yalnızca biri olabilir:
dimensionFilter

object(SegmentDimensionFilter)

Segment tanımı için Boyut Filtresi.

metricFilter

object(SegmentMetricFilter)

Segment tanımı için Metrik Filtresi.

SegmentDimensionFilter

Boyut filtresi, bir boyuttaki filtreleme seçeneklerini belirtir.

JSON gösterimi 
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
Alanlar
dimensionName

string

Filtrenin uygulandığı boyutun adı.

operator

enum(Operator)

Boyutu ifadelerle eşleştirmek için kullanılacak operatör.

caseSensitive

boolean

Eşleşme büyük/küçük harfe duyarlıysa IN_LIST operatörü için yoksayılır.

expressions[]

string

İfade listesi; tüm operatörler için yalnızca ilk öğe kullanılır

minComparisonValue

string

BETWEEN eşleme türü için minimum karşılaştırma değerleri.

maxComparisonValue

string

BETWEEN eşleme türü için maksimum karşılaştırma değerleri.

Operatör

Farklı eşleme türleri desteklenir.

Sıralamalar
OPERATOR_UNSPECIFIED Eşleme türü belirtilmezse REGEXP olarak değerlendirilir.
REGEXP Eşleşme ifadesi, normal bir ifade olarak değerlendirilir. Diğer hiçbir eşleme türleri normal ifade olarak kabul edilmez.
BEGINS_WITH Sağlanan eşleşme ifadesiyle başlayan değerleri eşleştirir.
ENDS_WITH Sağlanan eşleşme ifadesiyle biten değerleri eşleştirir.
PARTIAL Alt dize eşleşiyor.
EXACT Değer, eşleşme ifadesiyle tamamen eşleşmelidir.
IN_LIST

Bu seçenek, ifadesi seçilen bir değer listesinden herhangi bir değer alabilen boyut filtresini belirtmek için kullanılır. Bu, her bir yanıt satırı için VEYA uygulanan birden çok tam eşleme boyut filtresinin değerlendirilmesini önlemeye yardımcı olur. Örneğin:

expressions: ["A", "B", "C"]

Boyutu A, B veya C değerine sahip olan tüm yanıt satırları bu DimensionFilter ile eşleşir.
NUMERIC_LESS_THAN

Tam sayı karşılaştırma filtreleri. Bunlar için büyük/küçük harfe duyarlılık dikkate alınmaz ve ifadenin bir tam sayıyı temsil eden bir dize olduğu varsayılır. Hata koşulları:

  • ifade, geçerli bir int64 değilse istemci bir hata beklemelidir.
  • Geçerli int64 değerleri olmayan giriş boyutları hiçbir zaman filtreyle eşleşmez.

Boyutun, eşleşme ifadesinden sayısal olarak küçük olup olmadığını kontrol eder.
NUMERIC_GREATER_THAN Boyutun, eşleşme ifadesinden sayısal olarak büyük olup olmadığını kontrol eder.
NUMERIC_BETWEEN Boyutun, eşleşme ifadesinin minimum ve maksimum değerleri arasında sayısal olarak (sınırlar hariç) olup olmadığını kontrol eder.

SegmentMetricFilter

Segment filtresi ifadesinde kullanılacak metrik filtresi.

JSON gösterimi 
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
Alanlar
scope

enum(Scope)

Bir metriğin kapsamı, o metriğin tanımlandığı düzeyi tanımlar. Belirtilen metrik kapsamı, veri modelinde tanımlanan birincil kapsama eşit veya daha büyük olmalıdır. Birincil kapsam, segmentin kullanıcı veya oturum seçme durumuna göre tanımlanır.

metricName

string

Filtrelenecek metrik. metricFilter, bir metrik adı içermelidir.

operator

enum(Operator)

Belirtir, metriği karşılaştırmak için gerçekleştirilecek işlemdir. Varsayılan değer: EQUAL.

comparisonValue

string

Karşılaştırma değeri. Operatör BETWEEN ise bu değer, minimum karşılaştırma değeri olarak kabul edilir.

maxComparisonValue

string

Maksimum karşılaştırma değeri yalnızca BETWEEN operatörü için kullanılır.

Kapsam

Bir metriğin kapsamı, metriğin tanımlandığı düzeyi tanımlar: PRODUCT, HIT, SESSION veya USER. Metrik değerleri, birincil kapsamından daha büyük kapsamlarda da raporlanabilir. Örnek: ga:pageviews ve ga:transactions, bu oturumlarda veya söz konusu kullanıcılar için gerçekleşen her isabet için toplanarak SESSION ve USER düzeyinde raporlanabilir.

Sıralamalar
UNSPECIFIED_SCOPE Kapsam belirtilmezse segmentin kullanıcıları veya oturumları seçmeye çalışıp çalışmadığına bağlı olarak varsayılan olarak USER veya SESSION koşul kapsamını ayarlar.
PRODUCT Ürün kapsamı.
HIT İsabet kapsamı.
SESSION Oturum kapsamı.
USER Kullanıcı kapsamı.

Operatör

Farklı karşılaştırma türü seçenekleri.

Sıralamalar
UNSPECIFIED_OPERATOR Belirtilmemiş operatör, LESS_THAN operatörü olarak kabul edilir.
LESS_THAN Metrik değerinin karşılaştırma değerinden küçük olup olmadığını kontrol eder.
GREATER_THAN Metrik değerinin karşılaştırma değerinden büyük olup olmadığını kontrol eder.
EQUAL Eşittir operatörü.
BETWEEN Operatörler arasındaki minimum ve maksimum değerler hariçtir. Karşılaştırma için LT ve GT kullanacağız.

SequenceSegment

Adım sırası koşulları, bir veya daha fazla adımdan oluşur ve her adım, bir veya daha fazla boyut/metrik koşulu ile tanımlanır. Birden fazla adım, özel dizi operatörleriyle birleştirilebilir.

JSON gösterimi 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
Alanlar
segmentSequenceSteps[]

object(SegmentSequenceStep)

Dizideki adımların listesi.

firstStepShouldMatchFirstHit

boolean

Ayarlanırsa ilk adım koşulu, ziyaretçinin ilk isabetiyle (tarih aralığında) eşleşmelidir.

SegmentSequenceStep

Segment sırası tanımı.

JSON gösterimi 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
Alanlar
orFiltersForSegment[]

object(OrFiltersForSegment)

Dizi, AND operatörüyle birleştirilmiş veya gruplandırılmış filtreler listesiyle belirtilir.

matchType

enum(MatchType)

Adımın sonraki adımdan hemen önce mi yoksa sonraki adımdan hemen önce mi olacağını belirtir.

MatchType

Dizinin eşleme türü.

Sıralamalar
UNSPECIFIED_MATCH_TYPE Belirtilmemiş eşleme türü, önceki gibi kabul edilir.
PRECEDES Operatör, önceki adımın sonraki adımdan önce geldiğini belirtir.
IMMEDIATELY_PRECEDES Operatör, önceki adımın sonraki adımdan hemen önce geldiğini belirtir.

Pivot

Pivot, istekteki pivot bölümünü açıklar. Pivot, verilerinizi ikinci bir boyutta özetleyerek, belirli raporlar için tablolardaki bilgilerin yeniden düzenlenmesine yardımcı olur.

JSON gösterimi 
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
Alanlar
dimensions[]

object(Dimension)

Özet sütunları olarak gösterilecek boyutların listesi. Bir Pivot en fazla 4 boyuta sahip olabilir. Pivot boyutları, istekte izin verilen toplam boyut sayısına ilişkin kısıtlamanın bir parçasıdır.

dimensionFilterClauses[]

object(DimensionFilterClause)

DimensionFilterClauses, bir AND operatörüyle mantıksal olarak birleştirilir: yalnızca bu DimensionFilterClauses tarafından dahil edilen veriler bu pivot bölgedeki değerlere katkıda bulunur. Pivot bölgede gösterilen sütunları kısıtlamak için boyut filtreleri kullanılabilir. Örneğin, pivot bölgede istenen boyut ga:browser ise ve ga:browser değerini yalnızca "IE" veya "Firefox" ile kısıtlamak için anahtar filtreleri belirtirseniz yalnızca bu iki tarayıcı sütun olarak görünür.

metrics[]

object(Metric)

Özet metrikler. Özet metrikleri, istekte izin verilen toplam metrik sayısı kısıtlamasının bir parçasıdır.

startGroup

number

k metriği istendiyse yanıt, rapordaki k sütunun veriye bağlı bir katını içerecektir. Örneğin, ga:browser boyutunda özetleme yaptıysanız "Firefox" için k sütunu, "IE" için k sütunu, "Chrome" için k sütunu vb. elde edersiniz. Sütun gruplarının sıralaması, ilk k değeri için azalan "toplam" sırasına göre belirlenir. Bağlantılar, ilk pivot boyutun sözlükte yer aldığı sıralamaya, ardından ikinci pivot boyutun sözlüksel sıralamasına göre ayrılır. Örneğin, Firefox, IE ve Chrome için ilk değerin toplamları sırasıyla 8, 2, 8 ise, sütunların sırası Chrome, Firefox, IE olur.

Aşağıda, k sütun gruplarından hangilerinin yanıta dahil edileceğini seçebilirsiniz.
maxGroupCount

number

Döndürülecek maksimum grup sayısını belirtir. Varsayılan değer 10, ayrıca maksimum değer 1.000'dir.

CohortGroup

Kohort grubu tanımlar. Örneğin:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
JSON gösterimi 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
Alanlar
cohorts[]

object(Cohort)

Grubun tanımı.

lifetimeValue

boolean

Yaşam Süresi Değeri'ni (YBD) etkinleştirin. YBD, farklı kanallardan edinilen kullanıcılar için yaşam boyu değeri ölçer. Kohort Analizi ve Yaşam Boyu Değer bölümlerini inceleyin. Ömür boyu değerin değeri yanlışsa:

  • Metrik değerleri, web arayüzü kohort raporundaki değerlere benzer.
  • Kohort tanımı tarih aralıkları takvim haftası ve ay ile uyumlu olmalıdır. Yani ga:cohortNthWeek isteğinde bulunurken kohort tanımındaki startDate pazar günü, endDate değeri sonraki Cumartesi, ga:cohortNthMonth için startDate ayın 1'i, endDate için de ayın son günü olmalıdır.

LifeValue doğru olduğunda:

  • Metrik değerleri, web arayüzü Yaşam Süresi değeri raporundaki değerlere karşılık gelir.
  • Yaşam Boyu Değer raporu, bir kullanıcı edinildikten sonraki 90 gün içinde kullanıcı değerinin (Gelir) ve etkileşiminin (Uygulama Görüntülemeleri, Hedef Tamamlamalar, Oturumlar ve Oturum Süresi) nasıl arttığını gösterir.
  • Metrikler zaman artışı başına kullanıcı başına kümülatif bir ortalama olarak hesaplanır.
  • Kohort tanımı tarih aralıklarının takvim haftası ve ay sınırlarıyla aynı hizaya getirilmesi gerekmez.
  • viewId, bir uygulama görüntüleme kimliği olmalıdır

Kohort

Kohort tanımlar. Kohort, ortak bir özelliği paylaşan kullanıcı grubudur. Örneğin, edinme tarihi aynı olan tüm kullanıcılar aynı kohorta dahildir.

JSON gösterimi 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
Alanlar
name

string

Grup için benzersiz bir ad. Tanımlanmamışsa ad, kohort_[1234...] değerleriyle otomatik olarak oluşturulur.

type

enum(Type)

Grubun türü. Şu anda yalnızca FIRST_VISIT_DATE türü desteklenmektedir. Bu alan belirtilmezse kohort, FIRST_VISIT_DATE türü kohort olarak kabul edilir.

dateRange

object(DateRange)

Bu FIRST_VISIT_DATE kohortu için kullanılır. Grup, ilk ziyaret tarihi DateRange'de tanımlanan başlangıç tarihi ile bitiş tarihi arasında olan kullanıcıları seçer. Tarih aralıkları kohort istekleri için uyumlu olmalıdır. İstek ga:cohortNthDay içeriyorsa tam olarak bir gün uzunluğunda, ga:cohortNthWeek değeriyse hafta sınırına (Pazar'dan başlayıp Cumartesi'den itibaren) ve ga:cohortNthMonth için de tarih aralığı da aya (ayın ilk gününden başlayıp son gününe) hizalanmalıdır. YBD istekleri için bu tür bir kısıtlama yoktur. reportsRequest.dateRanges alanı için bir tarih aralığı sağlamanız gerekmez.

Tür

Kohort türü.

Sıralamalar
UNSPECIFIED_COHORT_TYPE Belirtilmemesi halinde FIRST_VISIT_DATE kabul edilir.
FIRST_VISIT_DATE İlk ziyaret tarihine göre seçilen kohortlar.

Bildirme

İsteğe karşılık gelen veri yanıtı.

JSON gösterimi 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
Alanlar
columnHeader

object(ColumnHeader)

Sütun başlıkları.

data

object(ReportData)

Yanıt verileri.

nextPageToken

string

Sayfa jetonu 'nu kullanın.

ColumnHeader

Sütun başlıkları.

JSON gösterimi 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
Alanlar
dimensions[]

string

Yanıttaki boyut adları.

metricHeader

object(MetricHeader)

Yanıttaki metriklerin metrik başlıkları.

MetricHeader

Metriklerin başlıkları.

JSON gösterimi 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
Alanlar
metricHeaderEntries[]

object(MetricHeaderEntry)

Yanıttaki metriklerin başlıkları.

pivotHeaders[]

object(PivotHeader)

Yanıttaki pivotların başlıkları.

MetricHeaderEntry

Metrikler için başlık.

JSON gösterimi 
{
  "name": string,
  "type": enum(MetricType)
}
Alanlar
name

string

Üstbilginin adı.

type

enum(MetricType)

Metriğin türü (örneğin, INTEGER).

PivotHeader

İstekte tanımlanan pivot bölümlerinin her birinin üstbilgileri.

JSON gösterimi 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
Alanlar
pivotHeaderEntries[]

object(PivotHeaderEntry)

Tek bir pivot bölüm başlığı.

totalPivotGroupsCount

number

Bu pivot için toplam grup sayısı.

PivotHeaderEntry

Yanıtın pivotlar bölümünde istenen metriklere karşılık gelen her metrik sütununun başlıkları.

JSON gösterimi 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
Alanlar
dimensionNames[]

string

Pivot yanıtındaki boyutların adı.

dimensionValues[]

string

Özetteki boyutların değerleri.

metric

object(MetricHeaderEntry)

Özetteki metrik için metrik başlığı.

ReportData

Raporun veri bölümü.

JSON gösterimi 
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
Alanlar
rows[]

object(ReportRow)

Benzersiz boyut kombinasyonlarının her biri için bir ReportRow satır bulunur.

totals[]

object(DateRangeValues)

İstenen her tarih aralığı için, sorguyla eşleşen tüm satır kümesi için istenen her değer biçimi bir toplam alır. Bir değer biçiminin toplamı, önce değer biçiminde bahsedilen metriklerin toplanması ve ardından değer biçiminin skaler bir ifade olarak değerlendirilmesi yoluyla hesaplanır. Örnek: 3 / (ga:sessions + 2) için 3 / ((sum of all relevant ga:sessions) + 2) hesapladığımız "toplamlar". Toplamlar, sayfalara ayırma işleminden önce hesaplanır.

rowCount

number

Bu sorgu için eşleşen satırların toplam sayısı.

minimums[]

object(DateRangeValues)

Eşleşen tüm satırlarda görülen minimum ve maksimum değerler. İstekteki hideValueRanges yanlış olduğunda veya rowCount sıfır olduğunda bunların her ikisi de boş olur.

maximums[]

object(DateRangeValues)

Eşleşen tüm satırlarda görülen minimum ve maksimum değerler. İstekteki hideValueRanges yanlış olduğunda veya rowCount sıfır olduğunda bunların her ikisi de boş olur.

samplesReadCounts[]

string (int64 format)

Sonuçlar örneklenmişse, her tarih aralığı için bir giriş olacak şekilde, okunan toplam örnek sayısı döndürülür. Sonuçlar örneklenmemişse bu alan tanımlanmaz. Ayrıntılar için geliştirici kılavuzuna bakın.

samplingSpaceSizes[]

string (int64 format)

Sonuçlar örneklenmişse, tarih aralığı başına bir giriş olacak şekilde mevcut örnek toplam sayısını döndürür. Sonuçlar örneklenmemişse bu alan tanımlanmaz. Ayrıntılar için geliştirici kılavuzuna bakın.

isDataGolden

boolean

Bu isteğe verilen yanıtın değerli olup olmadığını belirtir. Daha sonra sorulduğunda tam olarak aynı istek yeni sonuç üretmeyecekse veriler çok değerlidir.

dataLastRefreshed

string (Timestamp format)

Rapordaki verilerin en son yenilenme zamanı. Bu zaman damgasından önce alınan tüm isabetler rapor hesaplamasına dahil edilir.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

ReportRow

Rapordaki bir satır.

JSON gösterimi 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
Alanlar
dimensions[]

string

İstenen boyutların listesi.

metrics[]

object(DateRangeValues)

İstenen her DateRange için metriklerin listesi.

DateRangeValues

Tek bir DateRange / boyut kombinasyonuna ilişkin metrik listesini döndürmek için kullanılır

JSON gösterimi 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
Alanlar
values[]

string

Her değer, istekteki her Metriğe karşılık gelir.

pivotValueRegions[]

object(PivotValueRegion)

Her pivot bölgenin değerleri.

PivotValueRegion

Pivot bölgesindeki metrik değerleri.

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

string

Pivot bölgelerin her birindeki metriklerin değerleri.

ResourceQuotasRemaining

İstek tamamlandıktan sonra mülk için kalan kaynak kota jetonları.

JSON gösterimi 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
Alanlar
dailyQuotaTokensRemaining

number

Kalan günlük kaynak kotası.

hourlyQuotaTokensRemaining

number

Kalan saatlik kaynak kota jetonları.

Deneyin.