Method: properties.runFunnelReport

Google Analytics etkinlik verilerinizin özelleştirilmiş bir dönüşüm hunisi raporunu döndürür. API'den döndürülen veriler, istenen boyutların ve metriklerin sütunlarını içeren bir tablodur.

Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlarken izlediği adımları görselleştirebilmenizi ve her adımın tamamlanma durumunu hızlıca görebilmenizi sağlar. Potansiyel müşteriler, aktif ürün arayışındaki kullanıcılara ve daha sonra alıcılara nasıl dönüşür? Bir kez satın alanlar nasıl tekrar ürün satın alan kullanıcıların arasına katılır? Bu bilgilere sahip olduğunuzda etkisi düşük veya terk edilmiş müşteri yolculuklarını daha iyi hale getirebilirsiniz. Daha fazla bilgi edinmek için GA4 Dönüşüm Hunisi Keşifleri bölümüne bakın.

Bu yöntem, beta sürüme geçmeden önce söz dizimi ve özelliklerle ilgili geri bildirim toplamak amacıyla alfa kararlılığında kullanıma sunulmuştur. Bu API hakkında geri bildirimde bulunmak için Google Analytics Veri API'si Dönüşüm Hunisi Raporlama Geri Bildirimi formunu doldurun.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

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

Yol parametreleri

Parametreler
property

string

Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövde metninde değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulacağınızı öğrenin. Bir toplu işlem isteğinde bu özellik belirtilmemiş veya toplu düzey özelliğiyle tutarlı olmalıdır.

Örnek: mülkler/1234

İstek içeriği

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

JSON gösterimi 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Alanlar
dateRanges[]

object (DateRange)

Okunacak veri tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırında sıfır tabanlı bir tarih aralığı dizini bulunur. İki tarih aralığı çakışırsa, çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir.
funnel

object (Funnel)

Bu isteğin dönüşüm hunisi yapılandırması. Bu dönüşüm hunisi yapılandırması gerekiyor.
funnelBreakdown

object (FunnelBreakdown)

Belirtildiğinde bu döküm, dönüşüm hunisi tablosu alt rapor yanıtına bir boyut ekler. Bu döküm boyutu, her bir dönüşüm hunisi adımını döküm boyutunun benzersiz değerlerine genişletir. Örneğin, deviceCategory boyutuna göre bir döküm, mobile, tablet, desktop ve toplam için satırlar oluşturur.
funnelNextAction

object (FunnelNextAction)

Belirtilirse sonraki işlem, dönüşüm hunisi görselleştirme alt rapor yanıtına bir boyut ekler. Bu sonraki işlem boyutu, her dönüşüm hunisi adımını sonraki işlemin benzersiz değerleriyle genişletir. Örneğin, eventName boyutunda bir sonraki işlem, birkaç etkinlik (örneğin, session_start ve click) ve toplam için satırlar oluşturur.

Sonraki işlem yalnızca eventName'i ve pageTitle ile pagePath gibi çoğu Sayfa / Ekran boyutunu destekler.
funnelVisualizationType

enum (FunnelVisualizationType)

Dönüşüm hunisi görselleştirme türü, dönüşüm hunisi görselleştirme alt rapor yanıtında bulunan boyutları kontrol eder. Belirtilmezse STANDARD_FUNNEL kullanılır.
segments[]

object (Segment)

Segmentlerin yapılandırmaları. Segmentler, bir mülke ait verilerin alt kümeleridir. Segmentleri olan bir dönüşüm hunisi raporunda, dönüşüm hunisi her segmentte değerlendirilir.

Bu istekte belirtilen her segment, yanıtta ayrı bir satır oluşturur. Yanıtta her segment, adıyla tanımlanır.

Segment parametresi isteğe bağlıdır. İstekler 4 segmentle sınırlıdır.
limit

string (int64 format)

Döndürülecek satırların sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. Kaç API isterseniz isteyin, API istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar fazla boyut değeri yoksa API, istenen limit değerinden daha az satır döndürebilir.
dimensionFilter

object (FilterExpression)

Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Rapor Oluşturma: Boyut Filtreleri bölümüne bakın. Metrikler bu filtrede kullanılamaz.
returnPropertyQuota

boolean

Bu Analytics Mülkünün kotasının geçerli durumunu döndürüp döndürmeyeceğini açar. Kota PropertyQuota içinde döndürülür.

Yanıt gövdesi

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

Dönüşüm hunisi raporu yanıtı iki alt rapor içerir. İki alt rapor, farklı boyut ve metrik kombinasyonlarıdır.

JSON gösterimi 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Alanlar
funnelTable

object (FunnelSubReport)

Dönüşüm hunisi tablosu; dönüşüm hunisi adımı, segment, döküm boyutu, etkin kullanıcı sayısı, tamamlanma oranı, vazgeçme sayısı ve vazgeçme oranı içeren bir rapordur.

Segment boyutu, yalnızca bir segment istendiğinde bu yanıtta bulunur. Döküm boyutu, yalnızca istendiğinde bu yanıtta bulunur.
funnelVisualization

object (FunnelSubReport)

Dönüşüm hunisi görselleştirme; dönüşüm hunisi adımı, segmenti, tarihi, sonraki işlem boyutu ve etkin kullanıcıları içeren bir rapordur.

Segment boyutu, yalnızca bir segment istendiğinde bu yanıtta bulunur. Tarih boyutu, bu yanıtta yalnızca TRENDED_FUNNEL dönüşüm hunisi türü üzerinden istendiyse gösterilir. Sonraki işlem boyutu, yalnızca istek üzerine yanıtta mevcuttur.
propertyQuota

object (PropertyQuota)

Bu Analytics Mülkünün kota durumu, bu istek dahil.
kind

string

Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu kind her zaman "analyticsData#runFunnelReport" sabit dizesidir. JSON'daki yanıt türlerini ayırt etmek için kullanışlıdır.

Yetkilendirme kapsamları

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

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

DateRange

Bitişik bir gün kümesi: startDate, startDate + 1, ..., endDate. En fazla 4 tarih aralığına izin verilir.

JSON gösterimi 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Alanlar
startDate

string

Sorgunun YYYY-MM-DD biçimindeki kapsayıcı başlangıç tarihi. endDate tarihinden sonra olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, mülkün raporlama saat dilimine göre tahmin edilir.
endDate

string

Sorgu için YYYY-MM-DD biçimindeki kapsayıcı bitiş tarihi. startDate tarihinden önce olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, mülkün raporlama saat dilimine göre tahmin edilir.
name

string

Bu tarih aralığına bir ad atar. dateRange boyutu, rapor yanıtında bu adın değerine ayarlanır. Ayarlanırsa date_range_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa tarih aralıkları, istekteki sıfır tabanlı dizine göre adlandırılır: date_range_0, date_range_1 vb.

Dönüşüm hunisi

