- HTTP isteği
- Yol parametreleri
- İstek metni
- 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
- 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ı olan 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 keşifleri 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 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 |
İsteğe bağlı. Etkinlikleri izlenen bir Google Analytics mülk kimliği. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi için Mülk kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istekte bu özellik belirtilmemiş olmalı veya toplu düzeydeki özellik ile tutarlı olmalıdır. Örnek: properties/1234 |
İstek metni
İstek içeriği aşağıdaki yapıyla birlikte 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ığı indeksi içerir. İki tarih aralığı çakışıyorsa çakışan günlerin 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ı gereklidir. |
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 dönüşüm hunisi adımını döküm boyutunun benzersiz değerlerine göre 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 bir dönüşüm hunisi adımını 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ı. Segmentlerin yapılandırmaları. Segmentler, bir mülkün verilerinin alt kümeleridir. Segment içeren 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. Segmentler 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ı. Belirtilmemişse 10.000 satır döndürülür. API, kaç tane isterseniz isteyin istek başına en fazla 250.000 satır döndürür. API, |
dimensionFilter |
İsteğe bağlı. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Rapor Oluşturma: Boyut Filtreleri başlıklı makaledeki örneklere bakın. Metrikler bu filtrede kullanılamaz. |
returnPropertyQuota |
İsteğe bağlı. Bu Analytics mülkünün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini değiştirir. Kota, PropertyQuota içinde döndürülür. |
Yanıt metni
Dönüşüm hunisi raporu yanıtı iki alt rapor içerir. İki alt rapor, boyut ve metriklerin farklı kombinasyonlarından oluşur.
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, ayrıntı boyutu, etkin kullanıcı sayısı, tamamlama oranı, bırakma sayısı ve bırakma oranını içeren bir rapordur. Segment boyutu, yalnızca bir segment istenmişse bu yanıtta bulunur. Döküm boyutu, yalnızca istenmişse 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 istenmişse bu yanıtta bulunur. Tarih boyutu, yalnızca |
propertyQuota |
Bu Analytics mülkünün, bu isteği de içeren 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.readonlyhttps://www.googleapis.com/auth/analytics
Dönüşüm hunisi
Dönüşüm hunisi raporu isteğinde dönüşüm hunisini yapılandırır. Dönüşüm hunisi, kullanıcılar bir dizi adımdan geçerken rapor oluşturur.
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 girebilirken kapalı bir dönüşüm hunisinde kullanıcılar dönüşüm hunisine ilk adımda girmelidir. İsteğe bağlı. Belirtilmezse kapalı 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ğundaki bu adıma dahil olmak için karşılaması gereken bir veya daha fazla koşul içerir.
| JSON gösterimi |
|---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
| Alanlar | |
|---|---|
name |
Bu adımın ayırt edici adı. Belirtilmediği takdirde adımlar 1 tabanlı dizine alınmış bir adla adlandırılır (örneğin, "0. ", "1. ", vb.). Bu ad, |
isDirectlyFollowedBy |
Doğruysa bu adım, önceki adımı doğrudan izlemelidir. Yanlışsa önceki adım ile bu adım arasında etkinlikler olabilir. Belirtilmezse |
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 kesirli basamak içeren ve " |
FunnelFilterExpression
Dönüşüm hunisi filtrelerinin kombinasyonlarını ifade eder.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
expr birleşik alanı. FunnelFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden 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ına sahip etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtresi ifadesi belirtilirse bu etkinlik filtresiyle yalnızca hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin alt kümesi 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ı. |
one_filter birleşik alanı. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste içi değerler için filtre. |
numericFilter |
Sayısal veya tarih değerleri için filtre. |
betweenFilter |
İki değer arasında filtreleme. |
FunnelEventFilter
Tek bir etkinlik adına sahip etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtresi ifadesi belirtilirse bu etkinlik filtresiyle yalnızca hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin alt kümesi eşleşir.
| JSON gösterimi |
|---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
| Alanlar | |
|---|---|
eventName |
Bu filtre, bu tek etkinlik adına sahip etkinliklerle eşleşir. Etkinlik adı gereklidir. |
funnelParameterFilterExpression |
Belirtilirse bu filtre, hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerle eşleşir. Parametre filtresi ifadesinde yalnızca parametre filtreleri kullanılabilir. |
FunnelParameterFilterExpression
Parametrelerdeki dönüşüm hunisi filtrelerinin kombinasyonlarını ifade eder.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
expr birleşik alanı. FunnelParameterFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelParameterFilterExpression, |
funnelParameterFilter |
Temel bir dönüşüm hunisi parametre filtresi. |
FunnelParameterFilterExpressionList
Dönüşüm hunisi parametre filtre ifadelerinin listesi.
| JSON gösterimi |
|---|
{
"expressions": [
{
object ( |
| Alanlar | |
|---|---|
expressions[] |
Dönüşüm hunisi parametre filtre ifadelerinin listesi. |
FunnelParameterFilter
Bir dönüşüm hunisindeki parametre değerlerini filtrelemek için kullanılan ifade.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
one_parameter birleşik alanı. Filtrelenen alan. one_parameter aşağıdakilerden yalnızca biri olabilir: |
|
eventParameterName |
Bu filtre, belirtilen etkinlik parametresinde değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri arasında "firebase_screen" ve "currency" gibi alanlar bulunur. Etkinlik parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'dan gelen alt filtrede kullanılabilir. Bir EventFilter'dan gelen alt filtrede etkinlik veya öğe parametreleri kullanılmalıdır. |
itemParameterName |
Bu filtre, belirtilen öğe parametresine göre değerlendirilir. Öğe parametreleri, öğe dizisindeki parametreler olarak kaydedilir. Öğe parametreleri, "item_name" ve "item_category" gibi alanları içerir. Öğe parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'dan gelen alt filtrede kullanılabilir. Bir EventFilter'dan gelen alt filtrede 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. |
one_filter birleşik alanı. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste içi değerler için filtre. |
numericFilter |
Sayısal veya tarih değerleri için filtre. |
betweenFilter |
İki değer arasında filtreleme. |
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ı döküme ayırır. |
limit |
Yanıt olarak döndürülecek döküm boyutu için maksimum farklı değer sayısı. Sınır belirtilmezse |
FunnelNextAction
Sonraki işlemler, kullanıcının bir adımı tamamlamasından sonra ancak aynı kullanıcının bir sonraki adımı tamamlamasından önce bir 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 uygun hale getiren etkinlikten sonraki 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 boyut sütunu eklendi. Sonraki işlem boyutu, kullanıcı
|
limit |
Yanıt olarak döndürülecek döküm boyutu için maksimum farklı değer sayısı. 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 |
Belirtilmemiş tür. |
STANDARD_FUNNEL |
Standart (basamaklı) dönüşüm hunisi. Yanıtın dönüşüm hunisi görselleştirme alt raporunda tarih yer almaz. |
TRENDED_FUNNEL |
Trendleri gösteren (çizgi grafik) dönüşüm hunisi. Yanıtın 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 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, |
one_segment_scope birleşik alanı. Bir segment bir kapsamda belirtilir. one_segment_scope aşağıdakilerden yalnızca biri olabilir: |
|
userSegment |
Kullanıcı segmentleri, siteniz 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 satın alma işlemi gerçekleştirmiş kullanıcılar, alışveriş sepetine ürün eklemiş ancak satın alma işlemini tamamlamamış 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ç tutulduğunu tanımlar. İsteğe bağlı. |
UserSegmentCriteria
Kullanıcının etkinlikleri, ölçütlerdeki koşulları karşılıyorsa kullanıcı bir ölçütle eşleşir.
| 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ş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 İsteğe bağlı. Belirtilmezse |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmemesine bağlı olarak segmente dahil edilir veya hariç tutulur. İfadeler, boyut, metrik ve/veya parametrelerle ilgili ölçütleri ifade eder. |
UserCriteriaScoping
Kapsam, bir kullanıcının ölçütleri karşılayıp karşılamadığını değerlendirirken hangi etkinliklerin dikkate alınacağını belirtir.
| Sıralamalar | |
|---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Belirtilmemiş ölçüt kapsamı. Belirtmeyin. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Ölçüt tek bir etkinlikte karşılanırsa kullanıcı ölçütle eşleşir. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Ölçüt bir oturum içinde karşılanırsa kullanıcı ölçütle eşleşir. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Ölçüt, kullanıcıyla ilgili herhangi bir etkinlik tarafından karşılanırsa kullanıcı ölçütle eşleşir. |
SegmentFilterExpression
Segment filtrelerinin kombinasyonlarını ifade eder.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
expr birleşik alanı. SegmentFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentFilterExpression, |
segmentFilter |
Temel bir segment filtresi. |
segmentEventFilter |
Tek bir etkinlik adına sahip etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtresi ifadesi belirtilirse bu etkinlik filtresiyle yalnızca hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin alt kümesi eşleşir. |
SegmentFilterExpressionList
Segment filtresi ifadelerinin listesi.
| JSON gösterimi |
|---|
{
"expressions": [
{
object ( |
| Alanlar | |
|---|---|
expressions[] |
Segment filtre 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. |
one_filter birleşik alanı. Filter için bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste içi değerler için filtre. |
numericFilter |
Sayısal veya tarih değerleri için filtre. |
betweenFilter |
İki değer arasında filtreleme. |
SegmentFilterScoping
Kapsamlar, bir segment filtresi değerlendirilirken birden fazla etkinliğin boyut ve metriklerinin nasıl dikkate alınacağını belirtir.
| JSON gösterimi |
|---|
{ "atAnyPointInTime": boolean } |
| Alanlar | |
|---|---|
atAnyPointInTime |
Bu Bu Ölçüt kapsamı |
SegmentEventFilter
Tek bir etkinlik adına sahip etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtresi ifadesi belirtilirse bu etkinlik filtresiyle yalnızca hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerin alt kümesi eşleşir.
| JSON gösterimi |
|---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
| Alanlar | |
|---|---|
eventName |
Bu filtre, bu tek etkinlik adına sahip etkinliklerle eşleşir. Etkinlik adı gereklidir. |
segmentParameterFilterExpression |
Belirtilirse bu filtre, hem tek etkinlik adıyla hem de parametre filtresi ifadeleriyle eşleşen etkinliklerle eşleşir. Parametre filtresi ifadesinde yalnızca parametre filtreleri kullanılabilir. |
SegmentParameterFilterExpression
Parametrelerdeki segment filtresi kombinasyonlarını ifade eder.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
expr birleşik alanı. SegmentParameterFilterExpression için bir filtre türü belirtin. expr aşağıdakilerden yalnızca biri olabilir: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentParameterFilterExpression, |
segmentParameterFilter |
Temel bir segment parametre 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 ifade.
| JSON gösterimi |
|---|
{ "filterScoping": { object ( |
| Alanlar | |
|---|---|
filterScoping |
Filtrenin kapsamını belirtir. |
one_parameter birleşik alanı. Filtrelenen alan. one_parameter aşağıdakilerden yalnızca biri olabilir: |
|
eventParameterName |
Bu filtre, belirtilen etkinlik parametresinde değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri arasında "firebase_screen" ve "currency" gibi alanlar bulunur. Etkinlik parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'dan gelen alt filtrede kullanılabilir. Bir EventFilter'dan gelen alt filtrede etkinlik veya öğe parametreleri kullanılmalıdır. |
itemParameterName |
Bu filtre, belirtilen öğe parametresine göre değerlendirilir. Öğe parametreleri, öğe dizisindeki parametreler olarak kaydedilir. Öğe parametreleri, "item_name" ve "item_category" gibi alanları içerir. Öğe parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde kullanılabilir ve yalnızca bir EventFilter'dan gelen alt filtrede kullanılabilir. Bir EventFilter'dan gelen alt filtrede 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. |
one_filter birleşik alanı. Bir filtre türü belirtin. one_filter aşağıdakilerden yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste içi değerler için filtre. |
numericFilter |
Sayısal veya tarih değerleri için filtre. |
betweenFilter |
İki değer arasında filtreleme. |
SegmentParameterFilterScoping
Kapsamlar, bir segment parametre filtresi değerlendirilirken birden fazla etkinliğin nasıl dikkate alınması gerektiğini belirtir.
| JSON gösterimi |
|---|
{ "inAnyNDayPeriod": string } |
| Alanlar | |
|---|---|
inAnyNDayPeriod |
Filtreyi uygulamadan önce parametreyi belirtilen gün sayısı boyunca biriktirir. Yalnızca ölçüt kapsamı Örneğin, Tarih aralığının başlangıcına yakın bir yerde tam N günlük bir pencere oluşturmak için tarih aralığı uzatılmaz. Örneğin, bir rapor 2021-11-01 ile 2021-11-10 arasındaki döneme aitse 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 sırayla eşleşmesi için kapsamdaki tüm sıra adımlarının karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmezse |
sequenceMaximumDuration |
Tüm adım sırasının tamamlanması için gereken süreyi (ör. 30 dakika) tanımlar.
En fazla dokuz kesirli basamak içeren ve " |
userSequenceSteps[] |
Sıralı bir koşul adımları dizisi. Bir kullanıcının |
UserSequenceStep
Bu kullanıcının sırayla eşleşmesi için belirtilen adım sırasıyla gerçekleşmesi gereken bir koşul.
| JSON gösterimi |
|---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
| Alanlar | |
|---|---|
isDirectlyFollowedBy |
Doğruysa bu adımı karşılayan etkinlik, son adımı karşılayan etkinlikten hemen sonraki etkinlik olmalıdır. Yanlışsa bu adım, önceki adımı dolaylı olarak takip eder. Örneğin, önceki adım ile bu adım arasında etkinlikler olabilir. İlk adımda |
stepScoping |
Kullanıcının sırayla eşleşmesi için bu sıra adımının kapsamda karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmezse |
segmentFilterExpression |
Etkinlikleri bu ifadeyle eşleşen kullanıcılar, bu sıra adımıyla eşleşir. İfadeler, boyut, metrik ve/veya parametrelerle ilgili ölçütleri ifade eder. |
UserSegmentExclusion
Bu segmentte hangi kullanıcıların hariç tutulduğunu belirtir.
| JSON gösterimi |
|---|
{ "userExclusionDuration": enum ( |
| Alanlar | |
|---|---|
userExclusionDuration |
Bir kullanıcı İsteğe bağlı. Belirtilmezse |
userExclusionCriteria |
Bu koşulu karşılayan kullanıcılar, |
UserExclusionDuration
Bir kullanıcı userExclusionCriteria ile eşleşirse hariç tutmanın ne kadar süreceğiyle ilgili seçenekleri listeler.
| Sıralamalar | |
|---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
USER_EXCLUSION_TEMPORARY |
Kullanıcıların userExclusionCriteria koşulunu karşıladığı dönemlerde kullanıcıları segmentten geçici olarak hariç tutun. |
USER_EXCLUSION_PERMANENT |
Kullanıcı userExclusionCriteria koşulunu karşılarsa kullanıcıyı segmentten kalıcı olarak hariç tutun. |
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, ölçütle eşleşir.
| JSON gösterimi |
|---|
{
"andConditionGroups": [
{
object ( |
| Alanlar | |
|---|---|
andConditionGroups[] |
Bir 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ş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 İsteğe bağlı. Belirtilmezse |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmemesine bağlı olarak segmente dahil edilir veya hariç tutulur. İfadeler, boyut, metrik ve/veya parametrelerle ilgili ölçütleri ifade eder. |
SessionCriteriaScoping
Kapsam, bir oturumun ölçütleri karşılayıp karşılamadığını değerlendirirken hangi etkinliklerin dikkate alınacağını belirtir.
| Sıralamalar | |
|---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Belirtilmemiş ölçüt kapsamı. Belirtmeyin. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Ölçüt tek bir etkinlikte karşılanırsa oturum, ölçütle eşleşir. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Ölçüt tek bir oturumda karşılanıyorsa oturum, ölçütle eşleşir. |
SessionSegmentExclusion
Bu segmentte hangi oturumların hariç tutulduğunu belirtir.
| JSON gösterimi |
|---|
{ "sessionExclusionDuration": enum ( |
| Alanlar | |
|---|---|
sessionExclusionDuration |
Bir oturum İsteğe bağlı. Belirtilmezse |
sessionExclusionCriteria |
Bir oturum bu koşulu karşılıyorsa oturum, |
SessionExclusionDuration
Bir oturum sessionExclusionCriteria ile eşleşirse dışlamanın ne kadar süreceğiyle ilgili seçenekleri listeler.
| Sıralamalar | |
|---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
SESSION_EXCLUSION_TEMPORARY |
Oturumun sessionExclusionCriteria koşulunu karşıladığı dönemlerde oturumları segmentten geçici olarak hariç tutun. |
SESSION_EXCLUSION_PERMANENT |
Oturumun sessionExclusionCriteria koşulunu karşılaması durumunda oturumları segmentten kalıcı olarak hariç tutun. |
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 etkinlikleri.
| 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çütle eşleşir.
| JSON gösterimi |
|---|
{
"andConditionGroups": [
{
object ( |
| Alanlar | |
|---|---|
andConditionGroups[] |
Bir etkinlik, 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ı. Belirtilmezse |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmemesine bağlı olarak segmente dahil edilir veya hariç tutulur. İfadeler, boyut, metrik ve/veya parametrelerle ilgili ölçütleri ifade eder. |
EventCriteriaScoping
Kapsam, bir etkinliğin ölçütleri karşılayıp karşılamadığını değerlendirirken hangi etkinliklerin dikkate alınacağını belirtir.
| Sıralamalar | |
|---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Belirtilmemiş ölçüt kapsamı. Belirtmeyin. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Ölçüt tek bir etkinlik içinde karşılanıyorsa etkinlik, ölçütle eşleşir. |
EventSegmentExclusion
Bu segmentte hangi etkinliklerin hariç tutulduğunu belirtir.
| JSON gösterimi |
|---|
{ "eventExclusionDuration": enum ( |
| Alanlar | |
|---|---|
eventExclusionDuration |
İsteğe bağlı. Belirtilmezse |
eventExclusionCriteria |
Bir etkinlik bu koşulu karşılıyorsa |
EventExclusionDuration
Bir etkinlik eventExclusionCriteria ile eşleşirse dışlamanın ne kadar süreceğine ilişkin seçenekleri listeler.
| Sıralamalar | |
|---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
EVENT_EXCLUSION_PERMANENT |
Etkinlik eventExclusionCriteria koşulunu karşılarsa etkinlikleri segmentten kalıcı olarak hariç tutun. |
FunnelSubReport
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 ( |
| 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 yer alabilir. |
metricHeaders[] |
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ı, terk etme sayısı ve terk etme oranı gibi ek metrikler yer alır. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerleri 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 kullanılan etkinliklerin yüzdesini açıklar. Her tarih aralığı için bir Ancak sonuçlar örneklenmemişse bu alan tanımlanmaz. |