- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme Kapsamları
- ReportRequest
- Örnekleme
- Boyut
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter (Boyut Filtresi)
- Operatör
- Metrik
- MetricType
- MetricFilterClause
- MetricFilter (Metrik Filtresi)
- Operatör
- OrderBy
- OrderType
- SortOrder
- Segment
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- Operatör
- SegmentMetricFilter
- Kapsam
- Operatör
- SequenceSegment
- SegmentSequenceStep
- MatchType
- Özet
- CohortGroup
- Grup
- Tür
- Bildir
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- Deneyin.
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( |
Alanlar | |
---|---|
reportRequests[] |
İstekler için her isteğin ayrı bir yanıtı olur. En fazla 5 istek olabilir. Tüm istekler aynı |
useResourceQuotas |
Kaynak tabanlı kotaları etkinleştirir (varsayılan olarak |
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( |
Alanlar | |
---|---|
reports[] |
Her bir isteğe karşılık gelen yanıtlar. |
queryCost |
Sorguyu yürütmek için düşülen kaynak kota jetonlarının miktarı. Tüm yanıtları içerir. |
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( |
Alanlar | |
---|---|
viewId |
Verilerin alınacağı Analytics görünüm kimliği. Bir |
dateRanges[] |
İ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 |
samplingLevel |
İstenen rapor örneği boyutu. |
dimensions[] |
İstenen boyutlar. İsteklerin toplam 9 boyutu olabilir. |
dimensionFilterClauses[] |
Boyut Değerlerini filtrelemek için boyut filtresi koşulları. Bunlar mantıksal olarak |
metrics[] |
İstenen metrikler. İstekler en az bir metrik belirtmelidir. İsteklerin toplam 10 metriği olabilir. |
metricFilterClauses[] |
Metrik filtresi koşulları. Bunlar mantıksal olarak |
filtersExpression |
İsteğiniz için döndürülen verileri kısıtlayan boyut veya metrik filtreleri. |
orderBys[] |
Çı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[] |
İ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 |
pivots[] |
Pivot tablo tanımları. İsteklerde en fazla 2 pivot olabilir. |
cohortGroup |
Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa |
pageToken |
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 |
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, |
includeEmptyRows |
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 |
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 |
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 |
Getirilecek boyutun adı (örneğin, |
histogramBuckets[] |
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:
NOT: Herhangi bir boyuta histogram değişikliği uyguluyorsanız ve bu boyutu sıralamada kullanıyorsanız bu amaç için "<50", "1001+", "121-1000", "50-120" Ve artan "<50", "50-120", "121-1000", "1001+" İstemcinin, açıkça histogram değiştirilmiş bir boyut için |
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( |
Alanlar | |
---|---|
operator |
Birden fazla boyut filtresini birleştirme operatörü. Belirtilmemesi halinde |
filters[] |
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( |
Alanlar | |
---|---|
dimensionName |
Filtre uygulanacak boyut. DimensionFilter bir boyut içermelidir. |
not |
Mantıksal |
operator |
Boyutu ifadeyle eşleştirme. Varsayılan değer REGEXP'dir. |
expressions[] |
Eşleştirilecek dizeler veya normal ifade. Operatör |
caseSensitive |
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ı:
|
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:
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( |
Alanlar | |
---|---|
expression |
İ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 |
alias |
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 |
Metrik ifadesinin nasıl biçimlendirilmesi gerektiğini belirtir (örneğin, |
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( |
Alanlar | |
---|---|
operator |
Birden çok metrik filtresini birleştirme operatörü. Belirtilmemesi halinde |
filters[] |
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( |
Alanlar | |
---|---|
metricName |
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 |
Mantıksal |
operator |
|
comparisonValue |
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( |
Alanlar | |
---|---|
fieldName |
Sıralama ölçütü olarak kullanılacak alan. Varsayılan sıralama düzeni artan düzendir. Örnek: |
orderType |
Sipariş türü. Varsayılan orderType öğesi |
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 |
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 |
İstekteki bir dinamik segment tanımı. |
|
segmentId |
Yerleşik veya özel segmentin segment kimliği (örneğin, |
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( |
Alanlar | |
---|---|
name |
Dinamik segmentin adı. |
userSegment |
Segmente dahil edilecek kullanıcıları seçmek için Kullanıcı Segmenti. |
sessionSegment |
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( |
Alanlar | |
---|---|
segmentFilters[] |
Segment, mantıksal bir |
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 |
Alanlar | ||
---|---|---|
not |
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:
|
|
Birleştirme alanı simpleOrSequence . Basit bir segment mi yoksa dizi segmenti tanımı mı? simpleOrSequence şunlardan yalnızca biri olabilir: |
||
simpleSegment |
Basit segment koşulları, birleştirilebilecek bir veya daha fazla boyut/metrik koşulundan oluşur. |
|
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( |
Alanlar | |
---|---|
orFiltersForSegment[] |
Mantıksal |
OrFiltersForSegment
OR
grubundaki segment filtreleri listesi, mantıksal OR operatörüyle birleştirilir.
JSON gösterimi | |
---|---|
{
"segmentFilterClauses": [
{
object( |
Alanlar | |
---|---|
segmentFilterClauses[] |
|
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 |
Alanlar | ||
---|---|---|
not |
Filtrenin tamamlayıcısıyla ( |
|
Birleştirme alanı dimensionOrMetricFilter . Boyut veya metrik filtresi. dimensionOrMetricFilter şunlardan yalnızca biri olabilir: |
||
dimensionFilter |
Segment tanımı için Boyut Filtresi. |
|
metricFilter |
Segment tanımı için Metrik Filtresi. |
SegmentDimensionFilter
Boyut filtresi, bir boyuttaki filtreleme seçeneklerini belirtir.
JSON gösterimi | |
---|---|
{
"dimensionName": string,
"operator": enum( |
Alanlar | |
---|---|
dimensionName |
Filtrenin uygulandığı boyutun adı. |
operator |
Boyutu ifadelerle eşleştirmek için kullanılacak operatör. |
caseSensitive |
Eşleşme büyük/küçük harfe duyarlıysa |
expressions[] |
İfade listesi; tüm operatörler için yalnızca ilk öğe kullanılır |
minComparisonValue |
|
maxComparisonValue |
|
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:
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ı:
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( |
Alanlar | |
---|---|
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 |
Filtrelenecek metrik. |
operator |
Belirtir, metriği karşılaştırmak için gerçekleştirilecek işlemdir. Varsayılan değer: |
comparisonValue |
Karşılaştırma değeri. Operatör |
maxComparisonValue |
Maksimum karşılaştırma değeri yalnızca |
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( |
Alanlar | |
---|---|
segmentSequenceSteps[] |
Dizideki adımların listesi. |
firstStepShouldMatchFirstHit |
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( |
Alanlar | |
---|---|
orFiltersForSegment[] |
Dizi, |
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( |
Alanlar | |
---|---|
dimensions[] |
Ö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[] |
DimensionFilterClauses, bir |
metrics[] |
Özet metrikler. Özet metrikleri, istekte izin verilen toplam metrik sayısı kısıtlamasının bir parçasıdır. |
startGroup |
k metriği istendiyse yanıt, rapordaki k sütunun veriye bağlı bir katını içerecektir. Örneğin, Aşağıda, k sütun gruplarından hangilerinin yanıta dahil edileceğini seçebilirsiniz. |
maxGroupCount |
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( |
Alanlar | |
---|---|
cohorts[] |
Grubun tanımı. |
lifetimeValue |
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:
LifeValue doğru olduğunda:
|
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( |
Alanlar | |
---|---|
name |
Grup için benzersiz bir ad. Tanımlanmamışsa ad, kohort_[1234...] değerleriyle otomatik olarak oluşturulur. |
type |
Grubun türü. Şu anda yalnızca |
dateRange |
Bu |
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( |
Alanlar | |
---|---|
columnHeader |
Sütun başlıkları. |
data |
Yanıt verileri. |
nextPageToken |
Sayfa jetonu 'nu kullanın. |
ColumnHeader
Sütun başlıkları.
JSON gösterimi | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
Alanlar | |
---|---|
dimensions[] |
Yanıttaki boyut adları. |
metricHeader |
Yanıttaki metriklerin metrik başlıkları. |
MetricHeader
Metriklerin başlıkları.
JSON gösterimi | |
---|---|
{ "metricHeaderEntries": [ { object( |
Alanlar | |
---|---|
metricHeaderEntries[] |
Yanıttaki metriklerin başlıkları. |
pivotHeaders[] |
Yanıttaki pivotların başlıkları. |
MetricHeaderEntry
Metrikler için başlık.
JSON gösterimi | |
---|---|
{
"name": string,
"type": enum( |
Alanlar | |
---|---|
name |
Üstbilginin adı. |
type |
Metriğin türü (örneğin, |
PivotHeader
İstekte tanımlanan pivot bölümlerinin her birinin üstbilgileri.
JSON gösterimi | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
Alanlar | |
---|---|
pivotHeaderEntries[] |
Tek bir pivot bölüm başlığı. |
totalPivotGroupsCount |
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( |
Alanlar | |
---|---|
dimensionNames[] |
Pivot yanıtındaki boyutların adı. |
dimensionValues[] |
Özetteki boyutların değerleri. |
metric |
Özetteki metrik için metrik başlığı. |
ReportData
Raporun veri bölümü.
JSON gösterimi | |
---|---|
{ "rows": [ { object( |
Alanlar | |
---|---|
rows[] |
Benzersiz boyut kombinasyonlarının her biri için bir ReportRow satır bulunur. |
totals[] |
İ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: |
rowCount |
Bu sorgu için eşleşen satırların toplam sayısı. |
minimums[] |
Eşleşen tüm satırlarda görülen minimum ve maksimum değerler. İstekteki |
maximums[] |
Eşleşen tüm satırlarda görülen minimum ve maksimum değerler. İstekteki |
samplesReadCounts[] |
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[] |
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 |
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 |
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: |
ReportRow
Rapordaki bir satır.
JSON gösterimi | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
Alanlar | |
---|---|
dimensions[] |
İstenen boyutların listesi. |
metrics[] |
İ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( |
Alanlar | |
---|---|
values[] |
Her değer, istekteki her Metriğe karşılık gelir. |
pivotValueRegions[] |
Her pivot bölgenin değerleri. |
PivotValueRegion
Pivot bölgesindeki metrik değerleri.
JSON gösterimi | |
---|---|
{ "values": [ string ] } |
Alanlar | |
---|---|
values[] |
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 |
Kalan günlük kaynak kotası. |
hourlyQuotaTokensRemaining |
Kalan saatlik kaynak kota jetonları. |