Dönüşüm hunisi raporu isteğindeki dönüşüm hunisini yapılandırır. Dönüşüm hunisi, bir dizi adımdan geçen kullanıcıları raporlar.

Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlarken izlediği adımları görselleştirebilmenizi ve her adımın tamamlanma durumunu hızlıca görebilmenizi sağlar. Potansiyel müşteriler, aktif ürün arayışındaki kullanıcılara ve daha sonra alıcılara nasıl dönüşür? Bir kez satın alanlar nasıl tekrar ürün satın alan kullanıcıların arasına katılır? Bu bilgilere sahip olduğunuzda etkisi düşük veya terk edilmiş müşteri yolculuklarını daha iyi hale getirebilirsiniz.

JSON gösterimi 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Alanlar
isOpenFunnel

boolean

Açık dönüşüm hunisinde, kullanıcılar dönüşüm hunisine herhangi bir adımda girebilir ve kapalı dönüşüm hunisinde kullanıcılar dönüşüm hunisine ilk adımda girmelidir. İsteğe bağlı. Belirtilmemesi durumunda kapalı bir dönüşüm hunisi kullanılır.
steps[]

object (FunnelStep)

Bu dönüşüm hunisinin sıralı adımları.

Dönüşüm HunisiAdımı

Adımlar, ölçmek istediğiniz kullanıcı yolculuğunu tanımlar. Adımlar, dönüşüm hunisinin bu adımına dahil olmak için kullanıcılarınızın karşılaması gereken bir veya daha fazla koşul içerir.

JSON gösterimi 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Alanlar
name

string

Bu adımın ayırt edici adı. Belirtilmemesi halinde adımlar, dizine eklenen 1 tabanlı bir adla (ör. "0. ", "1. " vb.). Bu ad, funnelStepName boyutu tarafından döndürülen dize değerini tanımlar. Örneğin, isteğin üçüncü dönüşüm hunisi adımında name = Purchase belirtildiğinde dönüşüm hunisi raporu yanıtında 3. Purchase oluşturulur.
isDirectlyFollowedBy

boolean

Doğruysa bu adım, önceki adımı doğrudan izlemelidir. Yanlış değerine ayarlanırsa önceki adım ile bu adım arasında etkinlikler olabilir. Belirtilmemesi halinde isDirectlyFollowedBy yanlış olarak değerlendirilir.
filterExpression

object (FunnelFilterExpression)

Kullanıcılarınızın dönüşüm hunisi yolculuğunun bu adımına dahil edilmek için karşılaması gereken koşul.
withinDurationFromPriorStep

string (Duration format)

Belirtilirse bu adım, önceki adımın tamamlanmasından önceki süre içinde tamamlanmalıdır. withinDurationFromPriorStep, mikrosaniye ayrıntı düzeyinde uç noktayı içerir. Örneğin, 5 saniyelik bir süre 4,9 veya 5,0 saniyeleriyle tamamlanabilir ancak 5 saniye ile 1 mikro saniye ile tamamlanamaz.

withinDurationFromPriorStep isteğe bağlıdır. Belirtilmemesi durumunda adımlar herhangi bir süre ile ayrılabilir.

En fazla dokuz kesirli basamak içeren ve "s" ile biten süre. Örnek: "3.5s".

Dönüşüm Hunisi Filtresi İfadesi

Dönüşüm hunisi filtresi kombinasyonlarını ifade eder.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
Birlik alanı expr. FunnelFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (FunnelFilterExpressionList)

andGroup içindeki FunnelFilterExpression VE ilişkisi var.
orGroup

object (FunnelFilterExpressionList)

orGroup içindeki FunnelFiltreExpression VEYA ilişkisi var.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression notExpression DEĞİLDİR.
funnelFieldFilter

object (FunnelFieldFilter)

Boyut veya metrik için bir dönüşüm hunisi filtresi.
funnelEventFilter

object (FunnelEventFilter)

Tek bir etkinlik adının etkinlikleriyle eşleşen bir filtre oluşturur. Parametre filtresi ifadesi belirtilirse hem tek bir etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin yalnızca bir alt kümesi bu etkinlik filtresiyle eşleşir.

Dönüşüm Hunisi Filtresi Listesi

Dönüşüm hunisi filtre ifadeleri listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (FunnelFilterExpression)

Dönüşüm hunisi filtre ifadeleri listesi.

Dönüşüm HunisiAlan Filtresi

Boyut veya metrik değerlerini filtrelemek için bir ifade.

JSON gösterimi 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
fieldName

string

Boyut adı veya metrik adı.
Birlik alanı one_filter. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için bir filtre.
numericFilter

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.
betweenFilter

object (BetweenFilter)

İki değer arasındaki filtre.

Dize Filtresi

Dize filtresi

JSON gösterimi 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Alanlar
matchType

enum (MatchType)

Bu filtrenin eşleme türü.
value

string

Eşleştirme için kullanılan dize değeri.
caseSensitive

boolean

Doğruysa dize değeri büyük/küçük harfe duyarlıdır.

Eşleme Türü

Dize filtresinin eşleme türü

Sıralamalar
MATCH_TYPE_UNSPECIFIED Belirtilmedi
EXACT Dize değerinin tam eşleşmesi.
BEGINS_WITH Dize değeriyle başlar.
ENDS_WITH Dize değeriyle biter.
CONTAINS Dize değerini içerir.
FULL_REGEXP Dize değerine sahip normal ifade için tam eşleme.
PARTIAL_REGEXP Dize değerine sahip normal ifade için kısmi eşleşme.

Liste Filtresi

Sonuç, dize değerleri listesinde olmalıdır.

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

string

Dize değerlerinin listesi. Boş olmamalıdır.
caseSensitive

boolean

Doğruysa dize değeri büyük/küçük harfe duyarlıdır.

SayısalFiltre

Sayısal değerler veya tarih değerleri için filtreler.

JSON gösterimi 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Alanlar
operation

enum (Operation)

Bu filtrenin işlem türü.
value

object (NumericValue)

Sayısal değer veya tarih değeri.

İşlem

İşlem sayısal bir filtreye uygulandı

Sıralamalar
OPERATION_UNSPECIFIED Belirtilmedi.
EQUAL Eşit
LESS_THAN Şundan düşük:
LESS_THAN_OR_EQUAL Küçük veya eşit
GREATER_THAN Şundan büyük:
GREATER_THAN_OR_EQUAL Büyük veya eşit

SayısalDeğer

Bir sayıyı temsil etmek için.

JSON gösterimi 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Alanlar
Birlik alanı one_value. one_value sayısal değerlerinden biri, aşağıdakilerden yalnızca biri olabilir:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer

Filtre Arasında

Sonucun iki sayı (bu değerler dahil) arasında olması gerektiğini belirtmek isteriz.

JSON gösterimi 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Alanlar
fromValue

object (NumericValue)

Bu sayıyla başlar.
toValue

object (NumericValue)

Bu numarayla sona erer.

Dönüşüm Hunisi Filtresi

Tek bir etkinlik adının etkinlikleriyle eşleşen bir filtre oluşturur. Parametre filtresi ifadesi belirtilirse hem tek bir etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin yalnızca bir alt kümesi bu etkinlik filtresiyle eşleşir.

JSON gösterimi 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Alanlar
eventName

string

Bu filtre, bu tek etkinlik adının etkinlikleriyle eşleşiyor. Etkinlik adı gerekli.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Belirtilirse bu filtre hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinlikleri eşleştirir.

