Method: userActivity.search

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

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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ığı belirtilmemişse varsayılan tarih aralığı şu şekildedir: (startDate: geçerli tarih - 7 gün, endDate: geçerli tarih - 1 gün).

viewId

string

Zorunlu. Verilerin alınacağı Analytics görünüm kimliği. Her SearchUserActivityRequest, viewId öğesini 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 kümesi. Yanıtta yalnızca bu türlerle eşleşen etkinlikler döndürülür. Boş bırakılırsa tüm etkinlikler döndürülür.

pageSize

number

Sayfa boyutu, sayfalama içindir ve döndürülen maksimum satır sayısını belirtir. Sayfa boyutu 0'dan büyük olmalıdır. Değer 0 ise veya alan belirtilmemişse istek, varsayılan olarak sayfa başına 1.000 satır değerini döndürür.

pageToken

string

Sonuçların sonraki sayfasını almak için bir devam jetonu. Bu anahtarın isteğe eklenmesi, pageToken öğesinden sonraki satırları döndürür. pageToken, SearchUserActivityRequest isteğine verilen yanıttaki nextPageToken parametresinde döndürülen değer olmalıdır.

Yanıt gövdesi

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

userActivity:get aramasının yanıtı.

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

object(UserActivitySession)

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

totalRows

number

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

nextPageToken

string

Bu jeton, sonraki sayfayı almak için SearchUserActivityRequest'e iletilmelidir.

sampleRate

number

Bu alan, belirli bir 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ımlayan bilgiler 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

Verileri istenen kullanıcının benzersiz kimliği.

UserIdType

Mevcut çeşitli kullanıcı tanımlama türlerini gösterir.

Sıralamalar
USER_ID_TYPE_UNSPECIFIED Kullanıcı Kimliği Türü belirtilmezse, 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.

ActivityType

Sıralamalar
ACTIVITY_TYPE_UNSPECIFIED ActivityType ise yanıtta hiçbir zaman bu değere sahip olmaz. İstekte bu türün kullanılması hatayla sonuçlanır.
PAGEVIEW Etkinlik, ziyaretçinin bir sayfayı görüntülemesiyle sonuçlandığında kullanılır.
SCREENVIEW Etkinlik, bir ziyaretçinin mobil cihazdaki bir uygulamayı kullanmasıyla sonuçlandığında kullanılır.
GOAL Hedef türünde bir aktiviteyi belirtmek için kullanılır.
ECOMMERCE Sayfadaki ziyaretçi tarafından bir e-ticaret işlemi gerçekleştirilmiştir.
EVENT Aktivite bir etkinlik olduğunda kullanılır.

UserActivitySession

Bu, belirli bir cihazda belirli bir süre boyunca 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ü: "cep telefonu", "tablet" vb.

platform

string

Etkinliğin gerçekleştiği platform: "android", "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 her bir etkinliğin ayrıntılı görünümünü sunar.

sessionDate

string

Bu oturumun ISO-8601 biçiminde tarihi.

Etkinlik

Etkinlik, bir kullanıcı etkinliğine ait verileri temsil eder. Bir Etkinliğin, isabetten farklı olduğunu unutmayın. Bir isabet birden çok Etkinlikle sonuçlanabilir. Örneğin, bir isabet bir işlem ve bir hedef tamamlama içeriyorsa, bu isabet için biri ECOMMERCE ve diğeri GOAL için olmak üzere iki Etkinlik protosu olacaktır. Buna karşılık, birden fazla isabet de bir Etkinlik oluşturabilir. Klasik e-ticarette, bir işlemin verileri birden fazla isabet üzerinden gönderilebilir. Bu isabetler tek bir ECOMMERCE Etkinliğinde birleştirilir.

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 izleme için utm_source kampanya izleme parametresinin değeridir. AdWords otomatik etiketleme için google. İkisini de kullanmazsanız bu, kullanıcıları yönlendiren kaynağın etki alanıdır (ör. document.referrer). Bağlantı noktası adresi de içerebilir. Kullanıcılar bir yönlendiren olmadan ulaştıysa, değeri (doğrudan) olur.

