Method: reports.batchGet

Analytics verilerini döndürür.

HTTP isteği

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

URL, gTB Kod Geçişi söz dizimini kullanır.

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri 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ı (varsayılan olarak False'dir) etkinleştirir. Bu alan, True olarak ayarlanırsa görüntüleme başına (profil) kotaları, isteğin hesaplama maliyetine göre belirlenir. Maliyete dayalı kotalar kullanıldığında örnekleme örneklemesi etkinleştirilir. (SMALL için 10 milyon, LARGE için 100 milyon. Ayrıntılı bilgi için sınırlar ve kotalarla ilgili belgelere göz atın.

Yanıt metni

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

Reporting API batchGet çağrısındaki raporları barındıran ana yanıt sınıfı.

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

object(Report)

İsteğin her birine 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ının miktarı.

Yetkilendirme Kapsamları

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

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

Rapor İsteği

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 ait boyut kombinasyonlarının her biri için bir metrik değerleri grubu içerir. Bu yüzden, iki tarih aralığı varsa biri orijinal tarih aralığı için, diğeri ikinci tarih aralığı için olmak üzere iki metrik değeri grubu olacaktır. Kohortlar veya ömür boyu değer istekleri için reportRequest.dateRanges alanı belirtilmemelidir. Tarih aralığı sağlanmazsa varsayılan tarih aralığı (başlangıç tarihi: geçerli tarih - 7 gün, bitiş tarihi: geçerli tarih - 1 gün) şeklindedir. Bir batchGet yöntemindeki her ReportRequest, aynı dateRanges tanımını içermelidir.

samplingLevel

enum(Sampling)

İstenen raporun örnek 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 maddeleri. Bunlar, AND operatörüyle mantıksal olarak birleştirilir. Filtreleme, tüm boyutlar toplanmadan önce gerçekleşir. Bu nedenle, döndürülen metrikler yalnızca ilgili boyutların toplamını temsil eder.

metrics[]

object(Metric)

İstenen metrikler. İsteklerde en az bir metrik belirtilmelidir. İsteklerin toplam 10 metriği olabilir.

metricFilterClauses[]

object(MetricFilterClause)

Metrik filtresi maddeleri. Bunlar, AND operatörüyle mantıksal olarak birleştirilir. Metrik filtreleri, karşılaştırmanın yapıldığı tarih aralığını değil, yalnızca ilk tarih aralığını dikkate alır. Metriklere filtre uygulama işlemi, metrikler toplandıktan sonra gerçekleşir.

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 sağlayın. Örneğin, aşağıdaki ifade Firefox ile başlayan ga:browser boyutunu seçiyor; ga:browser=~^Firefox. Boyutlar ve metrik filtreleri hakkında daha fazla bilgi için Filtrelerle ilgili referanslar bölümünü inceleyin.

orderBys[]

object(OrderBy)

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

segments[]

object(Segment)

İstek için döndürülen verileri segmentlere ayırın. Segment tanımı, segment isteğinin bir alt kümesine bakmaya 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 istekler ga:segment boyutuna sahip olmalıdır.

pivots[]

object(Pivot)

Pivot tanımlar. Taleplerde en fazla 2 pivot olabilir.

cohortGroup

object(CohortGroup)

Bu istekle ilişkili grup. İstekte bir kohort grubu varsa ga:cohort boyutu mevcut olmalı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 kullanılan bir devam jetonu. Bunu isteğe eklediğinizde pageToken'tan sonraki satırlar döndürülür. pageToken, reports.batchGet isteğine verilen yanıtta NextPageToken parametresinde döndürülen değer olmalıdır.

pageSize

number

Sayfa boyutu sayfalandırmaya yöneliktir ve döndürülen maksimum satır sayısını belirtir. Sayfa boyutu >= 0 olmalıdır. Bir sorgu,varsayılan 1.000 satırı döndürür. Analytics temel raporlama API'sı,kaç adet isterseniz, istek başına en fazla 100.000 satır döndürür. Beklediğiniz kadar çok boyut segmenti yoksa istenenden daha az satır da döndürebilir. Örneğin, ga:country için 300'den az olası değer bulunduğundan yalnızca ülkeye göre segmentlere ayırdığınızda pageSize değerini 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 değer, bu satırları hariç tutan "false" değeridir.

hideTotals

boolean

Doğru değerine ayarlanırsa tüm tarih aralıkları için eşleşen tüm satırlara yönelik tüm metriklerin toplamını gizler. Varsayılan yanlış, toplamları döndürür.

hideValueRanges

boolean

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

Örnekleme

Örnekleme düzeyi değerleri.

Sıralamalar
SAMPLING_UNSPECIFIED samplingLevel alanı belirtilmemişse DEFAULT örnekleme düzeyi kullanılır.
DEFAULT Hız ile doğruluğu dengeleyen bir örnek boyutla yanıt döndürür.
SMALL Daha küçük bir örnekleme boyutuyla hızlı bir 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, bir oturumun gerçekleştiği şehri (ör. "Paris" veya "Ankara") belirtir.

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

string

Getirmek istediğiniz boyutun adı (ör. ga:browser).

histogramBuckets[]

string (int64 format)

Boş değilse boyut değerlerini int64'e dizeden sonra pakete yerleştiririz. Bütünsel değerin dize gösterimi olmayan boyut değerleri sıfıra dönüştürülür. Paket değerleri artan sırada olmalıdır. Her paket alt tarafta kapalıdır ve üst tarafta açılır. "İlk" paketi, ilk sınırdan küçük tüm değerleri, "son" paket ise sonsuza kadar olan tüm değerleri içerir. Pakette yer alan boyut değerleri yeni bir boyut değerine dönüştürülür. Örneğin, biri &0;0, 1, 3, 4, 7'nin listesini verirse, aşağıdaki grupları döndürürüz:

  • paket 1: değerler < 0, boyut değeri "<0"
  • 2. paket: [0,1] içindeki değerler), boyut değeri "0"
  • 3. paket: [1,3] içindeki değerler), boyut değeri "1-2 inç"
  • 4. paket: [3,4" içindeki değerler), boyut değeri "3";
  • 5. paket: [4,7] değeri, boyut değeri "4-6 inç"
  • 6. bölüm: değerler gt;= 7, boyut değeri &7;

NOT: Herhangi bir boyuta histogram mutasyonu uyguluyor ve bu boyutu sıralı olarak kullanıyorsanız bu amaç için HISTOGRAM_BUCKET sıralama türünü kullanmanız gerekir. Bu olmadan, boyut değerleri sözlük (sözlük dili) sırasına göre sıralanır. Örneğin, artan sözlük sıralaması şöyledir:

&"50-120", "121-1000", "50-120"

Artan HISTOGRAM_BUCKET sırası:

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

İstemci, "orderType": "HISTOGRAM_BUCKET" histogramı mutasyona uğramış bir boyut için açıkça istemelidir.

BoyutFiltresi Maddesi

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. Belirtilen operatöre göre mantıksal olarak birleştirilirler.

FiltreLogicalOperatörü

Filtrelerin mantıksal olarak nasıl bir araya getirildiği.

Sıralamalar
OPERATOR_UNSPECIFIED Belirtilmemiş operatör. OR olarak değerlendirilir.
OR Mantıksal OR operatörü.
AND Mantıksal AND operatörü.

Boyut Filtresi

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

Filtrelenecek boyut. Bir Boyut Filtresi boyut içermelidir.

not

boolean

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

operator

enum(Operator)

Boyut, ifadeyle nasıl eşleştirilir? Varsayılan ayar 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ü kullanılıyorsa boyutları IN_LIST operatörü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ıdır mı? Varsayılan olarak false (yanlış) değeri kullanılır.

Operatör

Farklı eşleme türleri desteklenir.

Sıralamalar
OPERATOR_UNSPECIFIED Eşleme türü belirtilmemişse REGEXP olarak kabul edilir.
REGEXP Eşleşme ifadesi, normal ifade olarak ele alınır. Tüm eşleme türleri normal ifadeler 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şmesi.
EXACT Değer, eşleşme ifadesiyle tamamen eşleşmelidir.
NUMERIC_EQUAL

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

  • İfade geçerli bir int64 değilse istemci bir hata bekler.
  • Geçerli int64 değerleri olmayan giriş boyutları hiçbir zaman filtreyle eşleşmez.
NUMERIC_GREATER_THAN Boyutun eşleşme ifadesinden büyük olup olmadığını kontrol eder. Kısıtlamalar için NUMERIC_EQUALS ile ilgili açıklamayı 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 ile ilgili açıklamayı okuyun.
IN_LIST

Bu seçenek, ifadesi seçilen bir değer listesinden herhangi bir değeri alabilecek boyut filtresi belirtmek için kullanılır. Bu, her bir yanıt satırı için VEYA işlevinde birden fazla 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 Boyut Filtresi 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ı gösterir.

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

string

İstekteki metrik ifadesi. Bir ifade, bir veya daha fazla metrik ve rakamdan oluşturulur. Kabul edilen operatörler şunları içerir: Plus (+), Eksi (-), Olumsuz (Birlik -), Bölen (/), Çarpı (*), Parantez, Pozitif nicelik numaraları (0-9), ondalık içerebilir ve 1024 karakterle sınırlıdır. ga:totalRefunds/ga:users örneği, çoğu durumda metrik ifadesinin ga:users gibi tek bir metrik adı olduğunu gösterir. Karma MetricType ekleme (ör. CURRENCY + PERCENTAGE metrikleri) beklenmedik sonuçlara neden olur.

alias

string

Metrik ifadesine 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, filtreleme ve sıralamada kullanılabilecek karmaşık bir ifadeyse yararlı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 (ör. INTEGER).

Metrik Türü

Metrik türleri.

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

Metrik Filtresi Maddesi

Bir grup metrik filtresi gösterilir. 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 fazla metrik filtresini birleştirme operatörü. Belirtilmemesi halinde OR olarak kabul edilir.

filters[]

object(MetricFilter)

Tekrarlanan filtre grubu. Belirtilen operatöre göre mantıksal olarak birleştirilirler.

Metrik Filtresi

MetricFiltre, bir metrikteki filtreyi belirtir.

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

string

Filtrelenecek metrik. Bir metrik filtresi metrik adı içermelidir. Metrik adı, daha önce metrik olarak tanımlanmış bir takma ad veya metrik ifadesi 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 değer, false (yanlış) değeridir.

operator

enum(Operator)

karşılaştırma metriği EQUAL, LESS_THAN veya GREATER_THAN ise karşılaştırmaValue'dur. Varsayılan değer EQUAL'dir. Operatör IS_MISSING ise metriğin eksik olup olmadığını kontrol eder ve karşılaştırmaValue'yu yoksayar.

comparisonValue

string

Karşılaştırılacak değer.

Operatör

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

Sıralamalar
OPERATOR_UNSPECIFIED Operatör belirtilmezse EQUAL olarak işlenir.
EQUAL Metriğin değeri karşılaştırma değerine tam olarak eşitse.
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ırmaValue'yu dikkate almaz.

Sıralama Ölçütü

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 sıradadır. Ö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, VALUE şeklindedir.

sortOrder

enum(SortOrder)

Alanın sıralama düzeni.

OrderType

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

Sıralamalar
ORDER_TYPE_UNSPECIFIED Belirtilmemiş sipariş türü, değere göre sıralama olarak değerlendirilir.
VALUE Sıralama ölçütü, seçilen sütunun değerini temel alır; yalnızca ilk tarih aralığına bakar.
DELTA Sıralama ölçütü, seçilen sütunun değerlerinin ilk iki tarih aralığı arasındaki farkına dayanır. Yalnızca tam olarak iki tarih aralığı varsa kullanılabilir.
SMART Sıralama ölçütü, seçilen sütunun ağırlıklı değerini temel alır. Sütun geçerli olmayan biçimdeyse bu oranın ağırlıklı değeri (n + totals.n)/(d + totals.d), yalnızca oranları temsil eden metrikler için kullanılabilir olur.
HISTOGRAM_BUCKET Histogram sipariş türü yalnızca boş olmayan histogram paketleri içeren boyut sütunları için geçerlidir.
DIMENSION_AS_INTEGER Boyutların sabit uzunluktaki sayılar olması, normal sıralamanın sorun yaratmayacağı anlamına gelir. Boyutlar değişken uzunlukta sayılarsa DIMENSION_AS_INTEGER kullanılabilir.

SortOrder

Sıralama ölçütü.

Sıralamalar
SORT_ORDER_UNSPECIFIED Sıralama ölçütü belirtilmemişse varsayılan değer artan olur.
ASCENDING Artan sıralama. Alan artan bir şekilde sıralanır.
DESCENDING Azalan düzen. Alan, azalan düzende sıralanır.

Segment

Raporun segmentlere ayrılması gerekiyorsa segment tanımı. Segment, Analytics verilerinin bir alt kümesidir. Örneğin, tüm kullanıcı kümesi 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
Birlik alanı dynamicOrById. Segment, DinamikSegment kullanılarak veya yerleşik ya da özel bir segmentin kimliği kullanılarak dinamik bir şekilde tanımlanabilir. dynamicOrById aşağıdakilerden yalnızca biri olabilir:
dynamicSegment

object(DynamicSegment)

İstekteki dinamik segment tanımı.

segmentId

string

Yerleşik veya özel bir segmentin segment kimliği (ör. gaid::-3).

DinamikSegment

İsteğin içindeki segmenti tanımlamak için dinamik segment tanımı. Segment; kullanıcıları, oturumları veya her ikisini birden seçebilir.

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

string

Dinamik segmentin adı.

userSegment

object(SegmentDefinition)

Kullanıcıların segmente dahil edileceği kullanıcı segmenti.

sessionSegment

object(SegmentDefinition)

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

SegmentTanımı

SegmentDefinition, segmenti mantıksal bir AND işlemiyle birleştirilen bir SegmentFiltre 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 filtre filtresi tarafından tanımlanır.

SegmentFiltre

SegmentFiltre, segmenti basit veya dizi segmenti olarak tanımlar. Basit bir segment koşulu, oturumları veya kullanıcıları seçmek için boyut ve metrik koşullarını 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ğruysa basit veya dizi segmentinin tamamlayıcısı olarak kullanın. Örneğin, "New York"tan olmayan tüm ziyaretleri eşleştirmek için segmenti aşağıdaki şekilde tanımlayabiliriz:

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

Birlik alanı simpleOrSequence. Basit bir segment mi yoksa bir dizi segmenti tanımı mı? simpleOrSequence aşağıdakilerden 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ı, her adımın bir veya daha fazla boyut/metrik koşuluyla tanımlandığı bir veya daha fazla adımdan oluşur. Özel adım operatörleriyle birden çok adım birleştirilebilir.

BasitSegment

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ştirilen segment filtreleri gruplarının listesi.

Segment İçinOrFiltreler

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

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

object(SegmentFilterClause)

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

SegmentFiltre Maddesi

Segment tanımında kullanılacak Filtre Maddesi, bir metrik veya boyut filtresiyle karıştırılabilir.

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ı özelliğiyle (!) eşleşir.

Birlik alanı dimensionOrMetricFilter. Boyut veya metrik filtresi. dimensionOrMetricFilter aşağıdakilerden yalnızca biri olabilir:
dimensionFilter

object(SegmentDimensionFilter)

Segment tanımı için Boyut Filtresi.

metricFilter

object(SegmentMetricFilter)

Segment tanımı için Metrik Filtresi.

SegmentBoyut Filtresi

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ü belirtilmemişse bu, REGEXP olarak değerlendirilir.
REGEXP Eşleşme ifadesi, normal ifade olarak ele alınır. Diğer tüm eşleme türleri normal ifadeler 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şmesi.
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ğeri alabilecek boyut filtresi belirtmek için kullanılır. Bu, her bir yanıt satırı için VEYA işlevinde birden fazla 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 Boyut Filtresi ile eşleşir.
NUMERIC_LESS_THAN

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

  • ifade geçerli bir int64 değilse istemci bir hata bekler.
  • 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 büyük olup olmadığını kontrol eder.
NUMERIC_BETWEEN Boyutun, eşleşme ifadesine ait minimum ve maksimum değerler arasında sayısal bir değer olup olmadığını kontrol eder. Sınırlar hariç tutulur.

SegmentMetrikFiltresi

Bir 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ı, metriğin tanımlandığı düzeyi tanımlar. Belirtilen metrik kapsamı, veri modelinde tanımlanan birincil kapsamına eşit veya bundan daha büyük olmalıdır. Birincil kapsam, segmentin kullanıcı veya oturum mu seçtiğine göre tanımlanır.

metricName

string

Filtrelenecek metrik. metricFilter metrik adı içermelidir.

operator

enum(Operator)

Metriği karşılaştırmak için gerçekleştirilecek işlemi belirtir. Varsayılan değer: EQUAL.

comparisonValue

string

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

maxComparisonValue

string

Maks. 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 geniş kapsamlarda da raporlanabilir. Örnek: ga:pageviews ve ga:transactions seviyeleri SESSION ve USER düzeyinde raporlanabilir. Bunu yalnızca söz konusu oturumlarda veya bu kullanıcılar için gerçekleşen her isabet için ekleyerek yapabilirsiniz.

Sıralamalar
UNSPECIFIED_SCOPE Segment belirtilmemişse segmentin kullanıcı veya oturum seçmeye çalıştığına bağlı olarak varsayılan koşul kapsamı USER veya SESSION olur.
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 değerlendirilir.
LESS_THAN Metrik değerinin karşılaştırma değerinden düşü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 için hem minimum hem de maksimum değerler hariçtir. Karşılaştırma için LT ve GT kullanılır.

Sıralama Segmenti

Adım sırası koşulları, her adımın bir veya daha fazla boyut/metrik koşuluyla tanımlandığı bir veya daha fazla adımdan oluşur. Özel adım operatörleriyle birden çok adım 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.

SegmentAdımAdımı

Segment dizisi tanımı.

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

object(OrFiltersForSegment)

Dizi, AND operatörüyle birleştirilmiş Gruplanmış filtreler listesi ile belirtilir.

matchType

enum(MatchType)

Adımın bir sonraki adımdan hemen önce mi yoksa önce mi olabileceğini belirtir.

Eşleme Türü

Adım sırasının eşleme türü.

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

Elektronik Ritim

Pivot, istekteki özet bölümünü açıklar. Pivot, verilerinizi ikinci bir boyutta özetleyerek belirli raporlar için tablodaki 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)