Parametre filtresi ifadesinde yalnızca parametre filtreleri bulunur.

Dönüşüm HunisiFiltreFiltre İfadesi

Parametrelerde huni filtresi kombinasyonlarını ifade eder.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
Birlik alanı expr. FunnelParameterFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (FunnelParameterFilterExpressionList)

andGroup içindeki FunnelParametersFilterExpression bir VE ilişkisine sahiptir.
orGroup

object (FunnelParameterFilterExpressionList)

orGroup içindeki FunnelParametersFilterExpression VEYA VEYA ilişkisine sahiptir.
notExpression

object (FunnelParameterFilterExpression)

FunnelParametersFiltreExpression, notExpression DEĞİLDİR.
funnelParameterFilter

object (FunnelParameterFilter)

Temel dönüşüm hunisi parametresi filtresi.

Dönüşüm HunisiParametreFiltreEkspresListesi

Dönüşüm hunisi parametresi filtre ifadeleri listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (FunnelParameterFilterExpression)

Dönüşüm hunisi parametresi filtre ifadeleri listesi.

Dönüşüm HunisiParametreFiltresi

Bir dönüşüm hunisindeki parametre değerlerini filtrelemek için bir ifade.

JSON gösterimi 
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
Birlik alanı one_parameter. Filtrelenen alan. one_parameter aşağıdakilerden yalnızca biri olabilir:
eventParameterName

string

Bu filtre, belirtilen etkinlik parametresi için değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri "firebase_screen" ve "currency" gibi alanları içerir.

Etkinlik parametreleri yalnızca segmentler ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'den bir alt filtrede kullanılabilir. Bir EventFilter'in alt filtresinde etkinlik veya öğe parametreleri kullanılmalıdır.
itemParameterName

string

Bu filtre, belirtilen öğe parametresi için değerlendirilir. Öğe parametreleri, öğe dizisine parametre olarak kaydedilir. Öğe parametreleri "item_name" ve "item_category" gibi alanlar içerir.

Öğe parametreleri yalnızca segmentler ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'den alt filtrede kullanılabilir. Bir EventFilter'in alt filtresinde etkinlik veya öğe parametreleri kullanılmalıdır.

Öğe parametreleri yalnızca e-ticaret etkinliklerinde kullanılabilir. E-ticaret etkinlikleri hakkında daha fazla bilgi edinmek için E-ticareti ölçme kılavuzunu inceleyin.
Birlik alanı one_filter. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için bir filtre.
numericFilter

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.
betweenFilter

object (BetweenFilter)

İki değer arasındaki filtre.

Dönüşüm Hunisi Dökümü

Dökümler, dönüşüm hunisi tablosu alt rapor yanıtına bir boyut ekler.

JSON gösterimi 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Alanlar
breakdownDimension

object (Dimension)

Dönüşüm hunisi tablosu alt rapor yanıtına eklenen boyut sütunu. Döküm boyutu, huni adımlarının dökümünü alır. funnelBreakdown belirtilmişse geçerli bir breakdownDimension gerekir.
limit

string (int64 format)

Yanıtta döndürülecek döküm boyutunun maksimum farklı değer sayısı. Sınır belirtilmezse 5 arasından limit kullanılır. Sınır değeri 15'i geçmemeli.

Boyut

Boyutlar verilere ilişkin özelliklerdir. Örneğin, şehir boyutu, bir etkinliğin kaynağı olan şehri belirtir. Rapor yanıtlarındaki boyut değerleri dizedir. Örneğin, şehir "Paris" veya "New York" olabilir.

JSON gösterimi 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Alanlar
name

string

Boyut adı. Boyut adlarının listesi için API Boyutları konusuna bakın.

dimensionExpression belirtilmişse name, izin verilen karakter kümesinde olmasını istediğiniz herhangi bir dize olabilir. Örneğin, dimensionExpression (country ve city) birleşiyorsa bu boyutu countryAndCity olarak adlandırabilirsiniz. Seçtiğiniz boyut adları ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Boyutlara dimensionFilter, orderBys, dimensionExpression ve pivots boyutlarındaki name tarafından referansta bulunuluyor.
dimensionExpression

object (DimensionExpression)

Bir boyut, birden fazla boyut ifadesinden kaynaklanıyor olabilir. Örneğin, "ülke, şehir" boyutu: concatenate(ülke, ", ", şehir).

Boyut İfadesi

Birden fazla boyut formülünün sonucu olarak bir boyutu ifade etmek için kullanılır. Örnek kullanımlar: 1) LowCase(boyut) 2) bağlayıcı(boyut1, simge, boyut2).

JSON gösterimi 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Alanlar
Birlik alanı one_expression. DimensionExpression için bir boyut ifadesi türü belirtin. one_expression aşağıdakilerden yalnızca biri olabilir:
lowerCase

object (CaseExpression)

Boyut değerini küçük harfe dönüştürmek için kullanılır.
upperCase

object (CaseExpression)

Boyut değerini büyük harfe dönüştürmek için kullanılır.
concatenate

object (ConcatenateExpression)

Boyut değerlerini tek bir boyutta birleştirmek için kullanılır. Örneğin, "ülke, şehir" boyutu: concatenate(ülke, ", ", şehir).

Vaka İfadesi

Boyut değerini tek bir büyük/küçük harfe dönüştürmek için kullanılır.

JSON gösterimi 
{
  "dimensionName": string
}
Alanlar
dimensionName

string

Boyut adı. Ad, isteğin boyutlar alanındaki adı tekrar belirtmelidir.

Ekspres İfade

Boyut değerlerini tek bir boyutta birleştirmek için kullanılır.

JSON gösterimi 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Alanlar
dimensionNames[]

string

Boyutların adları. Adlar, isteğin boyutlar alanındaki adlara geri dönmelidir.
delimiter

string

Boyut adları arasına yerleştirilen sınırlayıcı.

Ayırıcılar genellikle "|" veya "," gibi tek karakterlerdir, ancak daha uzun dizeler olabilir. Bir boyut değeri ayırıcıyı içeriyorsa ikisi de ayrım olmadan yanıt olarak görünür. Örneğin, 1. boyut = "US,FR", 2. boyut = "JP" ve sınırlayıcı = "," ise yanıt "US,FR,JP" ifadesini içerir.

Dönüşüm Hunisi Sonraki İşlemi

Sonraki işlemler, kullanıcı bir adıma ulaştıktan sonra ancak aynı kullanıcı bir sonraki adıma geçmeden önce boyutun değerini belirtir. Örneğin, nextActionDimension eventName ise i. dönüşüm hunisi adımı satırındaki nextActionDimension, kullanıcıyı i. dönüşüm hunisi adımına dahil eden ancak etkinlikten i+1. dönüşüm hunisi adımına ulaşmadan önce ilk etkinliği döndürür.

JSON gösterimi 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Alanlar
nextActionDimension

object (Dimension)

Dönüşüm hunisi görselleştirme alt rapor yanıtına eklenen boyut sütunu. Bir sonraki işlem boyutu, kullanıcı i. dönüşüm hunisi adımına ulaştıktan sonra bu boyutun bir sonraki boyut değerini döndürür.

