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 ve metrikler için sütunlar içeren bir tablo şeklindedir.

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 için GA4 Dönüşüm Hunisi Explorations başlıklı makaleyi inceleyin.

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 Data API Funnel Reporting Geri Bildirimi'ni tamamlayın.

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

İsteğe bağlı. Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istekte bu özelliğin ya belirtilmemiş olması ya da grup düzeyindeki özellikle tutarlı olması gerekir.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri 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)

İsteğe bağlı. Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına dahil edilir.

funnel

object (Funnel)

İsteğe bağlı. Bu isteğin dönüşüm hunisinin yapılandırması. Bu dönüşüm hunisi yapılandırması zorunludur.

funnelBreakdown

object (FunnelBreakdown)

İsteğe bağlı. Belirtilirse 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)

İsteğe bağlı. 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ı bir sonraki işlemin benzersiz değerlerine genişletir. Örneğin, eventName boyutunda sonraki bir işlem çeşitli etkinlikler (örneğin session_start ve click) ve toplam için satırlar oluşturacaktır.

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

funnelVisualizationType

enum (FunnelVisualizationType)

İsteğe bağlı. 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)

İsteğe bağlı. Segment yapılandırmaları. Segmentler, bir mülke ait verilerin alt kümeleridir. Segmentlerin yer aldığı 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 bir segmentin adıyla tanımlandığını göreceksiniz.

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

limit

string (int64 format)

İsteğe bağlı. Döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

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

dimensionFilter

object (FilterExpression)

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

returnPropertyQuota

boolean

İsteğe bağlı. Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota bölümünde döndürülür.

Yanıt gövdesi

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

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

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ılar, tamamlanma oranı, vazgeçme ve vazgeçme oranını içeren bir rapordur.

Segment boyutu yalnızca bir segment istendiyse 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ı, segment, tarih, sonraki işlem boyutu ve etkin kullanıcıları içeren bir rapordur.

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

propertyQuota

object (PropertyQuota)

Bu istek dahil olmak üzere, Analytics mülkünün kota durumu.

kind

string

Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu kind, her zaman "analyticsData#runFunnelRapor" sabit dizesidir. JSON dosyasındaki 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

Dönüşüm hunisi

Bir dönüşüm hunisi raporu isteğinde 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 bir dönüşüm hunisinde, kullanıcılar dönüşüm hunisine herhangi bir adımda girebilir. Kapalı bir dönüşüm hunisinde, kullanıcılar dönüşüm hunisine ilk adımda girmelidir. İsteğe bağlı. Belirtilmemişse kapalı bir dönüşüm hunisi kullanılır.

steps[]

object (FunnelStep)

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

FunnelStep

Adımlar, ölçmek istediğiniz kullanıcı yolculuğunu tanımlar. Adımlar, kullanıcılarınızın dönüşüm hunisi yolculuğunun bu adımına dahil edilmek için karşılaması gereken bir veya daha fazla koşulu 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ı. Belirtilmemişse adımlar, 1 tabanlı dizine eklenmiş bir adla (ör. "0 ", "1. " vb.) belirtin. 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

True (doğru) ise bu adım doğrudan önceki adımı izlemelidir. False ise, ö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)

Belirtilmişse bu adım, önceki adımın tamamlanmasından sonraki bu 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 saniyede tamamlanabilir, ancak 5 saniye ve 1 mikrosaniyede tamamlanamaz.

withinDurationFromPriorStep isteğe bağlıdır. Belirtilmemesi durumunda adımlar herhangi bir zamana göre ayrılabilir.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

FunnelFilterExpression

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
Birleştirme alanı expr. FunnelFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir:
andGroup

object (FunnelFilterExpressionList)

andGroup öğesindeki FunnelFilterExpression, VE ilişkisine sahiptir.

orGroup

object (FunnelFilterExpressionList)

orGroup öğesindeki FunnelFilterExpression, VEYA ilişkisine sahiptir.

notExpression

object (FunnelFilterExpression)

FunnelFilterExpression, notExpression DEĞİL.

funnelFieldFilter

object (FunnelFieldFilter)

Bir boyut veya metrik için dönüşüm hunisi filtresi.

funnelEventFilter

