- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme Kapsamları
- Kullanıcı
- UserIdType
- ActivityType
- UserActivitySession
- Etkinlik
- CustomDimension
- PageviewData
- ScreenviewData
- EcommerceData
- ECommerceAction
- TransactionData
- ProductData
- EcommerceType
- GoalSetData
- GoalData
- EventData
- Deneyin.
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( |
Alanlar | |
---|---|
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 |
Zorunlu. Verilerin alınacağı Analytics görünüm kimliği. Her SearchUserActivityRequest, |
user |
Zorunlu. Sorgulanacak benzersiz kullanıcı kimliği. Her SearchUserActivityRequest bu alanı içermelidir. |
activityTypes[] |
İ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 |
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 |
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( |
Alanlar | |
---|---|
sessions[] |
Her kayıt bir oturumu temsil eder (cihaz ayrıntıları, süre vb.). |
totalRows |
Bu sorgunun döndürdüğü toplam satır sayısı (farklı sayfalarda). |
nextPageToken |
Bu jeton, sonraki sayfayı almak için SearchUserActivityRequest'e iletilmelidir. |
sampleRate |
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( |
Alanlar | |
---|---|
type |
İstekteki kullanıcının türü. |
userId |
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( |
Alanlar | |
---|---|
sessionId |
Oturumun benzersiz kimliği. |
deviceCategory |
Kullanılan cihaz türü: "cep telefonu", "tablet" vb. |
platform |
Etkinliğin gerçekleştiği platform: "android", "ios" vb. |
dataSource |
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[] |
Bu oturumdaki her bir etkinliğin ayrıntılı görünümünü sunar. |
sessionDate |
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( |
Alanlar | ||
---|---|---|
activityTime |
Etkinliğin zaman damgası. RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: |
|
source |
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 |
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 |
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 |
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 |
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 |
İzleme isteğinin yapıldığı ana makinenin adı. |
|
landingPagePath |
Kullanıcı oturumlarındaki ilk sayfa veya açılış sayfası. |
|
activityType |
Bu etkinliğin türü. |
|
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 |
|
|
appview |
|
|
ecommerce |
|
|
goals |
Bu alan, |
|
event |
Bu alan, bir etkinlikle ilgili tüm ayrıntıları içerir ve |
CustomDimension
Özel boyut'u tıklayın.
JSON gösterimi | |
---|---|
{ "index": number, "value": string } |
Alanlar | |
---|---|
index |
Özel boyutun alan numarası. |
value |
Ö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 |
Ziyaretçinin görüntülediği sayfanın URL'si. |
pageTitle |
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 |
Ekranın adı. |
mobileDeviceBranding |
Mobil cihaz üreticisi veya marka adı. Ör. "Google", "Apple" vb. |
mobileDeviceModel |
Mobil cihaz modeli. Ör. "Pixel", "iPhone" vb. |
appName |
Uygulama adı. |
EcommerceData
Kullanıcı etkinliğiyle ilişkili e-ticaret ayrıntıları.
JSON gösterimi | |
---|---|
{ "actionType": enum( |
Alanlar | |
---|---|
actionType |
Bu e-ticaret işlemiyle ilişkilendirilmiş işlem. |
transaction |
Bu e-ticaret işleminin işlem ayrıntıları. |
products[] |
Bu işlemdeki ürünlerin ayrıntıları. |
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 |
Alışveriş sepetindeki satın alma işlemi için e-ticaret izleme yöntemi tarafından sağlanan işlem kimliği. |
transactionRevenue |
İşlemin toplam satış geliri (gönderim bedeli ve vergi hariç). |
transactionTax |
İşlemin toplam vergi tutarı. |
transactionShipping |
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 |
Ürünü temsil eden benzersiz kod. |
productName |
Satın alınan öğeler için, e-ticaret izleme uygulaması tarafından sağlanan ürün adı. |
itemRevenue |
Satın alınan ürünlerden elde edilen toplam gelir. |
productQuantity |
İş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( |
Alanlar | |
---|---|
goals[] |
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 |
Bu, hedefin profil için yapılandırıldığını belirtir. |
goalCompletions |
Bu etkinlikteki toplam hedef tamamlama sayısı. |
goalValue |
Bu hedefteki değer. |
goalCompletionLocation |
Bu hedefin tamamlandığı sayfanın URL'si. |
goalPreviousStep1 |
Hedef tamamlamadan bir adım önceki sayfanın URL'si. |
goalPreviousStep2 |
Hedef tamamlamadan iki adım önceki sayfanın URL'si. |
goalPreviousStep3 |
Hedef tamamlamadan üç adım önceki sayfanın URL'si. |
goalName |
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 |
Sayfada etkileşimde bulunulan nesne. Ör. "Video". |
eventAction |
Nesneyle etkileşimin türü. Ör. "oynat". |
eventLabel |
Etiket etkinlikle birlikte. |
eventValue |
Etkinlikle ilişkilendirilen sayısal değer. |
eventCount |
Bu etkinlikteki bu tür etkinliklerin sayısı. |