nextActionDimension, şu anda yalnızca eventName boyutlarını ve pageTitle, pagePath gibi çoğu Sayfa / Ekran boyutunu destekler. nextActionDimension bir boyut ifadesi olamaz.
limit

string (int64 format)

Yanıtta döndürülecek döküm boyutunun maksimum farklı değer sayısı. Sınır belirtilmezse 5 arasından limit kullanılır. Sınır sıfır olmamalı ve 5'i geçmemelidir.

Dönüşüm Hunisi Görselleştirme Türü

Dönüşüm hunisi görselleştirme alt rapor yanıtında bulunan boyutları kontrol eder.

Sıralamalar
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Tür belirtilmedi.
STANDARD_FUNNEL Standart (adımlı) dönüşüm hunisi. Yanıttaki dönüşüm hunisi görselleştirme alt raporu tarih içermez.
TRENDED_FUNNEL Trend (çizgi grafik) dönüşüm hunisi. Yanıttaki dönüşüm hunisi görselleştirme alt raporu tarih boyutunu içerir.

Segment

Segment, Analytics verilerinizin bir alt kümesidir. Örneğin, tüm kullanıcı grubunuz içinde belirli bir ülkedeki veya şehirdeki kullanıcılar bir segment oluşturabilir. Bir diğer segment ise belirli bir ürün grubunu satın alan veya sitenizin belirli bir bölümünü ziyaret eden ya da uygulamanızda belirli etkinlikleri tetikleyen kullanıcılar olabilir.

Daha fazla bilgi edinmek için GA4 Segment Oluşturucu bölümüne bakın.

JSON gösterimi 
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Alanlar
name

string

Bu segmentin adı. Belirtilmemesi halinde segmentler "Segment" olarak adlandırılır. Bu ad, segment boyutu tarafından döndürülen dize değerini tanımlar. segment boyutu, segment adlarının önüne istekteki segmentin 1 tabanlı dizin numarasını ekler (ör. "1. Segment", "2. Segment").
Birlik alanı one_segment_scope. Bir segment tek bir kapsamda belirtilir. one_segment_scope aşağıdakilerden yalnızca biri olabilir:
userSegment

object (UserSegment)

Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşime geçen kullanıcıların alt kümeleridir.
sessionSegment

object (SessionSegment)

Oturum segmentleri, sitenizde veya uygulamanızda gerçekleşen oturumların alt kümeleridir.
eventSegment

object (EventSegment)

Etkinlik segmentleri, sitenizde veya uygulamanızda tetiklenen etkinliklerin alt kümeleridir.

KullanıcıSegmenti

Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşime geçen kullanıcıların alt kümeleridir. Örneğin, daha önce satın alma işlemi gerçekleştirmiş kullanıcılar, alışveriş sepetlerine ürün eklemiş ancak satın alma işlemini tamamlamamış kullanıcılar.

JSON gösterimi 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Alanlar
userInclusionCriteria

object (UserSegmentCriteria)

Bu segmente hangi kullanıcıların dahil edileceğini tanımlar. İsteğe bağlı.
exclusion

object (UserSegmentExclusion)

Bu segmentte hangi kullanıcıların hariç tutulacağını tanımlar. İsteğe bağlı.

KullanıcıSegmentÖlçüleri

Bir kullanıcının etkinlikleri ölçütlerdeki koşulları karşılıyorsa söz konusu kullanıcı ölçütleri eşleştirir.

JSON gösterimi 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Alanlar
andConditionGroups[]

object (UserSegmentConditionGroup)

Bir kullanıcı, bu andConditionGroups ve her andSequenceGroups ile eşleşirse bu ölçütlerle eşleşir. andSequenceGroups belirtilirse andConditionGroups boş olabilir.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Bir kullanıcı, bu andSequenceGroups ve her andConditionGroups ile eşleşirse bu ölçütlerle eşleşir. andConditionGroups belirtilirse andSequenceGroups boş olabilir.

KullanıcıSegmentKoşuluGrubu

Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.

JSON gösterimi 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Alanlar
conditionScoping

enum (UserCriteriaScoping)

Veriler, koşul grubuyla eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. Bu kapsam, koşul grubunun eşleşip eşleşmediği belirlenmeden önce segmentFilterExpression öğesinin kaç etkinlikte değerlendirildiğini tanımlar. Örneğin, ifade conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION ise bir ifade bir oturumdaki tüm etkinliklerde değerlendirilir ve koşul grubunun bu kullanıcıyla eşleşip eşleşmediği belirlenir. Örneğin, conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT ifadesi tek bir etkinlikte değerlendirilir ve koşul grubu bu kullanıcı için eşleştirilir veya eşleştirilmez.

İsteğe bağlı. Belirtilmemesi halinde conditionScoping = ACROSS_ALL_SESSIONS kullanılır.
segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrikler ve/veya parametrelerle ilgili ölçütleri ifade eder.

KullanıcıÖlçütleri Kapsamı

Kapsam oluşturma, kullanıcının bir ölçütü karşılayıp karşılamadığı değerlendirilirken hangi etkinliklerin dikkate alınacağını belirtir.

Sıralamalar
USER_CRITERIA_SCOPING_UNSPECIFIED Ölçütler belirtilmemiş. Belirtme.
USER_CRITERIA_WITHIN_SAME_EVENT Ölçütler bir etkinlikte karşılanırsa kullanıcı ölçütleri karşılar.
USER_CRITERIA_WITHIN_SAME_SESSION Ölçütler bir oturumda karşılanırsa kullanıcı ölçütlerle eşleşir.
USER_CRITERIA_ACROSS_ALL_SESSIONS Ölçütler, kullanıcı için herhangi bir etkinlik tarafından karşılanırsa kullanıcı ölçütlerle eşleşir.

SegmentFiltre İfadesi

Segment filtrelerinin kombinasyonlarını ifade eder.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
Birlik alanı expr. SegmentFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (SegmentFilterExpressionList)

andGroup içindeki SegmentFilterExpression ile VE ilişkisi vardır.
orGroup

object (SegmentFilterExpressionList)

orGroup içindeki SegmentFilterExpression VEYA VEYA ilişkisine sahiptir.
notExpression

object (SegmentFilterExpression)

SegmentFilterExpression notExpression DEĞİLDİR.
segmentFilter

object (SegmentFilter)

Temel segment filtresi.
segmentEventFilter

object (SegmentEventFilter)

Tek bir etkinlik adının etkinlikleriyle eşleşen bir filtre oluşturur. Parametre filtresi ifadesi belirtilirse hem tek bir etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin yalnızca bir alt kümesi bu etkinlik filtresiyle eşleşir.

SegmentFiltre İfadesi Listesi

Segment filtresi ifadeleri listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (SegmentFilterExpression)

Segment filtresi ifadeleri listesi

SegmentFiltresi

Boyut veya metrik değerlerini filtrelemek için bir ifade.

JSON gösterimi 
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
fieldName

string

Boyut adı veya metrik adı.
filterScoping

object (SegmentFilterScoping)