Pivot sütunlar olarak gösterilecek boyutların listesi. Bir pivotun en fazla 4 boyutu olabilir. Pivot boyutlar, istekte izin verilen toplam boyut sayısıyla ilgili kısıtlamanın bir parçasıdır.

dimensionFilterClauses[]

object(DimensionFilterClause)

dimensionFiltreClause'ler mantıksal olarak bir AND operatörüyle birleştirilir: Yalnızca bu BoyutlarFiltreClause'leri tarafından eklenen veriler, bu pivot bölgedeki değerlere katkıda bulunur. Pivot bölgesinde gösterilen sütunları sınırlamak için boyut filtreleri kullanılabilir. Örneğin, pivot bölgede istenen boyut olarak ga:browser varsa ve ga:browser öğesini yalnızca"IE"veya"Firefox"ile sınırlamak için anahtar filtreleri belirtirseniz yalnızca bu iki tarayıcı sütun olarak gösterilir.

metrics[]

object(Metric)

Pivot metrikler. Pivot metrikler, istekte izin verilen toplam metrik sayısına ilişkin kısıtlamanın bir parçasıdır.

startGroup

number

K metrikleri istendiyse yanıt, raporda k sütunlarından oluşan verilere bağlı bir katlar içerir. Örneğin, ga:browser boyutunu özetlerseniz "Firefox" için "k", "IE" için k sütunları ve "Chrome" için k sütunları alırsınız. Kravatlar ilk pivot boyutunun sözlük sıralamasına, ardından ikinci pivot boyutunun söz dizimi sırasına göre bölünür. Örneğin, Firefox, IE ve Chrome için ilk değerin toplamı 8, 2, 8 ise sütunların sırası Chrome, Firefox, IE olur.

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

