- 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
- 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 gibidir.
Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlarken izlediği adımları görselleştirebilmenizi ve her adımın tamamlanma durumunu hızlıca görebilmenizi sağlar. Potansiyel müşteriler, aktif ürün arayışındaki kullanıcılara ve daha sonra alıcılara nasıl dönüşür? Bir kez satın alanlar nasıl tekrar ürün satın alan kullanıcıların arasına katılır? Bu bilgilere sahip olduğunuzda etkisi düşük veya terk edilmiş müşteri yolculuklarını daha iyi hale getirebilirsiniz. Daha fazla bilgi edinmek için GA4 Dönüşüm Hunisi Keşifleri 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 ile ilgili geri bildirimde bulunmak için Google Analytics Data API 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 GA4 mülkü tanımlayıcısı. Gövde metninde değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Bir toplu istekte, bu özellik belirtilmemiş veya toplu düzeydeki özellikle tutarlı olmalıdır. Örnek: mülkleri/1234 |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 eklenir. |
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 dönüşüm hunisi adımını, döküm boyutunun benzersiz değerlerini içerecek şekilde 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ı sonraki işlemin benzersiz değerlerini içerecek şekilde 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ülke ait verilerin alt kümeleridir. Segmentler içeren bir dönüşüm hunisi raporunda, dönüşüm hunisi her bir segmentte değerlendirilir. Bu istekte belirtilen her segment yanıtta ayrı bir satır oluşturur; yanıtta da 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ı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 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, Rapor Oluşturma: Boyut Filtreleri bölümüne göz atı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 gövdesi
Dönüşüm hunisi raporu yanıtı iki alt rapor içerir. İki alt rapor farklı boyut ve metrik 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ı sayısı, tamamlanma oranı, vazgeçme ve vazgeçme oranını içeren bir rapordur. Segment boyutu yalnızca bir segment istendiyse bu yanıtta mevcuttur. Döküm boyutu, yalnızca istendiğinde bu yanıtta yer alır. |
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 mevcuttur. Tarih boyutu yalnızca |
propertyQuota |
Bu istek dahil, bu 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. Bir dönüşüm hunisi, bir dizi adımdan geçen kullanıcılar hakkında 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 girebilir ve kapalı bir dönüşüm hunisinde, kullanıcılar dönüşüm hunisine ilk adımda girmelidir. İsteğe bağlı. Belirtilmemesi durumunda kapalı dönüşüm hunisi kullanılır. |
steps[] |
Bu dönüşüm hunisinin ardışık 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 ilgili adımına dahil edebilmeleri 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ı. Belirtilmezse adımlar 1 tabanlı bir dizine eklenmiş adla adlandırılır (örneğin, "0. ", "1. " vb.). Bu ad, |
isDirectlyFollowedBy |
Doğruysa, bu adım doğrudan önceki adımı izlemelidir. Politika, yanlış değerine ayarlanırsa önceki adımla bu adım arasında etkinlikler olabilir. Belirtilmemesi halinde |
filterExpression |
Dönüşüm hunisi yolculuğunun bu adımına dahil olmak için kullanıcılarınızın 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.
" |
FunnelFilterExpression
Dönüşüm hunisi filtrelerinin 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 |
Boyut veya metrik için dönüşüm hunisi filtresi. |
funnelEventFilter |
Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtre 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ğerlerinde için bir filtre. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasındaki filtre. |
FunnelEventFilter
Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtre 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 |
Belirtilirse bu filtre, hem tek etkinlik adı hem de parametre filtre ifadeleriyle eşleşen etkinlikleri eşleştirir. Parametre filtre ifadesinde yalnızca parametre filtreleri bulunur. |
FunnelParameterFilterExpression
Parametrelerdeki 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 |
FunnelParametersFilterExpression, |
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 . Filtrelenen alan. one_parameter şunlardan yalnızca biri olabilir: |
|
eventParameterName |
Bu filtre, belirtilen etkinlik parametresinde değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri "firebase_screen" ve "currency" gibi alanları içerir. Etkinlik parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde, yalnızca EventFilter'deki bir alt filtrede kullanılabilir. EventFilter'deki bir alt filtrede etkinlik veya öğe parametreleri kullanılmalıdır. |
itemParameterName |
Bu filtre, belirtilen öğe parametresine göre değerlendirilir. Öğe parametreleri, öğe dizisinde parametreler olarak günlüğe kaydedilir. Öğe parametreleri "item_name" ve "item_category" gibi alanlar içerir. Öğe parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde, yalnızca etkinlik filtresindeki bir alt filtrede de kullanılabilir. EventFilter'deki bir 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. |
Birleştirme alanı one_filter . Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerlerinde için bir filtre. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasındaki 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 |
Boyut sütunu, dönüşüm hunisi tablosu alt rapor yanıtına eklendi. Döküm boyutu, her dönüşüm hunisi adımının dökümünü alır. |
limit |
Yanıtta döndürülecek döküm boyutunun maksimum farklı değer sayısı. Sınır belirtilmezse |
FunnelNextAction
Sonraki işlemler, kullanıcı bir adımı tamamladıktan sonra, ancak aynı kullanıcı sonraki adıma geçmeden önce bir boyutun değerini belirtir. Örneğin, nextActionDimension
değeri eventName
ise i
. dönüşüm hunisi adımı satırındaki nextActionDimension
, kullanıcının i
. dönüşüm hunisi adımına geçmesini sağlayan etkinlikten sonra, ancak 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 |
Boyut sütunu, dönüşüm hunisi görselleştirme alt rapor yanıtına eklendi. Kullanıcı
|
limit |
Yanıtta döndürülecek döküm boyutunun 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 (adımlı) bir dönüşüm hunisidir. Yanıttaki dönüşüm hunisi görselleştirme alt raporunda tarih yer almaz. |
TRENDED_FUNNEL |
Eğilimleri gösteren (çizgi grafik) dönüşüm hunisi. Yanıttaki dönüşüm hunisi görselleştirme alt raporunda tarih boyutu yer alır. |
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 segment tek bir kapsamda belirtilmiş. one_segment_scope şunlardan yalnızca biri olabilir: |
|
userSegment |
Kullanıcı segmentleri, sitenizle veya uygulamanızla etkileşim kuran 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şim kuran kullanıcıların alt kümeleridir. Örneğin, daha önce satın alma işlemi gerçekleştirmiş kullanıcılar, alışveriş sepetlerine ürün 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
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ı. Belirtilmemesi durumunda |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrik ve/veya parametrelerdeki ölçütleri ifade eder. |
UserCriteriaScoping
Kapsam oluşturma, kullanıcının bir ölçütü karşılayıp karşılamadığı 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 |
Bir etkinlikte ölçütler karşılanırsa kullanıcı ölçütleri karşılar. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Ölçütler tek bir oturumda karşılanırsa kullanıcı ölçütleri karşılar. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Ölçütler, kullanıcının herhangi bir etkinliği tarafından karşılanırsa kullanıcı ölçütleri karşılar. |
SegmentFilterExpression
Segment filtreleri 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. Bir parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtre 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ğerlerinde için bir filtre. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasındaki filtre. |
SegmentFilterScoping
Kapsamlar, bir segment filtresi değerlendirilirken birden fazla etkinliğin boyut ve metriklerinin nasıl dikkate alınması gerektiğini belirtir.
JSON gösterimi |
---|
{ "atAnyPointInTime": boolean } |
Alanlar | |
---|---|
atAnyPointInTime |
Bu Bu Ölçüt kapsamı |
SegmentEventFilter
Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre oluşturur. Bir parametre filtre ifadesi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtre 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 |
Belirtilirse bu filtre, hem tek etkinlik adı hem de parametre filtre ifadeleriyle eşleşen etkinlikleri eşleştirir. Parametre filtre ifadesinde yalnızca parametre filtreleri bulunur. |
SegmentParameterFilterExpression
Parametrelerdeki 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 |
Segment parameterFilterExpression |
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 . Filtrelenen alan. one_parameter şunlardan yalnızca biri olabilir: |
|
eventParameterName |
Bu filtre, belirtilen etkinlik parametresinde değerlendirilir. Etkinlik parametreleri, etkinliğin parametreleri olarak günlüğe kaydedilir. Etkinlik parametreleri "firebase_screen" ve "currency" gibi alanları içerir. Etkinlik parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde, yalnızca EventFilter'deki bir alt filtrede kullanılabilir. EventFilter'deki bir alt filtrede etkinlik veya öğe parametreleri kullanılmalıdır. |
itemParameterName |
Bu filtre, belirtilen öğe parametresine göre değerlendirilir. Öğe parametreleri, öğe dizisinde parametreler olarak günlüğe kaydedilir. Öğe parametreleri "item_name" ve "item_category" gibi alanlar içerir. Öğe parametreleri yalnızca segmentlerde ve dönüşüm hunilerinde, yalnızca etkinlik filtresindeki bir alt filtrede de kullanılabilir. EventFilter'deki bir 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. |
Birleştirme alanı one_filter . Bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir: |
|
stringFilter |
Dizelerle ilgili filtre. |
inListFilter |
Liste değerlerinde için bir filtre. |
numericFilter |
Sayısal değerler veya tarih değerleri için bir filtre. |
betweenFilter |
İki değer arasındaki filtre. |
SegmentParameterFilterScoping
Kapsamlar, bir segment parametre filtresi değerlendirirken birden fazla etkinliğin nasıl dikkate alınması gerektiğini belirtir.
JSON gösterimi |
---|
{ "inAnyNDayPeriod": string } |
Alanlar | |
---|---|
inAnyNDayPeriod |
Parametreyi, filtre uygulanmadan önceki belirtilen gün süresince biriktirir. Yalnızca ölçüt kapsamı Örneğin, Tarih aralığının başlangıcında tam N günlük bir zaman aralığı bulunması amacıyla tarih aralığı genişletilmez. Örneğin, 01.11.2021 - 10.10.2021 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 kapsam oluşturmada tüm sıra adımlarının karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmemesi durumunda |
sequenceMaximumDuration |
Tüm dizinin tamamlanması gereken süreyi tanımlar; örneğin, 30 Dakika.
" |
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ı ile 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 |
Doğru ise, bu adımı karşılayan etkinlik, son adımı karşılayan etkinlikten sonra gelen bir sonraki etkinlik olmalıdır. Yanlış değerine ayarlanırsa bu adım dolaylı olarak önceki adımı izler; örneğin, önceki adım ile bu adım arasında etkinlikler olabilir. İlk adım için |
stepScoping |
Kullanıcının diziyle eşleşmesi için bu sıra adımının kapsam oluşturmada karşılanması gerekir. Örneğin, İsteğe bağlı. Belirtilmemesi halinde |
segmentFilterExpression |
Kullanıcının etkinlikleri bu ifadeyle eşleşiyorsa kullanıcı bu dizi adımıyla eşleşir. İfadeler; boyut, metrik 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ı İ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 sıralar.
Sıralamalar | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
USER_EXCLUSION_TEMPORARY |
userExclusionCriteria koşulunu karşıladığı dönemlerde kullanıcıları geçici olarak segmentten hariç tutun. |
USER_EXCLUSION_PERMANENT |
userExclusionCriteria koşulunu karşılayan kullanıcılar kalıcı olarak segmentten 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
Oturum 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ş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ı. Belirtilmemesi halinde |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrik ve/veya parametrelerdeki ölçütleri ifade eder. |
SessionCriteriaScoping
Kapsam oluşturma, oturumun bir ölçütü 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 |
Bir etkinlikte ölçütler karşılanırsa oturum ölçütlerle eşleşir. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Ölçütler tek bir oturumda karşılanırsa oturum ölçütlerle eşleşir. |
SessionSegmentExclusion
Bu segmentte hangi oturumların hariç tutulacağını belirtir.
JSON gösterimi |
---|
{ "sessionExclusionDuration": enum ( |
Alanlar | |
---|---|
sessionExclusionDuration |
Bir oturum İsteğe bağlı. Belirtilmemesi halinde |
sessionExclusionCriteria |
Bir oturum bu koşulu karşılıyorsa |
SessionExclusionDuration
Bir oturum sessionExclusionCriteria
ile eşleşirse hariç tutmanın ne kadar süreceğiyle ilgili seçenekleri sıralar.
Sıralamalar | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
SESSION_EXCLUSION_TEMPORARY |
sessionExclusionCriteria koşulunu karşıladığı dönemlerde oturumları geçici olarak segmentten hariç tutun. |
SESSION_EXCLUSION_PERMANENT |
sessionExclusionCriteria koşulunu karşılayan 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 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 etkinlik bir ölçütle eşleşir.
JSON gösterimi |
---|
{
"andConditionGroups": [
{
object ( |
Alanlar | |
---|---|
andConditionGroups[] |
Bir etkinlik, söz konusu |
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ı. Belirtilmemesi halinde |
segmentFilterExpression |
Veriler, bu ifadeyle eşleşip eşleşmediğine bağlı olarak segmente dahil edilir veya segmentten hariç tutulur. İfadeler; boyut, metrik ve/veya parametrelerdeki ölçütleri ifade eder. |
EventCriteriaScoping
Kapsam oluşturma, bir etkinliğin belirli bir ölçütü karşılayıp karşılamadığı 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 |
Bir etkinlikte ölçütler karşılanırsa etkinlik ö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ı. Belirtilmemesi halinde |
eventExclusionCriteria |
Bu koşulu karşılayan etkinlikler, |
EventExclusionDuration
Bir etkinlik eventExclusionCriteria
ile eşleşirse hariç tutmanın ne kadar süreceğiyle ilgili seçenekleri sıralar.
Sıralamalar | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Belirtilmemiş hariç tutma süresi. Belirtmeyin. |
EVENT_EXCLUSION_PERMANENT |
eventExclusionCriteria koşulunu karşılıyorsa etkinlikleri kalıcı olarak segmentten 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ş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. Dökümler, tarihler ve sonraki işlemler gibi ek boyutlar istenirse yanıtta bulunabilir. |
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 ve vazgeçme oranı gibi ek metrikler içerir. |
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üzdesi gösterilir. 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 toplam etkinlik sayısı. Bu boyut, bu mülke ait verilerin bu dönüşüm hunisi raporunda analiz edilen 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 edilebilecek toplam etkinlik sayısı. Örnekleme, daha büyük veri kümesiyle ilgili anlamlı bilgileri ortaya çıkarır ve bu, daha büyük veri kümesinin boyutunu ifade eder. 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ün herhangi bir kotası biterse bu mülke yönelik tüm istekler "Kaynak tükendi" hataları döndürür.
JSON gösterimi |
---|
{ "tokensPerDay": { object ( |
Alanlar | |
---|---|
tokensPerDay |
Standart Analytics Mülkleri günde en fazla 200.000 jeton kullanabilir; Analytics 360 Mülkleri ise günde 2.000.000 jeton kullanabilir. Çoğu istek 10'dan az jeton tüketir. |
tokensPerHour |
Standart Analytics Mülkleri saatte en fazla 40.000 jeton kullanabilir; Analytics 360 Mülkleri ise saatte 400.000 jeton kullanabilir. Bir API isteği tek sayıda jeton tüketir ve bu sayı, saatlik, günlük ve proje başına saatlik kotaların tümünden çıkarılır. |
concurrentRequests |
Standart Analytics Mülkleri en fazla 10 eşzamanlı istek gönderebilir; Analytics 360 Mülkleri ise en fazla 50 eşzamanlı istek kullanabilir. |
serverErrorsPerProjectPerHour |
Standart Analytics Mülkleri ve bulut proje çiftleri, saatte en fazla 10 sunucu hatasına sahip olabilir. Analytics 360 Mülkleri ve bulut proje çiftleri ise saatte en fazla 50 sunucu hatası gösterebilir. |
potentiallyThresholdedRequestsPerHour |
Analytics Mülkleri, saat başına potansiyel olarak eşik eşiği olan boyutlara sahip en fazla 120 istek gönderebilir. Toplu istekte, isteğin potansiyel olarak eşik uygulanmış boyutlar içermesi halinde her rapor isteği bu kota için ayrı ayrı sayılır. |
tokensPerProjectPerHour |
Analytics Mülkleri, proje başına saatlik jetonlarının% 35'ini kullanabilir. Bu, standart Analytics Mülkleri için proje başına saatte en fazla 14.000 jeton kullanabilir. Analytics 360 Mülkleri ise proje başına saatte 140.000 jeton kullanabilir. Bir API isteği tek sayıda jeton tüketir ve bu sayı, saatlik, günlük ve proje başına saatlik kotaların tümünden çıkarı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. |