Method: userActivity.search

Kullanıcı Etkinliği verilerini döndürür.

HTTP isteği

POST https://analyticsreporting.googleapis.com/v4/userActivity:search

URL, gTB Kod Geçişi söz dizimini kullanır.

İstek metni

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

JSON gösterimi 
{
  "dateRange": {
    object(DateRange)
  },
  "viewId": string,
  "user": {
    object(User)
  },
  "activityTypes": [
    enum(ActivityType)
  ],
  "pageSize": number,
  "pageToken": string
}
Alanlar
dateRange

object(DateRange)

Kullanıcı etkinliğinin alınacağı tarih aralığı. Tarih aralığı sağlanmazsa varsayılan tarih aralığı (başlangıç tarihi: geçerli tarih - 7 gün, bitiş tarihi: geçerli tarih - 1 gün) şeklindedir.

viewId

string

Zorunlu. Verilerin alınacağı Analytics görünüm kimliği. Her SearchUserActivityRequest, viewId değerini içermelidir.

user

object(User)

Zorunlu. Sorgulanacak benzersiz kullanıcı kimliği. Her SearchUserActivityRequest bu alanı içermelidir.

activityTypes[]

enum(ActivityType)

İstenen tüm etkinlik türleri grubu. Yanıtta yalnızca bu türlerle eşleşen kitleler döndürülür. Boş bırakılırsa tüm etkinlikler döndürülür.

pageSize

number

Sayfa boyutu sayfalandırmaya yöneliktir ve döndürülen maksimum satır sayısını belirtir. Sayfa boyutu > 0 olmalıdır. Değer 0 ise veya alan belirtilmemişse istek, varsayılan olarak sayfa başına 1.000 satırı döndürür.

pageToken

string

Sonuçların sonraki sayfasını almak için kullanılan bir devam jetonu. Bunu isteğe eklediğinizde pageToken'tan sonraki satırlar döndürülür. pageToken, SearchUserActivityRequest isteğine yanıt olarak sonrakiPageToken parametresinde döndürülen değer olmalıdır.

Yanıt metni

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

userActivity:get adlı görüşmeden gelen yanıt.

JSON gösterimi 
{
  "sessions": [
    {
      object(UserActivitySession)
    }
  ],
  "totalRows": number,
  "nextPageToken": string,
  "sampleRate": number
}
Alanlar
sessions[]

object(UserActivitySession)

Her kayıt, bir oturumu (cihaz ayrıntıları, süre vb.) temsil eder.

totalRows

number

Bu sorgunun döndürdüğü toplam satır sayısı (farklı sayfalarda).

nextPageToken

string

Bu jeton, sonraki sayfanın alınabilmesi için SearchUserActivityRequest'e aktarılmalıdır.

sampleRate

number

Bu alan, söz konusu istek için örnekleme hızını temsil eder ve 0,0 ile 1,0 arasında bir sayıdır. Ayrıntılar için geliştirici kılavuzuna bakın.

Yetkilendirme Kapsamları

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

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

Kullanıcı

Belirli bir kullanıcıyı benzersiz şekilde tanımlamak için gereken bilgileri içerir.

JSON gösterimi 
{
  "type": enum(UserIdType),
  "userId": string
}
Alanlar
type

enum(UserIdType)

İstekteki kullanıcının türü. userId alanı bu türle ilişkili.

userId

string

Verilerin istendiği kullanıcının benzersiz kimliği.

Kullanıcı KimliğiTürü

Kullanılabilen çeşitli kullanıcı tanımlama türlerini temsil eder.

Sıralamalar
USER_ID_TYPE_UNSPECIFIED User-ID Türü belirtilmediğinde, kullanılan varsayılan tür CLIENT_ID olur.
USER_ID İçerikle bir veya daha fazla cihaz ve/veya tarayıcı örneği arasında etkileşimde bulunabilecek tekil kullanıcı (ör. oturum açmış bir kullanıcı hesabı).
CLIENT_ID Analytics tarafından atanan clientId.

EtkinlikTürü

Sıralamalar
ACTIVITY_TYPE_UNSPECIFIED ActivityType, yanıtta bu değeri hiçbir zaman içermez. İstekte bu türün kullanılması hataya neden olacaktır.
PAGEVIEW Etkinlik, bir ziyaretçinin bir sayfayı görüntülemesiyle sonuçlandığında kullanılır.
SCREENVIEW Bir ziyaretçinin mobil cihazda bir uygulama kullanması sonucunda gerçekleşen etkinlikler.
GOAL Hedef türü etkinliğini belirtmek için kullanılır.
ECOMMERCE Sayfadaki ziyaretçi bir e-ticaret işlemi gerçekleştirdi.
EVENT Aktivite bir etkinlik olduğunda kullanılır.