number

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

Grup Grubu

Bir grup 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 Boyu Değeri (YBD) etkinleştirin. YBD, farklı kanallar üzerinden edinilen kullanıcıların yaşam boyu değerini ölçer. Lütfen Kohort Analizi ve Yaşam Boyu Değer bölümlerini inceleyin. Yaşam boyu değerin değeri false ise:

  • Metrik değerleri, web arayüzü grup raporundaki değerlere benzer.
  • Kohort tanımı tarih aralıkları takvim haftası ve aya uygun olmalıdır. Diğer bir deyişle, ga:cohortNthWeek isteğinde bulunurken kohort tanımındaki startDate bir Pazar, endDate bir sonraki Cumartesi olmalı ve ga:cohortNthMonth için startDate ayın 1'i, endDate ise ayın son günü olmalıdır.

yaşam boyu değer doğru olduğunda:

  • Metrik değerleri, web arayüzü Yaşam Boyu değer 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şimin (Uygulama Görüntülemeleri, Hedef Tamamlamalar, Oturumlar ve Oturum Süresi) nasıl büyüdüğünü gösterir.
  • Metrikler, zaman artışı başına kullanıcı başına kümülatif ortalama olarak hesaplanır.
  • Kohort tanımı tarih aralıklarının takvim haftası ve ay sınırlarıyla uyumlu olması gerekmez.
  • viewId, uygulama görüntüleme kimliği olmalıdır