object (FunnelEventFilter)

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

FunnelFilterExpressionList

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

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

object (FunnelFilterExpression)

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

FunnelFieldFilter

Boyut veya metrik değerlerini filtrelemek için kullanılan 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ı.

Birleştirme alanı one_filter. Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.

inListFilter

object (InListFilter)

Liste değerleri filtresi.

numericFilter

object (NumericFilter)

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

betweenFilter

object (BetweenFilter)

İki değer arasında bir filtre.

FunnelEventFilter

Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre oluşturur. Parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin 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ındaki etkinliklerle eşleşir. Etkinlik adı zorunludur.

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Belirtilmesi durumunda bu filtre, hem tek etkinlik adı hem de parametre filtresi ifadeleriyle eşleşen etkinlikleri eşleştirir.

Parametre filtresi ifadesinde yalnızca parametre filtreleri mevcuttur.

FunnelParameterFilterExpression

Parametreler üzerinde dönüşüm hunisi 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
Birleştirme alanı expr. FunnelParameterFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir:
andGroup

object (FunnelParameterFilterExpressionList)

andGroup öğesindeki FunnelparameterFilterExpression, VE ilişkisine sahiptir.

orGroup

object (FunnelParameterFilterExpressionList)

orGroup içindeki FunnelparameterFilterExpression bir VEYA ilişkisine sahip.

notExpression

object (FunnelParameterFilterExpression)

FunnelparameterFilterExpression, notExpression DEĞİL.

funnelParameterFilter

object (FunnelParameterFilter)

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

FunnelParameterFilterExpressionList

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

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

object (FunnelParameterFilterExpression)

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

FunnelParameterFilter

Dönüşüm hunisindeki parametre değerlerini filtrelemek için kullanılan 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
Birleştirme alanı one_parameter. Filtrelenmekte olan alan. one_parameter şunlardan yalnızca biri olabilir:
eventParameterName

string

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

Etkinlik parametreleri yalnızca segmentlerde ve ve yalnızca EventFilter'den gelen bir alt filtrede kullanılabilir. EventFilter'den gelen bir alt filtrede etkinlik ya da öğe parametreleri kullanılmalıdır.

itemParameterName

string

Bu filtre, belirtilen öğe parametresine göre değerlendirilecek. Öğe parametreleri, item dizisine parametreler olarak kaydedilir. Öğe parametreleri "item_name" gibi alanları içerir ve "item_category".

Öğe parametreleri yalnızca segmentlerde ve ve yalnızca EventFilter'den gelen bir alt filtrede kullanılabilir. EventFilter'den gelen bir alt filtrede etkinlik ya da öğ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.

Birleştirme alanı one_filter. Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.

inListFilter

object (InListFilter)

Liste değerleri filtresi.

numericFilter

object (NumericFilter)

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

betweenFilter

object (BetweenFilter)

İki değer arasında bir filtre.

FunnelBreakdown

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, her bir dönüşüm hunisi adımının dökümünü alır. funnelBreakdown belirtilirse geçerli bir breakdownDimension gerekir.

limit

string (int64 format)

Döküm boyutunun yanıtta döndürülecek maksimum farklı değeri. Sınır belirtilmezse 5 limit kullanılır. Sınır sıfırdan büyük olmalı ve 15'ten fazla olmamalıdır.

FunnelNextAction

Sonraki işlemlerde, boyut değeri, kullanıcı bir adımı tamamladıktan sonra, ancak aynı kullanıcı bir sonraki adıma geçmeden önce belirtilir. Örneğin nextActionDimension değeri eventName ise i. dönüşüm hunisi adımı satırındaki nextActionDimension, kullanıcıyı i. dönüşüm hunisi adımına geçmeye uygun hale getiren etkinlikten sonra, ancak kullanıcı i+1. dönüşüm hunisi adımına ulaşmadan önceki 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. Sonraki işlem boyutu, kullanıcı i. dönüşüm hunisi adımına ulaştıktan sonra bu boyutun sonraki boyut değerini döndürür.

nextActionDimension şu anda yalnızca eventName boyutunu ve pageTitle ile pagePath gibi çoğu Sayfa / Ekran boyutunu desteklemektedir. nextActionDimension bir boyut ifadesi olamaz.