Filtrenin kapsamını belirtir.
Birlik alanı one_filter. Filter için bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için bir filtre.
numericFilter

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.
betweenFilter

object (BetweenFilter)

İki değer arasındaki filtre.

SegmentFiltre Kapsamı

Kapsamlar, bir segment filtresi değerlendirilirken birden fazla etkinliğin boyut ve metriklerinin nasıl dikkate alınması gerektiğini belirtir.

JSON gösterimi 
{
  "atAnyPointInTime": boolean
}
Alanlar
atAnyPointInTime

boolean

atAnyPointInTime değeri doğruysa bu filtre, isteğin tarih aralığındaki herhangi bir etkinlik için doğru olarak değerlendirilirse tüm etkinlikler için doğru olarak değerlendirilir.

Bu atAnyPointInTime parametresi, rapordaki etkinliklerin tarih aralığını genişletmez. atAnyPointInTime doğruysa bu filtre değerlendirilirken yalnızca raporun tarih aralığındaki etkinlikler dikkate alınır.

Bu atAnyPointInTime, yalnızca ölçüt ölçütlerinin ACROSS_ALL_SESSIONS olması ve adım sıralarında belirlenebilmesi mümkün değildir.

Ölçütler kapsam ACROSS_ALL_SESSIONS ise atAnyPointInTime = belirtilmemişse yanlış değeri kullanılır.

SegmentEtkinlik Filtresi

Tek bir etkinlik adının etkinlikleriyle eşleşen bir filtre oluşturur. Parametre filtresi ifadesi belirtilirse hem tek bir etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin yalnızca bir alt kümesi bu etkinlik filtresiyle eşleşir.

JSON gösterimi 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Alanlar
eventName

string

Bu filtre, bu tek etkinlik adının etkinlikleriyle eşleşiyor. Etkinlik adı gerekli.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Belirtilirse bu filtre hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinlikleri eşleştirir.

Parametre filtresi ifadesinde yalnızca parametre filtreleri bulunur.

SegmentParametreFiltreEkspres

Parametrelerde segment filtresi kombinasyonlarını ifade eder.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
Birlik alanı expr. SegmentParameterFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (SegmentParameterFilterExpressionList)

andGroup içindeki SegmentParametersFilterExpression bir VE ilişkisine sahiptir.
orGroup

object (SegmentParameterFilterExpressionList)

orGroup içindeki SegmentParametreFiltreEkspresi VEYA ilişkisine sahip.
notExpression

object (SegmentParameterFilterExpression)

SegmentParametersFiltreExpression, notExpression DEĞİLDİR.
segmentParameterFilter

object (SegmentParameterFilter)

Temel segment parametresi filtresi.

SegmentParametreFiltreEkspresListesi

Segment parametresi filtre ifadeleri listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (SegmentParameterFilterExpression)

Segment parametresi filtre ifadeleri listesi.

SegmentParametreFiltresi

Bir segmentteki parametre değerlerini filtrelemek için bir ifade.

JSON gösterimi 
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
filterScoping

object (SegmentParameterFilterScoping)

Filtrenin kapsamını belirtir.
Birlik alanı one_parameter. Filtrelenen alan. one_parameter aşağıdakilerden yalnızca biri olabilir:
eventParameterName

string

Bu filtre, belirtilen etkinlik parametresi için değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri "firebase_screen" ve "currency" gibi alanları içerir.

Etkinlik parametreleri yalnızca segmentler ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'den bir alt filtrede kullanılabilir. Bir EventFilter'in alt filtresinde etkinlik veya öğe parametreleri kullanılmalıdır.
itemParameterName

string

Bu filtre, belirtilen öğe parametresi için değerlendirilir. Öğe parametreleri, öğe dizisine parametre olarak kaydedilir. Öğe parametreleri "item_name" ve "item_category" gibi alanlar içerir.

Öğe parametreleri yalnızca segmentler ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'den alt filtrede kullanılabilir. Bir EventFilter'in alt filtresinde etkinlik veya öğe parametreleri kullanılmalıdır.

Öğe parametreleri yalnızca e-ticaret etkinliklerinde kullanılabilir. E-ticaret etkinlikleri hakkında daha fazla bilgi edinmek için E-ticareti ölçme kılavuzunu inceleyin.
Birlik alanı one_filter. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için bir filtre.
numericFilter

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.
betweenFilter

object (BetweenFilter)

İki değer arasındaki filtre.

SegmentParametreFiltreFiltresi

Kapsamlar, bir segment parametresi filtresini değerlendirirken birden fazla etkinliğin dikkate alınması gerektiğini belirtir.

JSON gösterimi 
{
  "inAnyNDayPeriod": string
}
Alanlar
inAnyNDayPeriod

string (int64 format)

Filtreyi uygulamadan önce, belirtilen gün aralığında parametreyi toplar. Yalnızca ölçüt kapsamının ACROSS_ALL_SESSIONS veya WITHIN_SAME_SESSION olması durumunda desteklenir. Yalnızca parametre event_count ise desteklenir.

Örneğin, inAnyNDayPeriod 3 ise, etkinlik adı "purchase", etkinlik parametresi "event_count" ve Filtre'nin ölçütleri 5'ten büyükse bu filtre, raporun tarih aralığındaki art arda her 3 günlük dönemdeki satın alma etkinliklerinin etkinlik sayısını toplar. Bir kullanıcı, satın alma etkinliği sayısı art arda üç gün içinde 5'i aşarsa bu Filtreye dahil edilecek ölçütleri aktarır. Örneğin, 01.11.2021-03.11.2021,02.11.2021-03.11.2021-05.11.2021 ile 05.11.2021 arasında geçerli olan dönemler göz önünde bulundurulur.

Tarih aralığı, tarih aralığının başlangıcına yakın bir tam N günlük zaman aralığı olacak şekilde genişletilmez. Örneğin, 11.11.2021 ile 10.11.2021 ve inAnyNDayPeriod = 3 içinse rapordaki tarih aralığı dışındaki hiçbir etkinlik verisi okunmayacağından ilk iki günlük dönem etkili bir şekilde kısaltılacaktır. Örneğin, ilk dört dönem etkili bir şekilde olacaktır: 01.11.2021-01.11.2021-01.11.2021, 01.11.2021-01.11.2021-01.11.2021-01.21.2021

inAnyNDayPeriod isteğe bağlıdır. Belirtilmezse segmentParameterFilter her etkinliğe ayrı ayrı uygulanır.

KullanıcıSegmenti Sıra Grubu

Kullanıcının segmentin bir üyesi olması için belirli bir sırada gerçekleşmesi gereken koşulları tanımlayın.

JSON gösterimi 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Alanlar
sequenceScoping

enum (UserCriteriaScoping)

Kullanıcının diziyle eşleşebilmesi için tüm dizi adımları, kapsam belirlemede de karşılanmalıdır. Örneğin, sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION etkinliğinde kullanıcının diziyle eşleşmesi için tüm dizi adımlarının tek bir oturumda tamamlanması gerekir. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT desteklenmiyor.