Kohort

Bir 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ış ad, grup_[1234...] değerleriyle otomatik olarak oluşturulur.

type

enum(Type)

Kohort türü. Şu anda desteklenen tek tür FIRST_VISIT_DATE. Bu alan belirtilmemişse grup FIRST_VISIT_DATE türü grup olarak işlenir.

dateRange

object(DateRange)

Bu, FIRST_VISIT_DATE grup için kullanılır. Grup, ilk ziyaret tarihi Tarih Aralığı'nda tanımlanan başlangıç tarihi ve bitiş tarihi arasında olan kullanıcıları seçer. Kohort istekleri için tarih aralıkları uyumlu olmalıdır. İstek ga:cohortNthDay değerini içeriyorsa tam olarak bir gün uzunluğunda olmalıdır. ga:cohortNthWeek ise hafta sınırıyla (pazardan başlayıp Cumartesi günü başlayıp) kalmalıdır. ga:cohortNthMonth tarih aralığı ise aya (ilk andan itibaren başlayıp ayın son gününde sona erme) uygun olmalıdır. YBD istekleri için bu tür kısıtlamalar yoktur. reportsRequest.dateRanges alanı için tarih aralığı sağlamanız gerekmez.

Tür

Grup türü.

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

Bildir

İ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

Listedeki sonuçların yer aldığı bir sonraki sayfayı almak için sayfa jetonu.

