Method: userActivity.search

उपयोगकर्ता गतिविधि का डेटा दिखाता है.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल होता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में ये स्ट्रक्चर शामिल हैं:

जेएसओएन के काेड में दिखाना
{
  "dateRange": {
    object(DateRange)
  },
  "viewId": string,
  "user": {
    object(User)
  },
  "activityTypes": [
    enum(ActivityType)
  ],
  "pageSize": number,
  "pageToken": string
}
फ़ील्ड
dateRange

object(DateRange)

तारीख की वह सीमा जिसके लिए उपयोगकर्ता गतिविधि को वापस पाना है. अगर तारीख की सीमा नहीं दी गई है, तो तारीख की डिफ़ॉल्ट सीमा (startDate: मौजूदा तारीख - 7 दिन, endDate: मौजूदा तारीख - 1 दिन) होती है.

viewId

string

ज़रूरी है. वह Analytics व्यू आईडी जिससे डेटा वापस पाना है. हर SearchUserActivityRequest में viewId शामिल होना चाहिए.

user

object(User)

ज़रूरी है. क्वेरी करने के लिए यूनीक उपयोगकर्ता आईडी. हर SearchUserActivityRequest में यह फ़ील्ड शामिल होना चाहिए.

activityTypes[]

enum(ActivityType)

अनुरोध की जाने वाली सभी तरह की गतिविधियों का सेट. जवाब में, सिर्फ़ इस तरह की जानकारी से मेल खाने वाले जवाब दिखाए जाएंगे. अगर खाली है, तो सभी गतिविधियां दिखेंगी.

pageSize

number

पेज का साइज़ तय करने के लिए, पेज की साइज़ तय की गई है. इससे पता चलता है कि कितनी पंक्तियां दिखानी हैं. पेज का साइज़ &gt होना चाहिए; 0. अगर वैल्यू 0 है या फ़ील्ड के बारे में नहीं बताया गया है, तो अनुरोध हर पेज के लिए 1,000 लाइनें डिफ़ॉल्ट के तौर पर दिखाता है.

pageToken

string

जारी रखने वाला टोकन, जो नतीजों का अगला पेज दिखाता है. इसे अनुरोध में जोड़ने से pageToken के बाद पंक्तियां मिल जाएंगी. pageToken, SearchUserActivityRequest के अनुरोध के जवाब में अगला PageToken पैरामीटर में रिटर्न किया गया वैल्यू होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

userActivity:get कॉल का जवाब.

जेएसओएन के काेड में दिखाना
{
  "sessions": [
    {
      object(UserActivitySession)
    }
  ],
  "totalRows": number,
  "nextPageToken": string,
  "sampleRate": number
}
फ़ील्ड
sessions[]

object(UserActivitySession)

हर रिकॉर्ड एक सेशन के बारे में बताता है (डिवाइस की जानकारी, अवधि वगैरह).

totalRows

number

इस क्वेरी से दिखाई गई कुल पंक्तियां (अलग-अलग पेजों में).

nextPageToken

string

अगले पेज को फिर से पाने के लिए, इस टोकन को SearchUserActivityRequest को पास किया जाना चाहिए.

sampleRate

number

यह फ़ील्ड दिए गए अनुरोध के लिए सैंपल लेने की दर दिखाता है और यह 0.0 से 1.0 के बीच की कोई संख्या होती है. ज़्यादा जानकारी के लिए डेवलपर गाइड देखें.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

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

उपयोगकर्ता

इसमें किसी खास उपयोगकर्ता की खास तरीके से पहचान करने के लिए जानकारी होती है.

जेएसओएन के काेड में दिखाना
{
  "type": enum(UserIdType),
  "userId": string
}
फ़ील्ड
type

enum(UserIdType)

अनुरोध में उपयोगकर्ता का प्रकार. फ़ील्ड userId, इस टाइप से जुड़ा है.

userId

string

उस उपयोगकर्ता का यूनीक आईडी जिसके लिए डेटा का अनुरोध किया जा रहा है.

उपयोगकर्ता आईडी प्रकार

अलग-अलग उपयोगकर्ता की पहचान के बारे में बताता है.