KullanıcıEtkinlikOturumu

Bu mesaj, belirli bir cihazda belirli bir süre içinde belirli bir zamanda gerçekleştirilen kullanıcı oturumunu temsil eder.

JSON gösterimi 
{
  "sessionId": string,
  "deviceCategory": string,
  "platform": string,
  "dataSource": string,
  "activities": [
    {
      object(Activity)
    }
  ],
  "sessionDate": string
}
Alanlar
sessionId

string

Oturumun benzersiz kimliği.

deviceCategory

string

Kullanılan cihaz türü: "mobil", "tablet" vb.

platform

string

Etkinliğin gerçekleştiği platform: "android" &&t;ios" vb.

dataSource

string

Bir isabetin veri kaynağı. Varsayılan olarak, analytics.js'den gönderilen isabetler "web" olarak raporlanır ve mobil SDK'lardan gönderilen isabetler "uygulama" olarak raporlanır. Bu değerler, Measurement Protocol'da geçersiz kılınabilir.

activities[]

object(Activity)

Bu oturumdaki etkinliklerin her birinin ayrıntılı görünümünü temsil eder.

sessionDate

string

ISO-8601 biçiminde bu oturumun tarihi.

Etkinlik

Etkinlik, bir kullanıcının etkinliğiyle ilgili verileri temsil eder. Bir etkinliğin isabetten farklı olduğunu unutmayın. İsabet birden fazla Etkinliğe neden olabilir. Örneğin, bir isabette bir işlem ve bir hedef tamamlama varsa, bu isabet için bir ETOMERCE ve bir HEDEF için iki Etkinlik protonu olacaktır. Buna karşılık, birden fazla isabet de bir Etkinlik oluşturabilir. Klasik e-ticarette, bir işlemle ilgili veriler birden fazla isabet üzerinden gönderilebilir. Bu isabetler tek bir E-ticaret Etkinliği altında birleştirilecek.

JSON gösterimi 
{
  "activityTime": string,
  "source": string,
  "medium": string,
  "channelGrouping": string,
  "campaign": string,
  "keyword": string,
  "hostname": string,
  "landingPagePath": string,
  "activityType": enum(ActivityType),
  "customDimension": [
    {
      object(CustomDimension)
    }
  ],

  // Union field activity_details can be only one of the following:
  "pageview": {
    object(PageviewData)
  },
  "appview": {
    object(ScreenviewData)
  },
  "ecommerce": {
    object(EcommerceData)
  },
  "goals": {
    object(GoalSetData)
  },
  "event": {
    object(EventData)
  }
  // End of list of possible types for union field activity_details.
}
Alanlar
activityTime

string (Timestamp format)

Etkinliğin zaman damgası.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".
source

string

Yönlendirmelerin kaynağı. Manuel kampanya izlemede utm_source kampanya izleme parametresinin değeridir. AdWords otomatik etiketleme özelliği, google şeklindedir. Bunların ikisini de kullanmazsanız kullanıcıları yönlendiren kaynağın alan adı (ör. document.referrer). Ayrıca bir bağlantı noktası adresi de içerebilir. Kullanıcılar yönlendiren olmadan geldiyse değeri (doğrudan) olur.

medium

string

Yönlendirmelerin türü. Manuel kampanya izlemede utm_medium kampanya izleme parametresinin değeridir. AdWords otomatik etiketleme özelliği ise tbm'dir. Kullanıcıların Google Analytics tarafından tespit edilen bir arama motorundan gelmesi, organiktir. Yönlendiren bir arama motoru değilse bu bir yönlendirme olur. Kullanıcılar doğrudan mülke geldiyse ve document.referrer boşsa değeri (none) olur.

channelGrouping

string

Bu Görünüm için son kullanıcının oturumuyla ilişkilendirilen Kanal Grubu (Görünümün Kanal Gruplamaları tarafından tanımlanır).

campaign

string