Sütun Başlığı

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ı.

Metrik Başlığı

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 başlıkların başlıkları.

Metrik Başlık Girişi

Metriklerin başlığı.

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

string

Üstbilginin adı.

type

enum(MetricType)

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

Pivot Başlık

İstekte tanımlanan pivot bölümlerinin her birinin başlıkları.

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ı.

PivotBaşlıkGiriş

Her metrik sütununun yanıtın pivot bölümünde istenen metriklere karşılık gelen 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

Pivottaki boyutların değerleri.

metric

object(MetricHeaderEntry)

Pivot içindeki metriğin metrik başlığı.

Rapor Verileri

Raporun veri kısmı.

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)

Her boyut kombinasyonu için tek bir ReportRow vardır.

totals[]

object(DateRangeValues)

İstenen her tarih aralığı için sorguyla eşleşen tüm satırların kümesinde, istenen her değer biçimi bir toplam alır. Bir değer biçiminin toplamı, öncelikle değer biçiminde belirtilen metriklerin toplanması ve ardından değer biçiminin bir skalar ifade olarak değerlendirilmesiyle hesaplanır. Örnek: 3 / (ga:sessions + 2) için toplamlar: 3 / ((sum of all relevant ga:sessions) + 2) hesaplanıyor. 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. İstekte hideValueRanges yanlış olduğunda veya rowCount sıfır olduğunda bunların ikisi de boş olur.