Enums
USER_ID_TYPE_UNSPECIFIED User-ID के टाइप की जानकारी नहीं देने पर, डिफ़ॉल्ट टाइप CLIENT_ID होगा.
USER_ID कोई एकल उपयोगकर्ता, जैसे कोई साइन-इन किया गया उपयोगकर्ता खाता, जो एक या ज़्यादा डिवाइस और / या ब्राउज़र इंस्टेंस की सामग्री के साथ इंटरैक्ट कर सकता है.
CLIENT_ID Analytics ने ClientId असाइन किया है.

गतिविधि प्रकार

Enums
ACTIVITY_TYPE_UNSPECIFIED ऐक्टिविटी टाइप के जवाब में यह वैल्यू कभी नहीं होगी. अनुरोध में इस तरह का इस्तेमाल करने से गड़बड़ी हो सकती है.
PAGEVIEW इसका इस्तेमाल तब किया जाता है, जब वेबसाइट पर आने वाला कोई व्यक्ति किसी पेज को देखता है.
SCREENVIEW इसका इस्तेमाल तब किया जाता है, जब वेबसाइट पर आने वाले लोग मोबाइल डिवाइस पर किसी ऐप्लिकेशन का इस्तेमाल करते हैं.
GOAL इसका इस्तेमाल यह बताने के लिए किया जाता है कि लक्ष्य किस तरह की गतिविधि है.
ECOMMERCE पेज पर आने वाले लोगों ने एक ई-कॉमर्स लेन-देन किया.
EVENT इसका इस्तेमाल तब किया जाता है, जब गतिविधि कोई इवेंट हो.

उपयोगकर्ता गतिविधि का सेशन

यह किसी खास डिवाइस पर, एक तय समय के दौरान किए गए उपयोगकर्ता सेशन को दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "sessionId": string,
  "deviceCategory": string,
  "platform": string,
  "dataSource": string,
  "activities": [
    {
      object(Activity)
    }
  ],
  "sessionDate": string
}
फ़ील्ड
sessionId

string

सेशन का यूनीक आईडी.

deviceCategory

string

किस तरह का डिवाइस इस्तेमाल किया गया है: quot;mobile", "tablet" वगैरह.

platform

string

वह प्लैटफ़ॉर्म जिस पर गतिविधि हुई: "android", "ios" वगैरह.

dataSource

string

किसी हिट का डेटा स्रोत. डिफ़ॉल्ट रूप से, analytics.js से भेजे गए हिट को "वेब" के रूप में रिपोर्ट किया जाता है और मोबाइल SDK टूल से भेजे गए हिट को "ऐप्लिकेशन" के रूप में रिपोर्ट किया जाता है. मेज़रमेंट प्रोटोकॉल में ये वैल्यू बदली जा सकती हैं.

activities[]

object(Activity)

इस सेशन की हर गतिविधि के बारे में ज़्यादा जानकारी देता है.

sessionDate

string

ISO-8601 फ़ॉर्मैट में इस सेशन की तारीख.

ऐक्टिविटी

ऐक्टिविटी, किसी उपयोगकर्ता की गतिविधि के लिए डेटा दिखाती है. ध्यान दें कि कोई गतिविधि, किसी हिट से अलग होती है. एक हिट के कारण कई गतिविधियाँ हो सकती हैं. उदाहरण के लिए, अगर किसी हिट में लेन-देन और लक्ष्य पूरा करना शामिल है, तो इस हिट के लिए दो गतिविधि प्रोटो लागू होंगे, एक ECOMMERCE के लिए और दूसरा लक्ष्य के लिए. इसके उलट, कई हिट एक गतिविधि भी बना सकते हैं. क्लासिक ई-कॉमर्स में, एक लेन-देन का डेटा कई हिट के ज़रिए भेजा जा सकता है. इन हिट को एक ई-कॉमर्स गतिविधि में मर्ज कर दिया जाएगा.

जेएसओएन के काेड में दिखाना
{
  "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.
}
फ़ील्ड
activityTime

string (Timestamp format)

गतिविधि का टाइमस्टैंप.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड तक सटीक होता है. उदाहरण: "2014-10-02T15:01:23.045123456Z".

source

string