İsteğe bağlı. Belirtilmemesi halinde conditionScoping = ACROSS_ALL_SESSIONS kullanılır.
sequenceMaximumDuration

string (Duration format)

Tüm adım sırasının tamamlanması için gereken süreyi (ör. 30 Dakika) tanımlar. sequenceMaximumDuration, mikrosaniye ayrıntı düzeyinde uç noktayı içerir. Örneğin, maksimum 5 saniye uzunluğunda bir dizi 4,9 veya 5,0 saniyesinde tamamlanabilir ancak 5 saniye ve 1 mikrosaniyede tamamlanmaz.

sequenceMaximumDuration isteğe bağlıdır. Belirtilmemesi durumunda diziler herhangi bir süre içinde tamamlanabilir.

En fazla dokuz kesirli basamak içeren ve "s" ile biten süre. Örnek: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Koşul adımlarının sırası. Bir kullanıcının UserSegmentSequenceGroup ile eşleşmesi için kullanıcının etkinliklerinin her adımı tamamlaması gerekir.

KullanıcıAdımıAdımı

Bu kullanıcının diziyle eşleşmesi için belirtilen adım sırasında gerçekleşmesi gereken bir koşul.

JSON gösterimi 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Alanlar
isDirectlyFollowedBy

boolean

Doğruysa, bu adımı karşılayan etkinlik, son adımı karşılayan etkinlikten hemen sonraki etkinlik olmalıdır. Yanlış değerine ayarlanırsa bu adım, önceki adımı dolaylı olarak takip eder. Örneğin, önceki adım ile bu adım arasında etkinlikler olabilir. isDirectlyFollowedBy ilk adım için yanlış olmalıdır.
stepScoping

enum (UserCriteriaScoping)

Kullanıcının diziyle eşleşmesi için bu adım adımının kapsam kapsamının karşılanması gerekir. Örneğin, sequenceScoping = WITHIN_SAME_SESSION etkinliğinde bu adım adımları, kullanıcının diziyle eşleşmesi için bir oturum içinde tamamlanmalıdır. stepScoping = ACROSS_ALL_SESSIONS öğesine yalnızca sequenceScoping = ACROSS_ALL_SESSIONS durumunda izin verilir.

İsteğe bağlı. Belirtilmemesi halinde stepScoping, sequenceScoping ile aynı UserCriteriaScoping değerini kullanır.
segmentFilterExpression

object (SegmentFilterExpression)

Bir kullanıcının etkinlikleri bu ifadeyle eşleşirse kullanıcı bu dizi adımıyla eşleşir. İfadeler; boyut, metrikler ve/veya parametrelerle ilgili ölçütleri ifade eder.

Kullanıcı Segmenti Hariç Tutma

Bu segmentte hangi kullanıcıların hariç tutulacağını belirtir.

JSON gösterimi 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Alanlar
userExclusionDuration

enum (UserExclusionDuration)

Kullanıcı userExclusionCriteria ile eşleşirse hariç tutma işleminin ne kadar süreceğini belirtir.

İsteğe bağlı. Belirtilmemesi durumunda userExclusionDuration/USER_EXCLUSION_TEMPORARY kullanılır.
userExclusionCriteria

object (UserSegmentCriteria)

Bir kullanıcı bu koşulu karşılarsa userExclusionDuration için segment üyeliğinden çıkarılır.

Kullanıcı Hariç Tutma Süresi

Kullanıcı userExclusionCriteria ile eşleşirse hariç tutma işleminin ne kadar süreceğiyle ilgili seçenekleri gösterir.

Sıralamalar
USER_EXCLUSION_DURATION_UNSPECIFIED Belirtilmemiş hariç tutma süresi. Belirtme.
USER_EXCLUSION_TEMPORARY Kullanıcının userExclusionCriteria koşulunu karşıladığı dönemlerde kullanıcıları geçici olarak segmentten hariç tutun.
USER_EXCLUSION_PERMANENT Kullanıcı userExclusionCriteria koşulunu karşılarsa kullanıcıları segmentten kalıcı olarak hariç tutun.

Oturum Segmenti

Oturum segmentleri, sitenizde veya uygulamanızda gerçekleşen oturumların alt kümeleridir: örneğin, belirli bir reklam kampanyasından kaynaklanan tüm oturumlar.

JSON gösterimi 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Alanlar
sessionInclusionCriteria

object (SessionSegmentCriteria)

Bu segmente hangi oturumların dahil edileceğini tanımlar. İsteğe bağlı.
exclusion

object (SessionSegmentExclusion)

Bu segmentte hangi oturumların hariç tutulacağını tanımlar. İsteğe bağlı.

Oturum SegmentiÖlçütleri

Bir oturumun etkinlikleri, ölçütlerdeki koşulları karşılıyorsa oturum bu ölçütlerle eşleşir.

JSON gösterimi 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Alanlar
andConditionGroups[]

object (SessionSegmentConditionGroup)

Bir oturum bu andConditionGroups ölçütlerinden her biriyle eşleşiyorsa bu ölçütlerle eşleşir.

OturumBölümKoşuluGrubu

Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.

JSON gösterimi 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Alanlar
conditionScoping

enum (SessionCriteriaScoping)

Veriler, koşul grubuyla eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. Bu kapsam, koşul grubunun eşleşip eşleşmediği belirlenmeden önce segmentFilterExpression öğesinin kaç etkinlikte değerlendirildiğini tanımlar. Örneğin, ifade conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION ise bir ifade, bir oturumdaki tüm etkinliklerde değerlendirilir ve koşul grubunun bu oturumla eşleşip eşleşmediği belirlenir. Örneğin, conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT ifadesi ifadede tek bir etkinlikte değerlendiriliyorsa koşul grubunun bu oturumla eşleşip eşleşmediği belirlenir.

İsteğe bağlı. Belirtilmemesi durumunda conditionScoping/WITHIN_SAME_SESSION kullanılır.
segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrikler ve/veya parametrelerle ilgili ölçütleri ifade eder.

OturumÖlçütü Kapsamı

Kapsam oluşturma, bir oturumun kriterlere uygun olup olmadığını değerlendirirken hangi etkinliklerin dikkate alınacağını belirtir.

Sıralamalar
SESSION_CRITERIA_SCOPING_UNSPECIFIED Ölçütler belirtilmemiş. Belirtme.
SESSION_CRITERIA_WITHIN_SAME_EVENT Ölçütler bir etkinlikte karşılanırsa oturum ölçütlerle eşleşir.
SESSION_CRITERIA_WITHIN_SAME_SESSION Ölçütler bir oturumda karşılanırsa oturum ölçütlerle eşleşir.

Oturum Segmenti Hariç Tutma

Bu segmentte hangi oturumların hariç tutulacağını belirtir.

JSON gösterimi 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Alanlar
sessionExclusionDuration

enum (SessionExclusionDuration)

Bir oturum sessionExclusionCriteria ile eşleşirse hariç tutma işleminin ne kadar süreceğini belirtir.

İsteğe bağlı. Belirtilmemesi durumunda sessionExclusionDuration/SESSION_EXCLUSION_TEMPORARY kullanılır.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Bir oturum bu koşulu karşılıyorsa sessionExclusionDuration segmenti için üyelikten çıkarılır.