Manuel kampanya izlemede utm_campaign kampanya izleme parametresinin değeridir. AdWords otomatik etiketleme özelliği için bu ad, mülk için kullandığınız online reklam kampanyalarının adlarıdır. İkisini de kullanmazsanız değer (ayarlanmadı) olur.

keyword

string

Manuel kampanya izlemede utm_term kampanya izleme parametresinin değeridir. AdWords trafiği için en iyi eşleşen hedefleme ölçütlerini içerir. Birden fazla hedefleme ölçütünün reklamın görünmesine neden olabileceği görüntülü reklam ağı için, Google Ads tarafından seçilen en uygun hedefleme ölçütlerini döndürür. Bu, display_keyword, site yerleşimi, boomuserlist, user_interest, age veya gender olabilir. Diğerleri içinse (ayarlanmadı) değeri kullanılır.

hostname

string

İzleme isteğinde bulunulan ana makine adı.

landingPagePath

string

Kullanıcıların oturumlarındaki ilk sayfa veya açılış sayfası.

activityType

enum(ActivityType)

Bu etkinliğin türü.

customDimension[]

object(CustomDimension)

Bu etkinlikle ilişkili tüm özel boyutların listesi.

Birlik alanı activity_details. activity_type türüne bağlı olarak aşağıdaki alanlardan tam olarak bir tanesi ayarlanır. activity_details aşağıdakilerden yalnızca biri olabilir:
pageview

object(PageviewData)

activityType öğesi PAGEVIEW değerine eşit olduğunda bu ayar ayarlanır. Bu alan, ziyaretçi ve ziyaret edilen sayfayla ilgili tüm ayrıntıları içerir.

appview

object(ScreenviewData)

activityType öğesi SCREEN_VIEW değerine eşit olduğunda bu ayar ayarlanır.

ecommerce

object(EcommerceData)

activityType öğesi ECOMMERCE değerine eşit olduğunda bu ayar ayarlanır.

goals

object(GoalSetData)

Bu alan, activityType GOAL değerine eşit olduğunda bu etkinlikte ulaşılan tüm hedeflerin bir listesini içerir.

event

object(EventData)

Bu alan, bir etkinlikle ilgili tüm ayrıntıları içerir ve activityType, EVENT değerine eşit olduğunda ayarlanır.

Özel Boyut

Özel boyut.

JSON gösterimi 
{
  "index": number,
  "value": string
}
Alanlar
index

number

Özel boyutun yuva numarası.

value

string

Özel boyutun değeri. Varsayılan değer (yani boş dize), oturum/ziyaretçi kapsamı özel boyut değerinin temizlenmesini belirtir.

Sayfa Görüntüleme Verileri

Ziyaretçi bir sayfayı görüntülediğinde toplanan ayrıntıları gösterir.

JSON gösterimi 
{
  "pagePath": string,
  "pageTitle": string
}
Alanlar
pagePath

string

Ziyaretçinin görüntülediği sayfanın URL'si.

pageTitle

string

Ziyaretçinin görüntülediği sayfanın başlığı.

Ekran Görüntüleme Verileri

JSON gösterimi 
{
  "screenName": string,
  "mobileDeviceBranding": string,
  "mobileDeviceModel": string,
  "appName": string
}
Alanlar
screenName

string

Ekranın adı.

mobileDeviceBranding

string

Mobil cihaz üreticisi veya markalı adı. Örneğin: "Google", "Apple" ve diğerleri

mobileDeviceModel

string

Mobil cihaz modeli. Örneğin: "Pixel", "iPhone" vb.

appName

string

Uygulama adı.

E-ticaretVerileri

Kullanıcı etkinliğiyle ilişkili e-ticaret ayrıntıları.

JSON gösterimi 
{
  "actionType": enum(ECommerceAction),
  "transaction": {
    object(TransactionData)
  },
  "products": [
    {
      object(ProductData)
    }
  ],
  "ecommerceType": enum(EcommerceType)
}
Alanlar
actionType

enum(ECommerceAction)

Bu e-ticaret işlemiyle ilişkili işlem.

transaction

object(TransactionData)

Bu e-ticaret işleminin işlem ayrıntıları.

products[]

object(ProductData)

Bu işlemdeki ürünlerin ayrıntıları.

ecommerceType

enum(EcommerceType)

Bu e-ticaret etkinliğinin türü.

E-ticaret İşlemi

Bir e-ticaret işlemiyle ilişkili tüm işlemler.