रेफ़रल का स्रोत. मैन्युअल कैंपेन ट्रैकिंग के लिए, यह utm_source कैंपेन ट्रैकिंग पैरामीटर की वैल्यू है. AdWords ऑटो-टैगिंग के लिए google. अगर आप इस्तेमाल नहीं करते हैं, तो यह उपयोगकर्ताओं को रेफ़र करने वाले स्रोत (जैसे कि document.referrer) का डोमेन है. इसमें पोर्ट पता भी शामिल हो सकता है. अगर उपयोगकर्ता किसी रेफ़रल देने वाले के बिना आए हैं, तो इसकी वैल्यू (डायरेक्ट) होती है.

medium

string

रेफ़रल का टाइप. मैन्युअल कैंपेन ट्रैकिंग के लिए, यह utm_medium कैंपेन ट्रैकिंग पैरामीटर का मान है. AdWords ऑटो-टैगिंग के लिए, यह cpc है. अगर उपयोगकर्ता, Google Analytics से मिले सर्च इंजन से आते हैं, तो यह ऑर्गैनिक होता है. अगर रेफ़रल देने वाला कोई सर्च इंजन नहीं है, तो इसका मतलब है कि वह रेफ़रल देने वाला है. अगर उपयोगकर्ता सीधे प्रॉपर्टी पर आए हैं और document.referrer खाली है, तो इसकी वैल्यू (कोई नहीं) होती है.

channelGrouping

string

इस व्यू के लिए, असली उपयोगकर्ता के सेशन से जुड़ा चैनल ग्रुप (जिसे व्यू की चैनल ग्रुपिंग ने तय किया है).

campaign

string

मैन्युअल कैंपेन ट्रैकिंग के लिए, यह utm_campaign के कैंपेन ट्रैकिंग पैरामीटर की वैल्यू है. AdWords ऑटो-टैगिंग के लिए, यह प्रॉपर्टी के लिए इस्तेमाल किए जाने वाले ऑनलाइन विज्ञापन कैंपेन का नाम होता है. अगर आप इनमें से किसी का इस्तेमाल नहीं करते हैं, तो इसकी वैल्यू (सेट नहीं है) है.

keyword

string

मैन्युअल कैंपेन ट्रैकिंग के लिए, यह utm_term कैंपेन ट्रैकिंग पैरामीटर की वैल्यू है. AdWords ट्रैफ़िक के लिए, इसमें टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) की सबसे अच्छी शर्त शामिल होती है. 'डिसप्ले नेटवर्क' के लिए, जहां एक से ज़्यादा टारगेटिंग मानदंड की वजह से विज्ञापन दिखाई दे सकता था, वह विज्ञापन के मुताबिक चुने गए सबसे अच्छे मिलान मानदंड को दिखाता है. यह डिसप्ले_कीवर्ड, साइट प्लेसमेंट, बूम उपयोगकर्तालिस्ट, उपयोगकर्ता_दिलचस्पी, उम्र या लिंग हो सकता है. अगर ऐसा नहीं है, तो इसकी वैल्यू सेट नहीं है.

hostname

string

वह होस्टनेम जिससे ट्रैकिंग का अनुरोध किया गया था.

landingPagePath

string

उपयोगकर्ताओं' सत्रों या लैंडिंग पेज का पहला पेज.

activityType

enum(ActivityType)

इस गतिविधि का प्रकार.

customDimension[]

object(CustomDimension)

इस गतिविधि से जुड़े सभी कस्टम डाइमेंशन की सूची.

यूनियन फ़ील्ड activity_details. activity_type के आधार पर, इनमें से कोई एक फ़ील्ड सेट किया जाएगा. activity_details इनमें से सिर्फ़ एक हो सकता है:
pageview

object(PageviewData)

activityType के PAGEVIEW के बराबर होने पर इसे सेट किया जाएगा. इस फ़ील्ड में, वेबसाइट पर आने वाले व्यक्ति और देखे गए पेज की पूरी जानकारी होती है.

appview

object(ScreenviewData)

activityType के SCREEN_VIEW के बराबर होने पर इसे सेट किया जाएगा.

ecommerce

object(EcommerceData)

activityType के ECOMMERCE के बराबर होने पर इसे सेट किया जाएगा.

goals