Oturum Hariç Tutma Süresi

Bir oturum sessionExclusionCriteria ile eşleşirse hariç tutma işleminin ne kadar süreceğiyle ilgili seçenekleri gösterir.

Sıralamalar
SESSION_EXCLUSION_DURATION_UNSPECIFIED Belirtilmemiş hariç tutma süresi. Belirtme.
SESSION_EXCLUSION_TEMPORARY Oturumun sessionExclusionCriteria koşulunu karşıladığı dönemlerde oturumları segmentten geçici olarak hariç tutun.
SESSION_EXCLUSION_PERMANENT Oturum sessionExclusionCriteria koşulunu karşılıyorsa oturumları segmentten kalıcı olarak hariç tutun.

EtkinlikSegmenti

Etkinlik segmentleri, sitenizde veya uygulamanızda tetiklenen etkinliklerin alt kümeleridir. Örneğin, belirli bir konumda gerçekleştirilen tüm satın alma etkinlikleri, belirli bir işletim sisteminde gerçekleşen app_exception etkinlikleri.

JSON gösterimi 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Alanlar
eventInclusionCriteria

object (EventSegmentCriteria)

Bu segmente hangi etkinliklerin dahil edileceğini tanımlar. İsteğe bağlı.
exclusion

object (EventSegmentExclusion)

Bu segmentte hangi etkinliklerin hariç tutulacağını tanımlar. İsteğe bağlı.

EventSegmentÖlçüleri

Bir etkinlik, ölçütlerdeki koşulları karşılıyorsa ölçütlerle eşleşir.

JSON gösterimi 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Alanlar
andConditionGroups[]

object (EventSegmentConditionGroup)

Bir etkinlik bu andConditionGroups kriterlerinin her biriyle eşleşiyorsa bu ölçütlerle eşleşir.

EtkinlikSegmentKoşuluGrubu

Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.

JSON gösterimi 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Alanlar
conditionScoping

enum (EventCriteriaScoping)

conditionScoping her zaman EVENT_CRITERIA_WITHIN_SAME_EVENT olmalıdır.

İsteğe bağlı. Belirtilmemesi durumunda conditionScoping/EVENT_CRITERIA_WITHIN_SAME_EVENT kullanılır.
segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrikler ve/veya parametrelerle ilgili ölçütleri ifade eder.

EtkinlikÖlçütleri Kapsamı

Kapsam oluşturma, bir etkinliği belirli bir ölçüte göre değerlendirirken değerlendirilen etkinlikleri belirtir.

Sıralamalar
EVENT_CRITERIA_SCOPING_UNSPECIFIED Ölçütler belirtilmemiş. Belirtme.
EVENT_CRITERIA_WITHIN_SAME_EVENT Ölçütler bir etkinlikte karşılanırsa etkinlik ölçütlerle eşleşir.

EtkinlikSegment Hariç Tutma

Bu segmentte hangi etkinliklerin hariç tutulacağını belirtir.

JSON gösterimi 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Alanlar
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration her zaman PERMANENTLY_EXCLUDE olmalıdır.

İsteğe bağlı. Belirtilmemesi durumunda eventExclusionDuration/EVENT_EXCLUSION_PERMANENT kullanılır.
eventExclusionCriteria

object (EventSegmentCriteria)

Bir etkinlik bu koşulu karşılarsa eventExclusionDuration için segment üyeliğinden hariç tutulur.

EtkinlikHariç Tutma Süresi

Bir etkinlik eventExclusionCriteria ile eşleşirse hariç tutma işleminin ne kadar süreceğiyle ilgili seçenekleri gösterir.

Sıralamalar
EVENT_EXCLUSION_DURATION_UNSPECIFIED Belirtilmemiş hariç tutma süresi. Belirtme.
EVENT_EXCLUSION_PERMANENT Etkinlik eventExclusionCriteria koşulunu karşılarsa etkinlikleri segmentten kalıcı olarak hariç tutun.

Filtre İfadesi

Boyut veya metrik filtrelerini ifade etmek için. Aynı Filtre İfadesindeki alanlar, tüm boyutlar veya tüm metrikler olmalıdır.

JSON gösterimi 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Alanlar
Birlik alanı expr. FilterExpression için bir filtre ifadesi türü belirtin. expr aşağıdakilerden yalnızca biri olabilir:
andGroup

object (FilterExpressionList)

&Group içindeki Filtre İfadelerinin VE ilişkisi var.
orGroup

object (FilterExpressionList)

OrGroup içindeki Filtre Expressions OR ilişkisine sahiptir.
notExpression

object (FilterExpression)

FiltreExpression, notExpression DEĞİLDİR.
filter

object (Filter)

Temel filtre. Aynı Filtre Expression'da filtrenin tüm alan adları ya tüm boyutlar ya da tüm metrikler olmalıdır.

Filtre İfadesi Listesi

Filtre ifadelerinin listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (FilterExpression)

Filtre ifadelerinin listesi.

Filtre

Boyut veya metrik değerlerini filtrelemek için bir ifade.

JSON gösterimi 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Alanlar
fieldName

string

Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanan bir ad olmalıdır.
Birlik alanı one_filter. Filter için bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste içi değerler için bir filtre.
numericFilter

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.
betweenFilter

object (BetweenFilter)

İki değer arasındaki filtre.

Dönüşüm Hunisi Alt Raporu

Dönüşüm hunisi alt raporları, boyut ve metrik veri değerlerini içerir. Örneğin, 12 kullanıcı dönüşüm hunisinin ikinci adımına ulaştı.

JSON gösterimi 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Alanlar
dimensionHeaders[]

object (DimensionHeader)

Boyut sütunlarını açıklar. Dönüşüm hunisi raporları, alt rapor yanıtlarında her zaman dönüşüm hunisi adım boyutunu içerir. İstenirse yanıtta dökümler, tarihler ve sonraki işlemler gibi ek boyutlar yer alabilir.
metricHeaders[]

object (MetricHeader)

Metrik sütunlarını açıklar. Dönüşüm hunisi raporları, alt rapor yanıtlarına her zaman etkin kullanıcıları dahil eder. Dönüşüm hunisi tablosunda tamamlama oranı, vazgeçme sayısı ve vazgeçme oranı gibi ek metrikler bulunur.
rows[]

object (Row)

Rapordaki boyut-değer kombinasyonları ve metrik değerleri satırları.
metadata

object (FunnelResponseMetadata)

Dönüşüm hunisi raporu için meta veriler.

Boyut Başlığı

Rapordaki bir boyut sütununu açıklar. Bir raporda istenen boyutlar, satırlarda ve Boyut Başlıklarında sütun girişleri oluşturur. Ancak, yalnızca filtrelerde veya ifadelerde kullanılan boyutlar bir raporda sütun oluşturmaz. Bu nedenle, bu boyutlar başlık oluşturmaz.

JSON gösterimi 
{
  "name": string
}
Alanlar
name

string

Boyut adı.

Metrik Başlığı