Sıralamalar
UNKNOWN İşlem türü bilinmiyor.
CLICK Ürün listeleri tıklaması.
DETAILS_VIEW Ürün ayrıntıları görünümleri.
ADD_TO_CART Ürünleri alışveriş sepetine ekleyin.
REMOVE_FROM_CART Ürünleri alışveriş sepetinden çıkarın.
CHECKOUT Çıkış yapın.
PAYMENT Satın alma işlemi tamamlandı.
REFUND Satın alma işlemi için geri ödeme.
CHECKOUT_OPTION Ödeme seçenekleri.

İşlem Verileri

Ziyaretçi, sayfada bir işlem yaptığında toplanan ayrıntıları temsil eder.

JSON gösterimi 
{
  "transactionId": string,
  "transactionRevenue": number,
  "transactionTax": number,
  "transactionShipping": number
}
Alanlar
transactionId

string

Alışveriş sepetindeki satın alma işlemi için e-ticaret izleme yöntemi tarafından sağlanan işlem kimliği.

transactionRevenue

number

İşlemin toplam satış geliri (gönderim ve vergi hariç).

transactionTax

number

İşlemin toplam vergisi.

transactionShipping

number

Toplam gönderim maliyeti.

Ürün Verileri

Bir e-ticaret işlemindeki ürünlerin ayrıntıları.

JSON gösterimi 
{
  "productSku": string,
  "productName": string,
  "itemRevenue": number,
  "productQuantity": string
}
Alanlar
productSku

string

Ürünü temsil eden benzersiz kod.

productName

string

Satın alınan ürünler için e-ticaret izleme uygulaması tarafından sağlanan ürün adı.

itemRevenue

number

Satın alınan ürün öğelerinden elde edilen toplam gelir.

productQuantity

string (int64 format)

İşlemdeki bu ürün birimlerinin toplam sayısı.

E-ticaretTürü

Bu, döndürülen e-ticaret verilerinin türünü temsil eder.

Sıralamalar
ECOMMERCE_TYPE_UNSPECIFIED E-ticaret etkinlik türü belirtilmemişse kullanılır.
CLASSIC Etkinlik klasik (geliştirilmiş olmayan) e-ticaret bilgilerine sahip olduğunda kullanılır.
ENHANCED Etkinlik, gelişmiş e-ticaret bilgilerine sahip olduğunda kullanılır.

HedefHedef Verileri

Bir etkinlikte ulaşılan hedef grubunu temsil eder.

JSON gösterimi 
{
  "goals": [
    {
      object(GoalData)
    }
  ]
}
Alanlar
goals[]

object(GoalData)

Mevcut etkinlikte ulaşılan tüm hedefler.

Hedef Verileri

Bir hedefle ilgili tüm ayrıntıları temsil eder.

JSON gösterimi 
{
  "goalIndex": number,
  "goalCompletions": string,
  "goalValue": number,
  "goalCompletionLocation": string,
  "goalPreviousStep1": string,
  "goalPreviousStep2": string,
  "goalPreviousStep3": string,
  "goalName": string
}
Alanlar
goalIndex

number

Hedef, profil için yapılandırıldığı şekilde tanımlanır.

goalCompletions

string (int64 format)

Bu etkinlikteki toplam hedef tamamlama sayısı.

goalValue

number

Bu hedefteki değer.

goalCompletionLocation

string

Bu hedefin tamamlandığı sayfanın URL'si.

goalPreviousStep1

string

Hedef tamamlamadan bir adım önceki sayfanın URL'si.

goalPreviousStep2

string

Hedef tamamlamadan iki adım önce sayfanın URL'si.

goalPreviousStep3

string

Hedef tamamlamadan üç adım önce sayfanın URL'si.

goalName

string

Hedefin adı.

Etkinlik Verileri

Bir etkinlikle ilgili tüm ayrıntıları gösterir.

JSON gösterimi 
{
  "eventCategory": string,
  "eventAction": string,
  "eventLabel": string,
  "eventValue": string,
  "eventCount": string
}
Alanlar
eventCategory

string

Sayfadaki etkileşim sağlanan nesne. Örnek: 'Video'.

eventAction

string

Nesneyle etkileşim türü. Örnek: 'play'.

eventLabel

string

Etkinliğe eklenen etiket.

eventValue

string (int64 format)

Etkinlikle ilişkili sayısal değer.

eventCount

string (int64 format)

Bu etkinlikteki bu tür etkinliklerin sayısı.

Deneyin.