object(GoalSetData)

इस फ़ील्ड में उन सभी लक्ष्यों की सूची होती है जो activityType के GOAL के बराबर होने पर इस गतिविधि में पूरे हुए थे.

event

object(EventData)

इस फ़ील्ड में किसी इवेंट से जुड़ी सभी जानकारी शामिल है. अगर activityType, EVENT के बराबर हो, तो इसे सेट किया जाएगा.

कस्टम आयाम

कस्टम डाइमेंशन.

जेएसओएन के काेड में दिखाना
{
  "index": number,
  "value": string
}
फ़ील्ड
index

number

कस्टम आयाम की स्लॉट संख्या.

value

string

कस्टम डाइमेंशन की वैल्यू. डिफ़ॉल्ट वैल्यू (जैसे कि खाली स्ट्रिंग) यह दिखाती है कि कस्टम डाइमेंशन या वैल्यू को साफ़ करने वाला/से आने वाला दायरा हटा दिया गया है.

पेज व्यू का डेटा

जब विज़िटर किसी पेज को देखता है, तब इकट्ठा की गई जानकारी को दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "pagePath": string,
  "pageTitle": string
}
फ़ील्ड
pagePath

string

उस पेज का यूआरएल जिसे विज़िटर ने देखा.

pageTitle

string

उस पेज का शीर्षक जिसे विज़िटर ने देखा.

स्क्रीन व्यू डेटा

जेएसओएन के काेड में दिखाना
{
  "screenName": string,
  "mobileDeviceBranding": string,
  "mobileDeviceModel": string,
  "appName": string
}
फ़ील्ड
screenName

string

स्क्रीन का नाम.

mobileDeviceBranding

string

मोबाइल निर्माता या ब्रैंड का नाम. उदाहरण: "Google", "Apple" वगैरह.

mobileDeviceModel

string

मोबाइल डिवाइस का मॉडल. उदाहरण: "Pixel", "iPhone" वगैरह.

appName

string

ऐप्लिकेशन का नाम.

ई-कॉमर्स डेटा

उपयोगकर्ता गतिविधि से जुड़ा ई-कॉमर्स का ब्यौरा.

जेएसओएन के काेड में दिखाना
{
  "actionType": enum(ECommerceAction),
  "transaction": {
    object(TransactionData)
  },
  "products": [
    {
      object(ProductData)
    }
  ],
  "ecommerceType": enum(EcommerceType)
}
फ़ील्ड
actionType

enum(ECommerceAction)

इस ई-कॉमर्स कार्रवाई से जुड़ी कार्रवाई.

transaction

object(TransactionData)

इस ई-कॉमर्स कार्रवाई के लेन-देन का विवरण.

products[]

object(ProductData)

इस लेन-देन में शामिल प्रॉडक्ट की जानकारी.

ecommerceType

enum(EcommerceType)

इस ई-कॉमर्स गतिविधि का प्रकार.

ई-कॉमर्स की कार्रवाई

किसी ई-कॉमर्स कार्रवाई से जुड़ी सभी कार्रवाइयों का सेट.

Enums
UNKNOWN कार्रवाई के प्रकार की जानकारी नहीं है.
CLICK प्रॉडक्ट सूचियों पर क्लिक करें.
DETAILS_VIEW प्रॉडक्ट की जानकारी वाले व्यू.
ADD_TO_CART कार्ट में प्रॉडक्ट जोड़ें.
REMOVE_FROM_CART कार्ट से प्रॉडक्ट हटाएं.
CHECKOUT ज़्यादा जानें.
PAYMENT खरीदारी पूरी हुई.
REFUND खरीदारी का रिफ़ंड.
CHECKOUT_OPTION चेकआउट के विकल्प.

लेन-देन का डेटा

जब विज़िटर पेज पर लेन-देन करता है, तब इकट्ठा की गई जानकारी दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "transactionId": string,
  "transactionRevenue": number,
  "transactionTax": number,
  "transactionShipping": number
}
फ़ील्ड
transactionId

string

ई-कॉमर्स ट्रैकिंग विधि से खरीदारी करने के लिए, शॉपिंग कार्ट में खरीदारी के लिए लेन-देन आईडी.

transactionRevenue