Rapordaki bir metrik sütununu açıklar. Bir raporda istenen görünür metrikler, satırlarda ve MetricHeaders'ta sütun girişleri oluşturur. Ancak, yalnızca filtrelerde veya ifadelerde kullanılan metrikler bir raporda sütun oluşturmaz. Bu nedenle, bu metrikler başlık oluşturmaz.

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

string

Metriğin adı.
type

enum (MetricType)

Metriğin veri türü.

Metrik Türü

Bir metriğin değer türü.

Sıralamalar
METRIC_TYPE_UNSPECIFIED Tür belirtilmedi.
TYPE_INTEGER Tam sayı türü.
TYPE_FLOAT Kayan nokta türü.
TYPE_SECONDS Saniyelik süre; özel bir kayan nokta türü.
TYPE_MILLISECONDS Milisaniye cinsinden süre; özel bir kayan nokta türü.
TYPE_MINUTES Dakika cinsinden süre; özel bir kayan nokta türü.
TYPE_HOURS Saat cinsinden süre; özel bir kayan nokta türü.
TYPE_STANDARD Standart türe ait özel bir metrik, özel bir kayan nokta türü.
TYPE_CURRENCY Bir miktar para (kayan nokta) türü.
TYPE_FEET Fitin uzunluğu; özel bir kayan nokta türü.
TYPE_MILES Mil cinsinden uzunluk; özel bir kayan nokta türü.
TYPE_METERS Metre cinsinden uzunluk; özel bir kayan nokta türü.
TYPE_KILOMETERS Kilometre cinsinden uzunluk; özel bir kayan nokta türü.

Satır

Her satır için rapor verileri. Örneğin, RunReportRequest şunları içeriyorsa:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

eventName için "in_app_purchase", countryId "JP" ve etkinlik sayısı 15 olan bir satır şu şekilde olur:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
JSON gösterimi 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Alanlar
dimensionValues[]

object (DimensionValue)

İstenen boyut değerlerinin listesi. Bir PivotReport raporunda, boyut değerleri yalnızca bir pivot aramaya dahil edilen boyutlar için listelenir.
metricValues[]

object (MetricValue)

İstenen görünür metrik değerlerinin listesi.

Boyut Değeri

Bir boyutun değeri.

JSON gösterimi 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Alanlar
Birlik alanı one_value. one_value boyut değerinin bir türü, aşağıdakilerden sadece biri olabilir:
value

string

Boyut türü dizeyse dize olarak değer.

Metrik Değeri

Bir metriğin değeri.

JSON gösterimi 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Alanlar
Birlik alanı one_value. one_value metrik değerlerinden biri, aşağıdakilerden yalnızca biri olabilir:
value

string

Ölçüm değeri. Tür için MetricHeader'a bakın.

Dönüşüm HunisiMeta Verileri

Dönüşüm hunisi raporunun yanıt meta verileri, dönüşüm hunisi raporu hakkında ek bilgiler içerir.

JSON gösterimi 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Alanlar
samplingMetadatas[]

object (SamplingMetadata)

Dönüşüm hunisi raporu sonuçları örneklenmişse bu dönüşüm hunisi raporunda etkinliklerin yüzde kaçının kullanıldığını açıklar. Her tarih aralığı için bir samplingMetadatas doldurulur. Her samplingMetadatas, istekte belirtilen tarih aralıklarının sıralandığı bir tarih aralığına karşılık gelir.

Ancak, sonuçlar örneklenmezse bu alan tanımlanmaz.

ÖrneklemeMeta Verileri

Dönüşüm hunisi raporu sonuçları örneklenmişse bu meta veriler, bir tarih aralığı için bu dönüşüm hunisi raporunda etkinliklerin yüzde kaçının kullanıldığını açıklar. Örnekleme, daha büyük veri kümesindeki anlamlı bilgileri ortaya çıkarmak için tüm verilerin bir alt kümesini analiz etme uygulamasıdır.

JSON gösterimi 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Alanlar
samplesReadCount

string (int64 format)

Bir tarih aralığı için bu örnek raporda okunan toplam etkinlik sayısı. Bu boyut, bu dönüşüm hunisi raporunda bu mülke ait verilerin analiz edildiği alt kümenin boyutudur.
samplingSpaceSize

string (int64 format)

Bir mülkün veri aralığında bulunan ve bir tarih aralığı için bu dönüşüm hunisi raporunda analiz edilebilecek etkinliklerin toplam sayısı. Örnekleme, daha büyük veri kümesiyle ilgili anlamlı bilgileri ortaya çıkarır ve bu, daha büyük veri kümesinin boyutudur.

Bu dönüşüm hunisi raporunda kullanılan mevcut verilerin yüzdesini hesaplamak için samplesReadCount/samplingSpaceSize hesaplamasını yapın.

MülkKotası

Bu Analytics Mülkü için tüm kotaların mevcut durumu. Bir mülkün kotası tükenirse söz konusu mülke gönderilen tüm istekler Kaynak Tükenmiş hataları döndürür.

JSON gösterimi 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Alanlar
tokensPerDay

object (QuotaStatus)

Standart Analytics Mülkleri günde en fazla 200.000 jeton, Analytics 360 Mülkleri ise günde 2.000.000 jeton kullanabilir. Çoğu istek 10'dan az jeton tüketir.
tokensPerHour

object (QuotaStatus)

Standart Analytics Mülkleri,saat başına 40.000'e kadar jeton,Analytics 360 Mülkleri ise saat başına 400.000 jeton kullanabilir. Bir API isteği tek bir jeton sayısı tüketir ve bu sayı saatlik, günlük ve proje başına saatlik kotaların tamamından düşülür.
concurrentRequests

object (QuotaStatus)

Standart Analytics Mülkleri en fazla 10 eşzamanlı istek gönderebilir; Analytics 360 Mülkleri ise en fazla 50 eşzamanlı isteği kullanabilir.
serverErrorsPerProjectPerHour

object (QuotaStatus)

Standart Analytics mülkleri ve bulut proje çiftleri saatte en fazla 10 sunucu hatası içerebilir. Analytics 360 mülkleri ve bulut proje çiftlerinde ise saatte en fazla 50 sunucu hatası olabilir.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Analytics mülkleri, saat başına olası eşiklere sahip 120 adede kadar istek gönderebilir. Bir toplu istekte, istek potansiyel olarak eşikli boyutlar içeriyorsa her rapor isteği bu kota için ayrı olarak sayılır.
tokensPerProjectPerHour

object (QuotaStatus)

Analytics mülkleri, proje başına belirteçlerinin en fazla% 35'ini kullanabilir. Bu sayede standart Analytics mülkleri, proje başına en fazla 14.000 jetona, Analytics 360 mülkleri ise proje başına saatte 140.000 jetona kadar kullanılabilir. Bir API isteği tek bir jeton sayısı tüketir ve bu sayı saatlik, günlük ve proje başına saatlik kotaların tamamından düşülür.

Kota Durumu

Belirli bir kota grubunun mevcut durumu.

JSON gösterimi 
{
  "consumed": integer,
  "remaining": integer
}
Alanlar
consumed

integer

Bu istek tarafından tüketilen kota.
remaining

integer

Bu istekten sonra kota kaldı.