limit

string (int64 format)

Döküm boyutunun yanıtta döndürülecek maksimum farklı değeri. Sınır belirtilmezse 5 limit kullanılır. Sınır sıfırdan büyük olmalı ve 5'ten fazla olmamalıdır.

FunnelVisualizationType

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ı) bir dönüşüm hunisidir. Yanıttaki dönüşüm hunisi görselleştirme alt raporu tarih içermez.
TRENDED_FUNNEL Eğilimleri gösteren (ç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 başlıklı makaleyi inceleyin.

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ı. Belirtilmemişse 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ına göre (örneğin "1. Segment", "2. Segment" vb.).

Birleştirme alanı one_segment_scope. Bir kapsam, bir kapsamda belirtilmiş. one_segment_scope şunlardan yalnızca biri olabilir:
userSegment

object (UserSegment)

Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşimde bulunan 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.

UserSegment

Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşimde bulunan kullanıcıların alt kümeleridir. Örneğin, daha önce ürün satın almış kullanıcılar; Alışveriş sepetlerine ürün ekleyen, ancak satın alma işlemini tamamlamayan 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ı.

UserSegmentCriteria

Bir kullanıcının etkinlikleri ölçütlerdeki koşulları karşılıyorsa kullanıcı bir ölçütü eşleştirir.

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

object (UserSegmentConditionGroup)

Kullanıcı bu andConditionGroups ve andSequenceGroups öğelerinin her biriyle eşleşirse bu ölçütlerle eşleşir. andSequenceGroups belirtilmişse andConditionGroups boş olabilir.

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Kullanıcı bu andSequenceGroups ve andConditionGroups öğelerinin her biriyle eşleşirse bu ölçütlerle eşleşir. andConditionGroups belirtilmişse andSequenceGroups boş olabilir.

UserSegmentConditionGroup

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şmediklerine göre segmente dahil edilir veya segmentten hariç tutulur. Bu kapsam, koşul grubunun eşleşip eşleşmediği belirlenmeden önce segmentFilterExpression öğesinin kaç etkinlik üzerinde değerlendirileceğini tanımlar. Örneğin, conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION ise ifade bir oturumdaki tüm etkinliklerde değerlendirilir ve ardından koşul grubunun bu kullanıcı için eşleşip eşleşmediği belirlenir. Örneğin, conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT ise ifade tek bir etkinlik üzerinde değerlendirilir ve ardından koşul grubunun bu kullanıcı için eşleşip eşleşmediği belirlenir.

İsteğe bağlı. Belirtilmemişse conditionScoping = ACROSS_ALL_SESSIONS kullanılır.

segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediklerine göre segmente dahil edilir veya segmentten hariç tutulur. İfadeler boyut, metrikler ve/veya parametrelerdeki ölçütleri ifade eder.

UserCriteriaScoping

Kapsam oluşturma, bir 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 Belirtilmemiş ölçüt kapsamı. Belirtme.
USER_CRITERIA_WITHIN_SAME_EVENT Bir etkinlikte ölçütler karşılanırsa kullanıcı ölçütlerle eşleşir.
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.

SegmentFilterExpression

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
Birleştirme alanı expr. SegmentFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir:
andGroup

object (SegmentFilterExpressionList)

andGroup öğesindeki SegmentFilterExpression, bir VE ilişkisine sahip.

orGroup

object (SegmentFilterExpressionList)

orGroup içindeki SegmentFilterExpression'da VEYA ilişkisi var.

notExpression

object (SegmentFilterExpression)

SegmentFilterExpression, notExpression DEĞİL.

segmentFilter

object (SegmentFilter)

Temel segment filtresi.

segmentEventFilter

object (SegmentEventFilter)

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

SegmentFilterExpressionList

Segment filtresi ifadelerinin listesi.

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

object (SegmentFilterExpression)

Segment filtresi ifadelerinin listesi

SegmentFilter

Boyut veya metrik değerlerini filtrelemek için kullanılan 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.

Birleştirme alanı one_filter. Filter için bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.

inListFilter

object (InListFilter)

Liste değerleri filtresi.

numericFilter

object (NumericFilter)

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

betweenFilter

object (BetweenFilter)

İki değer arasında bir filtre.

SegmentFilterScoping

Kapsamlar, boyutların & Birden fazla etkinliğin metrikleri, segment filtresi değerlendirirken dikkate alınmalıdır.

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

boolean

atAnyPointInTime doğru değerine ayarlanırsa bu filtre, isteğin tarih aralığındaki herhangi bir etkinlik için doğru değerlendirmesi yaparsa tüm etkinlikler için "doğru" olarak değerlendirilir.

Bu atAnyPointInTime parametresi, rapordaki etkinliklerin tarih aralığını uzatmaz. atAnyPointInTime Doğru ise bu filtre değerlendirilirken yalnızca raporun tarih aralığındaki etkinlikler dikkate alınır.

Bu atAnyPointInTime, yalnızca ölçütün kapsamı ACROSS_ALL_SESSIONS ise ve dizilerde belirtilemiyorsa belirtilebilir.

Ölçüt kapsamı ACROSS_ALL_SESSIONS ise atAnyPointInTime = belirtilmediyse yanlış kullanılır.

SegmentEventFilter

Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre oluşturur. Parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin 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ındaki etkinliklerle eşleşir. Etkinlik adı zorunludur.

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Belirtilmesi durumunda bu filtre, hem tek etkinlik adı hem de parametre filtresi ifadeleriyle eşleşen etkinlikleri eşleştirir.

Parametre filtresi ifadesinde yalnızca parametre filtreleri mevcuttur.

SegmentParameterFilterExpression

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
Birleştirme alanı expr. SegmentParameterFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir:
andGroup

object (SegmentParameterFilterExpressionList)

andGroup içindeki SegmentParametersFilterExpression'da VE ilişkisi var.

orGroup

object (SegmentParameterFilterExpressionList)

orGroup öğesindeki SegmentParametersFilterExpression'da bir VEYA ilişkisi var.

notExpression

object (SegmentParameterFilterExpression)

SegmentParametreFiltresi İfadesi notExpression DEĞİL.

segmentParameterFilter

object (SegmentParameterFilter)

Temel segment parametresi filtresi.

SegmentParameterFilterExpressionList

Segment parametresi filtre ifadelerinin listesi.

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

object (SegmentParameterFilterExpression)

Segment parametresi filtre ifadelerinin listesi.

SegmentParameterFilter

Bir segmentteki parametre değerlerini filtrelemek için kullanılan 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.

Birleştirme alanı one_parameter. Filtrelenmekte olan alan. one_parameter şunlardan yalnızca biri olabilir:
eventParameterName

string

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

Etkinlik parametreleri yalnızca segmentlerde ve ve yalnızca EventFilter'den gelen bir alt filtrede kullanılabilir. EventFilter'den gelen bir alt filtrede etkinlik ya da öğe parametreleri kullanılmalıdır.

itemParameterName

string

Bu filtre, belirtilen öğe parametresine göre değerlendirilecek. Öğe parametreleri, item dizisine parametreler olarak kaydedilir. Öğe parametreleri "item_name" gibi alanları içerir ve "item_category".

Öğe parametreleri yalnızca segmentlerde ve ve yalnızca EventFilter'den gelen bir alt filtrede kullanılabilir. EventFilter'den gelen bir alt filtrede etkinlik ya da öğ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.

Birleştirme alanı one_filter. Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.

inListFilter

object (InListFilter)

Liste değerleri filtresi.

numericFilter

object (NumericFilter)

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

betweenFilter

object (BetweenFilter)

İki değer arasında bir filtre.

SegmentParameterFilterScoping

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

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

string (int64 format)

Filtreyi uygulamadan önce, belirtilen süre boyunca parametreyi biriktirir. Yalnızca ölçüt kapsamı ACROSS_ALL_SESSIONS veya WITHIN_SAME_SESSION olduğunda desteklenir. Yalnızca parametre event_count ise desteklenir.

Örneğin, inAnyNDayPeriod değeri 3 ise, eventName "purchase", etkinlik parametresi "event_count" ve Filtrenin ölçütü 5'ten büyükse bu filtre, raporun tarih aralığındaki her 3 günlük dönem boyunca satın alma etkinliklerinin etkinlik sayısını toplar. Bir kullanıcı, art arda 3 günlük herhangi bir dönemde satın alma etkinliği sayısı 5'i aşarsa bu Filtrenin bu segmente dahil edilme ölçütlerini geçer. Örneğin, 01.11.2021 ile 03.11.2021, 02.11.2021, 04.11.2021, 03.11.2021-05.11.2021 vb. dönemler dikkate alınır.

Tam N günlük aralığın, tarih aralığının başlangıcına yakın olması amacıyla genişletilmez. Örneğin, bir raporun 01.11.2021 ile 10.11.2021 ile 2021-11.2021 tarihleri arasında olması ve inAnyNDayPeriod = 3 tarih aralığına ait olması durumunda, raporun tarih aralığı dışındaki hiçbir etkinlik verisi okunmayacağından ilk iki günlük dönem etkili bir şekilde kısaltılır. Örneğin, ilk dört dönem etkili olarak şu şekilde olacaktır: 01.11.2021-01.11.2021, 01.11.2021-02.11.2021-03.11.2021-03.11.2021-2041.11.2021-202111.11.2021.

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

UserSegmentSequenceGroup

Kullanıcının segmentin ü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şmesi için kapsamdaki tüm dizi adımlarının karşılanması gerekir. Örneğin, sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION ise 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ı. Belirtilmemişse conditionScoping = ACROSS_ALL_SESSIONS kullanılır.

sequenceMaximumDuration

string (Duration format)

Tüm dizinin gerçekleşmesi gereken dönemi tanımlar; örneğin, 30 Dakika. sequenceMaximumDuration, mikrosaniye ayrıntı düzeyinde uç noktayı içerir. Örneğin, maksimum 5 saniye olan bir dizi 4,9 veya 5,0 saniyede tamamlanabilir, ancak 5 saniye ve 1 mikrosaniyede tamamlanamaz.

sequenceMaximumDuration isteğe bağlıdır. Belirtilmemişse diziler herhangi bir zamanda tamamlanabilir.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

userSequenceSteps[]

object (UserSequenceStep)

Koşul adımlarından oluşan sıralı bir dizi. Kullanıcının UserSegmentSequenceGroup ile eşleşmesi için kullanıcının etkinliklerinin her bir adımı tamamlaması gerekir.

UserSequenceStep

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

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

boolean

True (doğru) ise bu adımı karşılayan etkinlik, son adımı karşılayan etkinlikten sonraki etkinlik olmalıdır. False (yanlış) ise bu adım dolaylı olarak önceki adımın ardından gelir; Örneğin, önceki adımla bu adım arasında etkinlikler olabilir. isDirectlyFollowedBy, ilk adım için false (yanlış) değerine ayarlanmalıdır.

stepScoping

enum (UserCriteriaScoping)

Kullanıcının diziyle eşleşmesi için kapsam belirlemede bu sıra adımının karşılanması gerekir. Örneğin, sequenceScoping = WITHIN_SAME_SESSION ise kullanıcının diziyle eşleşmesi için bu dizi adımlarının tek bir oturumda tamamlanması gerekir. stepScoping = ACROSS_ALL_SESSIONS özelliğine yalnızca sequenceScoping = ACROSS_ALL_SESSIONS varsa izin verilir.

İsteğe bağlı. Belirtilmemişse stepScoping, sequenceScoping ile aynı UserCriteriaScoping öğesini kullanır.

segmentFilterExpression

object (SegmentFilterExpression)

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

UserSegmentExclusion

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

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

enum (UserExclusionDuration)

Bir kullanıcının userExclusionCriteria ile eşleşmesi durumunda hariç tutma işleminin ne kadar süreceğini belirtir.

İsteğe bağlı. Belirtilmemişse USER_EXCLUSION_TEMPORARY/userExclusionDuration kullanılır.

userExclusionCriteria

object (UserSegmentCriteria)

Bu koşulu karşılayan kullanıcılar, userExclusionDuration segmentinin üyeliğinden hariç tutulur.

UserExclusionDuration

Kullanıcının userExclusionCriteria ile eşleşmesi durumunda hariç tutma işleminin ne kadar süreceğine ilişkin seçenekleri belirtir.

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ı segmentten geçici olarak hariç tutun.
USER_EXCLUSION_PERMANENT userExclusionCriteria koşulunu karşılayan kullanıcılar segmentten kalıcı olarak hariç tutulur.

SessionSegment

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

SessionSegmentCriteria

Bir oturumun etkinlikleri ölçütlerdeki koşulları karşılıyorsa oturum bir ölçütle eşleşir.

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

object (SessionSegmentConditionGroup)

Oturum, bu andConditionGroups öğelerinin her biriyle eşleşirse bir oturum bu kriterlerle eşleşir.

SessionSegmentConditionGroup

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şmediklerine göre segmente dahil edilir veya segmentten hariç tutulur. Bu kapsam, koşul grubunun eşleşip eşleşmediği belirlenmeden önce segmentFilterExpression öğesinin kaç etkinlik üzerinde değerlendirileceğini tanımlar. Örneğin, conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION ise ifade bir oturumdaki tüm etkinliklerde değerlendirilir ve ardından koşul grubunun bu oturum için eşleşip eşleşmediği belirlenir. Örneğin, conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT ise ifade tek bir etkinlik üzerinde değerlendirilir ve ardından koşul grubunun bu oturum için eşleşip eşleşmediği belirlenir.

İsteğe bağlı. Belirtilmemişse WITHIN_SAME_SESSION öğesinin conditionScoping değeri kullanılır.

segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediklerine göre segmente dahil edilir veya segmentten hariç tutulur. İfadeler boyut, metrikler ve/veya parametrelerdeki ölçütleri ifade eder.

SessionCriteriaScoping

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

Sıralamalar
SESSION_CRITERIA_SCOPING_UNSPECIFIED Belirtilmemiş ölçüt kapsamı. Belirtme.
SESSION_CRITERIA_WITHIN_SAME_EVENT Bir etkinlikte ölçütler karşılanırsa oturum, ölçütlerle eşleşir.
SESSION_CRITERIA_WITHIN_SAME_SESSION Bir oturumda ölçütler karşılanırsa oturum da kriterleri karşılar.

SessionSegmentExclusion

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

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

enum (SessionExclusionDuration)

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

İsteğe bağlı. Belirtilmemişse SESSION_EXCLUSION_TEMPORARY sessionExclusionDuration kullanılır.

sessionExclusionCriteria

object (SessionSegmentCriteria)

Bir oturum bu koşulu karşılıyorsa oturum sessionExclusionDuration segmentinin üyeliğinden hariç tutulur.

SessionExclusionDuration

Bir oturumun sessionExclusionCriteria ile eşleşmesi durumunda hariç tutma işleminin ne kadar süreceğine ilişkin seçenekleri belirtir.

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

EventSegment

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 etkinliklerinin sayısı.

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

EventSegmentCriteria

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

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

object (EventSegmentConditionGroup)

Bu andConditionGroups öğelerinin her biriyle eşleşen bir etkinlik bu ölçütlerle eşleşir.

EventSegmentConditionGroup

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ı. Belirtilmemişse EVENT_CRITERIA_WITHIN_SAME_EVENT conditionScoping kullanılır.

segmentFilterExpression

object (SegmentFilterExpression)

Veriler, bu ifadeyle eşleşip eşleşmediklerine göre segmente dahil edilir veya segmentten hariç tutulur. İfadeler boyut, metrikler ve/veya parametrelerdeki ölçütleri ifade eder.

EventCriteriaScoping

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

Sıralamalar
EVENT_CRITERIA_SCOPING_UNSPECIFIED Belirtilmemiş ölçüt kapsamı. Belirtme.
EVENT_CRITERIA_WITHIN_SAME_EVENT Bir etkinlikte ölçütler karşılanırsa etkinlik de ölçütlerle eşleşir.

EventSegmentExclusion

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ı. Belirtilmemişse EVENT_EXCLUSION_PERMANENT öğesinin eventExclusionDuration değeri kullanılır.

eventExclusionCriteria

object (EventSegmentCriteria)

Bu koşulu karşılayan bir etkinlik, eventExclusionDuration segmentinin üyeliğinden hariç tutulur.

EventExclusionDuration

Bir etkinliğin eventExclusionCriteria ile eşleşmesi durumunda hariç tutma işleminin ne kadar süreceğine ilişkin seçenekleri belirtir.

Sıralamalar
EVENT_EXCLUSION_DURATION_UNSPECIFIED Belirtilmemiş hariç tutma süresi. Belirtme.
EVENT_EXCLUSION_PERMANENT Etkinlik, eventExclusionCriteria koşulunu karşılıyorsa segmentten kalıcı olarak hariç tutulur.

FunnelSubReport

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

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 mevcut olabilir.

metricHeaders[]

object (MetricHeader)

Metrik sütunlarını açıklar. Dönüşüm hunisi raporları, alt rapor yanıtlarında her zaman etkin kullanıcıları içerir. Dönüşüm hunisi tablosu tamamlanma oranı, vazgeçme oranı ve vazgeçme oranı gibi ek metrikler içerir.

rows[]

object (Row)

Rapordaki boyut değeri kombinasyonları ve metrik değerlerinin satırları.

metadata

object (FunnelResponseMetadata)

Dönüşüm hunisi raporunun meta verileri.

FunnelResponseMetadata

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 belirtildiği bir tarih aralığına karşılık gelir.

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

SamplingMetadata

Dönüşüm hunisi raporu sonuçları örneklenmişse bu meta veriler, bir tarih aralığı için bu dönüşüm hunisi raporunda kullanılan etkinliklerin yüzdesini 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 örneklenmiş raporda okunan etkinliklerin toplam sayısı. Bu boyut, bu mülke ait ve bu dönüşüm hunisi raporunda analiz edilen verilerin alt kümesinin boyutudur.

samplingSpaceSize

string (int64 format)

Bu mülkün verilerinde bulunan ve belirli bir tarih aralığı için bu dönüşüm hunisi raporunda analiz edilmiş olabilecek toplam etkinlik sayısı. Örnekleme, daha büyük veri kümesiyle ilgili anlamlı bilgileri ortaya çıkarır. 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.

PropertyQuota

Bu Analytics Mülkü için tüm kotaların mevcut durumu. Bir mülk için herhangi bir kota tükenirse bu mülke yapılan tüm istekler "Kaynak tükendi" hatalarını 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 200.000'e kadar jeton kullanabilir; Analytics 360 Mülkleri günde 2.000.000 jeton kullanabilir. Çoğu istek 10'dan az jeton tüketir.

tokensPerHour

object (QuotaStatus)

Standart Analytics Mülkleri saatte 40.000'e kadar jeton kullanabilir; Analytics 360 Mülkleri saatte 400.000 jeton kullanabilir. Bir API isteği tek sayıda jeton kullanır ve bu sayı tüm saatlik, günlük ve proje başına saatlik kotalardan düşülür.

concurrentRequests

object (QuotaStatus)

Standart Analytics mülkleri, en fazla 10 eşzamanlı istek gönderebilir; Analytics 360 mülkleri en fazla 50 eşzamanlı istek kullanabilir.

serverErrorsPerProjectPerHour

object (QuotaStatus)

Standart Analytics Mülkleri ve bulut projesi çiftlerinde saatte en fazla 10 sunucu hatası olabilir; Analytics 360 mülkleri ve bulut projesi çiftlerinde saatte en fazla 50 sunucu hatası olabilir.

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Analytics Mülkleri, eşikli olabilecek boyutlarla saatte en fazla 120 istek gönderebilir. Toplu istekte, istek eşikli olabilecek boyutlar içeriyorsa her rapor isteği bu kota için ayrı ayrı sayılır.

tokensPerProjectPerHour

object (QuotaStatus)

Analytics Mülkleri, proje başına jetonlarının saatte% 35'e kadarını kullanabilir. Bu, standart Analytics mülklerinin proje başına saatte 14.000 jeton, Analytics 360 mülklerinin ise proje başına saatte 140.000 jeton kullanabileceği anlamına gelir. Bir API isteği tek sayıda jeton kullanır ve bu sayı tüm saatlik, günlük ve proje başına saatlik kotalardan düşülür.

QuotaStatus

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 kalan kota.