number

लेन-देन से होने वाली बिक्री से होने वाली कुल आय (टैक्स और टैक्स को छोड़कर).

transactionTax

number

लेन-देन के लिए कुल टैक्स.

transactionShipping

number

शिपिंग की कुल लागत.

प्रॉडक्ट डेटा

किसी ई-कॉमर्स लेन-देन में शामिल प्रॉडक्ट की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "productSku": string,
  "productName": string,
  "itemRevenue": number,
  "productQuantity": string
}
फ़ील्ड
productSku

string

यूनीक कोड, जो प्रॉडक्ट को दिखाता है.

productName

string

खरीदे गए आइटम के लिए ई-कॉमर्स ट्रैकिंग ऐप्लिकेशन से मिला प्रॉडक्ट का नाम.

itemRevenue

number

खरीदे गए प्रॉडक्ट आइटम से होने वाली कुल आय.

productQuantity

string (int64 format)

लेन-देन में इस प्रॉडक्ट यूनिट की कुल संख्या.

ई-कॉमर्स टाइप

यह दिखाया जा रहा ई-कॉमर्स डेटा का टाइप दिखाता है.

Enums
ECOMMERCE_TYPE_UNSPECIFIED इसका इस्तेमाल तब किया जाता है, जब ई-कॉमर्स गतिविधि का टाइप तय न हो.
CLASSIC इसका इस्तेमाल तब किया जाता है, जब गतिविधि में क्लासिक (गैर-बेहतर) ई-कॉमर्स की जानकारी हो.
ENHANCED इसका इस्तेमाल तब किया जाता है, जब गतिविधि में ई-कॉमर्स की बेहतर जानकारी शामिल हो.

गोलसेटडेटा

यह एक ऐसी ऐक्टिविटी के लक्ष्यों के सेट को दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "goals": [
    {
      object(GoalData)
    }
  ]
}
फ़ील्ड
goals[]

object(GoalData)

मौजूदा गतिविधि में हासिल किए गए सभी लक्ष्य.

लक्ष्य डेटा

किसी लक्ष्य से जुड़ी सभी जानकारी दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "goalIndex": number,
  "goalCompletions": string,
  "goalValue": number,
  "goalCompletionLocation": string,
  "goalPreviousStep1": string,
  "goalPreviousStep2": string,
  "goalPreviousStep3": string,
  "goalName": string
}
फ़ील्ड
goalIndex

number

इससे उस लक्ष्य की पहचान होती है जिसे प्रोफ़ाइल के लिए कॉन्फ़िगर किया गया है.

goalCompletions

string (int64 format)

इस गतिविधि में पूरे हुए लक्ष्यों की कुल संख्या.

goalValue

number

इस लक्ष्य में दी गई वैल्यू.

goalCompletionLocation

string

उस पेज का यूआरएल जहां यह लक्ष्य पूरा हुआ था.

goalPreviousStep1

string

लक्ष्य पूरा होने से एक कदम पहले पेज का यूआरएल.

goalPreviousStep2

string

लक्ष्य पूरा होने से पहले के दो चरणों वाले पेज का यूआरएल.

goalPreviousStep3

string

लक्ष्य पूरा होने से पहले के तीन चरणों वाले पेज का यूआरएल.

goalName

string

लक्ष्य का नाम.

इवेंट डेटा

किसी इवेंट से जुड़ी सभी जानकारी दिखाता है.

जेएसओएन के काेड में दिखाना
{
  "eventCategory": string,
  "eventAction": string,
  "eventLabel": string,
  "eventValue": string,
  "eventCount": string
}
फ़ील्ड
eventCategory

string

पेज पर मौजूद वह ऑब्जेक्ट जिससे इंटरैक्ट किया गया था. उदाहरण:#&39;Video'.

eventAction

string

ऑब्जेक्ट के साथ इंटरैक्शन का टाइप. उदाहरण: 'play'.

eventLabel

string

इवेंट के साथ अटैच किया गया लेबल.

eventValue

string (int64 format)

इवेंट से जुड़ी संख्या वाली वैल्यू.

eventCount

string (int64 format)

इस गतिविधि में ऐसे इवेंट की संख्या.

इसे आज़माएं!