medium

string

Yönlendirmelerin türü. Manuel kampanya izleme için utm_medium kampanya izleme parametresinin değeridir. AdWords otomatik etiketleme için bu değer tbm'dir. Kullanıcılar Google Analytics tarafından algılanan bir arama motorundan geldiyse, bu organik aramadır. Yönlendiren bir arama motoru değilse yönlendirmedir. 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 bir son kullanıcının oturumuyla ilişkilendirilmiş Kanal Grubu (Görünümün Kanal Gruplamaları ile tanımlanır).

campaign

string

Manuel kampanya izleme için utm_campaign kampanya izleme parametresinin değeridir. AdWords otomatik etiketlemesinde, mülk için kullandığınız çevrimiçi reklam kampanyalarının adıdır. İkisini de kullanmazsanız değeri (not set) olur.

keyword

string

Manuel kampanya izleme için 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österilmesine neden olmuş olabileceği Görüntülü Reklam Ağı için, Google Ads tarafından seçilen en iyi eşleşen hedefleme ölçütlerini döndürür. Bu, display_keyword, site yerleşimi, boomuserlist, user_interest, yaş veya cinsiyet olabilir. Aksi takdirde değeri (not set) olur.

hostname

string

İzleme isteğinin yapıldığı ana makinenin adı.

landingPagePath

string

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

Birleştirme alanı activity_details. activity_type ayarına bağlı olarak aşağıdaki alanlardan tam olarak biri ayarlanır. activity_details şunlardan yalnızca biri olabilir:
pageview

object(PageviewData)

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

appview

object(ScreenviewData)

activityType, SCREEN_VIEW değerine eşitse bu ayar ayarlanır.

ecommerce

object(EcommerceData)

activityType, ECOMMERCE değerine eşitse bu ayar ayarlanır.

goals

object(GoalSetData)

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

event

object(EventData)

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

CustomDimension

Özel boyut'u tıklayın.

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

number

Özel boyutun alan numarası.

value

string

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

PageviewData

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

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

ScreenviewData

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

string

Ekranın adı.

mobileDeviceBranding

string

Mobil cihaz üreticisi veya marka adı. Ör. "Google", "Apple" vb.

mobileDeviceModel

string

Mobil cihaz modeli. Ör. "Pixel", "iPhone" vb.

appName

string

Uygulama adı.

EcommerceData

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şkilendirilmiş 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ü.

ECommerceAction

Bir e-ticaret işlemiyle ilişkili tüm işlemleri içeren grup.

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

TransactionData

Ziyaretçi sayfada bir işlem gerçekleştirdiğinde 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 bedeli ve vergi hariç).

transactionTax

number

İşlemin toplam vergi tutarı.

transactionShipping

number

Toplam gönderim maliyeti.

ProductData

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 öğeler için, e-ticaret izleme uygulaması tarafından sağlanan ürün adı.

itemRevenue

number

Satın alınan ürünlerden elde edilen toplam gelir.

productQuantity

string (int64 format)

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

EcommerceType

Döndürülmekte olan e-ticaret verilerinin türünü temsil eder.

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

GoalSetData

Bir etkinlikte ulaşılan hedefler kümesini temsil eder.

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

object(GoalData)

Mevcut etkinlikte ulaşılan tüm hedefler.

GoalData

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

Bu, hedefin profil için yapılandırıldığını belirtir.

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 önceki sayfanın URL'si.

goalPreviousStep3

string

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

goalName

string

Hedefin adı.

EventData

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

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

string

Sayfada etkileşimde bulunulan nesne. Ör. "Video".

eventAction

string

Nesneyle etkileşimin türü. Ör. "oynat".

eventLabel

string

Etiket etkinlikle birlikte.

eventValue

string (int64 format)

Etkinlikle ilişkilendirilen sayısal değer.

eventCount

string (int64 format)

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

Deneyin.