- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- Dönüşüm hunisi
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Segment
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- Deneyin.
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 |
İ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 ( |
Alanlar | |
---|---|
dateRanges[] |
İ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 |
İsteğe bağlı. Bu isteğin dönüşüm hunisinin yapılandırması. Bu dönüşüm hunisi yapılandırması zorunludur. |
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, |
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, Sonraki işlem yalnızca |
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 |
segments[] |
İ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 |
İ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. Ayrıca, |
dimensionFilter |
İ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 |
İ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 ( |
Alanlar | |
---|---|
funnelTable |
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 |
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 |
propertyQuota |
Bu istek dahil olmak üzere, Analytics mülkünün kota durumu. |
kind |
Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu |
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 ( |
Alanlar | |
---|---|
isOpenFunnel |
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[] |
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 ( |
Alanlar | |
---|---|
name |
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, |
isDirectlyFollowedBy |
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 |
filterExpression |
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 |
Belirtilmişse bu adım, önceki adımın tamamlanmasından sonraki bu süre içinde tamamlanmalıdır.
En fazla dokuz kesir basamağı olan ve " |
FunnelFilterExpression
Dönüşüm hunisi filtresi kombinasyonlarını ifade eder.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı expr . FunnelFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelFilterExpression, |
funnelFieldFilter |
Bir boyut veya metrik için dönüşüm hunisi filtresi. |
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 ( |
Alanlar | |
---|---|
expressions[] |
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 |
Alanlar | |
---|---|
fieldName |
Boyut adı veya metrik adı. |
Birleştirme alanı one_filter . Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerleri filtresi. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
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 ( |
Alanlar | |
---|---|
eventName |
Bu filtre, bu tek etkinlik adındaki etkinliklerle eşleşir. Etkinlik adı zorunludur. |
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 |
Alanlar | |
---|---|
Birleştirme alanı expr . FunnelParameterFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelparameterFilterExpression, |
funnelParameterFilter |
Temel dönüşüm hunisi parametresi filtresi. |
FunnelParameterFilterExpressionList
Dönüşüm hunisi parametresi filtre ifadelerinin listesi.
JSON gösterimi |
---|
{
"expressions": [
{
object ( |
Alanlar | |
---|---|
expressions[] |
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 |
Alanlar | |
---|---|
Birleştirme alanı one_parameter . Filtrelenmekte olan alan. one_parameter şunlardan yalnızca biri olabilir: |
|
eventParameterName |
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 |
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 |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerleri filtresi. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
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 ( |
Alanlar | |
---|---|
breakdownDimension |
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. |
limit |
Döküm boyutunun yanıtta döndürülecek maksimum farklı değeri. Sınır belirtilmezse |
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 ( |
Alanlar | |
---|---|
nextActionDimension |
Dönüşüm hunisi görselleştirme alt rapor yanıtına eklenen boyut sütunu. Sonraki işlem boyutu, kullanıcı
|
limit |
Döküm boyutunun yanıtta döndürülecek maksimum farklı değeri. Sınır belirtilmezse |
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 |
Alanlar | |
---|---|
name |
Bu segmentin adı. Belirtilmemişse segmentler "Segment" olarak adlandırılır. Bu ad, |
Birleştirme alanı one_segment_scope . Bir kapsam, bir kapsamda belirtilmiş. one_segment_scope şunlardan yalnızca biri olabilir: |
|
userSegment |
Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşimde bulunan kullanıcıların alt kümeleridir. |
sessionSegment |
Oturum segmentleri, sitenizde veya uygulamanızda gerçekleşen oturumların alt kümeleridir. |
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 ( |
Alanlar | |
---|---|
userInclusionCriteria |
Bu segmente hangi kullanıcıların dahil edileceğini tanımlar. İsteğe bağlı. |
exclusion |
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 ( |
Alanlar | |
---|---|
andConditionGroups[] |
Kullanıcı bu |
andSequenceGroups[] |
Kullanıcı bu |
UserSegmentConditionGroup
Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.
JSON gösterimi |
---|
{ "conditionScoping": enum ( |
Alanlar | |
---|---|
conditionScoping |
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 İsteğe bağlı. Belirtilmemişse |
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 |
Alanlar | |
---|---|
Birleştirme alanı expr . SegmentFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentFilterExpression, |
segmentFilter |
Temel segment filtresi. |
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 ( |
Alanlar | |
---|---|
expressions[] |
Segment filtresi ifadelerinin listesi |
SegmentFilter
Boyut veya metrik değerlerini filtrelemek için kullanılan bir ifade.
JSON gösterimi |
---|
{ "fieldName": string, "filterScoping": { object ( |
Alanlar | |
---|---|
fieldName |
Boyut adı veya metrik adı. |
filterScoping |
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 |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerleri filtresi. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
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 |
Bu Bu Ölçüt kapsamı |
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 ( |
Alanlar | |
---|---|
eventName |
Bu filtre, bu tek etkinlik adındaki etkinliklerle eşleşir. Etkinlik adı zorunludur. |
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 |
Alanlar | |
---|---|
Birleştirme alanı expr . SegmentParameterFilterExpression için bir filtre türü belirtin. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentParametreFiltresi İfadesi |
segmentParameterFilter |
Temel segment parametresi filtresi. |
SegmentParameterFilterExpressionList
Segment parametresi filtre ifadelerinin listesi.
JSON gösterimi |
---|
{
"expressions": [
{
object ( |
Alanlar | |
---|---|
expressions[] |
Segment parametresi filtre ifadelerinin listesi. |
SegmentParameterFilter
Bir segmentteki parametre değerlerini filtrelemek için kullanılan bir ifade.
JSON gösterimi |
---|
{ "filterScoping": { object ( |
Alanlar | |
---|---|
filterScoping |
Filtrenin kapsamını belirtir. |
Birleştirme alanı one_parameter . Filtrelenmekte olan alan. one_parameter şunlardan yalnızca biri olabilir: |
|
eventParameterName |
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 |
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 |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerleri filtresi. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
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 |
Filtreyi uygulamadan önce, belirtilen süre boyunca parametreyi biriktirir. Yalnızca ölçüt kapsamı Örneğin, 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
|
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 ( |
Alanlar | |
---|---|
sequenceScoping |
Kullanıcının diziyle eşleşmesi için kapsamdaki tüm dizi adımlarının karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmemişse |
sequenceMaximumDuration |
Tüm dizinin gerçekleşmesi gereken dönemi tanımlar; örneğin, 30 Dakika.
En fazla dokuz kesir basamağı olan ve " |
userSequenceSteps[] |
Koşul adımlarından oluşan sıralı bir dizi. Kullanıcının |
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 ( |
Alanlar | |
---|---|
isDirectlyFollowedBy |
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. |
stepScoping |
Kullanıcının diziyle eşleşmesi için kapsam belirlemede bu sıra adımının karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmemişse |
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 ( |
Alanlar | |
---|---|
userExclusionDuration |
Bir kullanıcının İsteğe bağlı. Belirtilmemişse |
userExclusionCriteria |
Bu koşulu karşılayan kullanıcılar, |
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 ( |
Alanlar | |
---|---|
sessionInclusionCriteria |
Bu segmente hangi oturumların dahil edileceğini tanımlar. İsteğe bağlı. |
exclusion |
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 ( |
Alanlar | |
---|---|
andConditionGroups[] |
Oturum, bu |
SessionSegmentConditionGroup
Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.
JSON gösterimi |
---|
{ "conditionScoping": enum ( |
Alanlar | |
---|---|
conditionScoping |
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 İsteğe bağlı. Belirtilmemişse |
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 ( |
Alanlar | |
---|---|
sessionExclusionDuration |
Bir oturumun İsteğe bağlı. Belirtilmemişse |
sessionExclusionCriteria |
Bir oturum bu koşulu karşılıyorsa oturum |
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 ( |
Alanlar | |
---|---|
eventInclusionCriteria |
Bu segmente hangi etkinliklerin dahil edileceğini tanımlar. İsteğe bağlı. |
exclusion |
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 ( |
Alanlar | |
---|---|
andConditionGroups[] |
Bu |
EventSegmentConditionGroup
Koşullar, Analytics'e segmente hangi verileri dahil edeceğini veya segmentten hangi verileri hariç tutacağını bildirir.
JSON gösterimi |
---|
{ "conditionScoping": enum ( |
Alanlar | |
---|---|
conditionScoping |
İsteğe bağlı. Belirtilmemişse |
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 ( |
Alanlar | |
---|---|
eventExclusionDuration |
İsteğe bağlı. Belirtilmemişse |
eventExclusionCriteria |
Bu koşulu karşılayan bir etkinlik, |
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 ( |
Alanlar | |
---|---|
dimensionHeaders[] |
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[] |
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[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerlerinin satırları. |
metadata |
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 ( |
Alanlar | |
---|---|
samplingMetadatas[] |
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 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 |
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 |
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 |
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 ( |
Alanlar | |
---|---|
tokensPerDay |
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 |
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 |
Standart Analytics mülkleri, en fazla 10 eşzamanlı istek gönderebilir; Analytics 360 mülkleri en fazla 50 eşzamanlı istek kullanabilir. |
serverErrorsPerProjectPerHour |
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 |
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 |
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 |
Bu istek tarafından tüketilen kota. |
remaining |
Bu istekten sonra kalan kota. |