maximums[]

object(DateRangeValues)

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

samplesReadCounts[]

string (int64 format)

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

samplingSpaceSizes[]

string (int64 format)

Sonuçlar örneklenmişse her bir tarih aralığı için bir giriş olmak üzere, mevcut örneklerin toplam sayısını döndürür. Sonuçlar örneklenmezse bu alan tanımlanmayacaktır. Ayrıntılar için geliştirici kılavuzuna bakın.

isDataGolden

boolean

Bu isteğe verilen yanıtın altın olup olmadığını gösterir. Daha sonra sorulması durumunda tam olarak aynı istek yeni sonuçlar sağlamadığında veriler altın olur.

dataLastRefreshed

string (Timestamp format)

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

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

Rapor Satırı

Rapordaki bir satır.

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

string

İstenen boyutların listesi.

metrics[]

object(DateRangeValues)

İstenen her tarih aralığı için metriklerin listesi.

Tarih AralığıDeğerleri

Tek bir Tarih Aralığı / 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 bir Metriğe karşılık gelir.

pivotValueRegions[]

object(PivotValueRegion)

Her pivot bölgesinin değerleri.

PivotValueBölge

Pivot bölgesindeki metrik değerleri.

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

string

Pivot bölgelerinin her birindeki metriklerin değerleri.

Kalan Kaynak Kotaları

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

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

number

Günlük kaynak kotası kaldı.

hourlyQuotaTokensRemaining

number

Saatlik kaynak kota jetonları kaldı.

Deneyin.