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: मौजूदा तारीख - सात दिन, खत्म होने की तारीख: मौजूदा तारीख - एक दिन).

viewId

string

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

user

object(User)

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

activityTypes[]

enum(ActivityType)

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

pageSize

number

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

pageToken

string

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

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

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

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

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

UserIdType

उपलब्ध अलग-अलग तरह की उपयोगकर्ता पहचान का प्रतिनिधित्व करता है.

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

ActivityType

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

UserActivitySession

इससे पता चलता है कि किसी डिवाइस पर किसी तय समयावधि में, उपयोगकर्ता का सेशन कितना रहा.

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

string

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

deviceCategory

string

इस्तेमाल किए गए डिवाइस का टाइप: "मोबाइल", "टैबलेट" वगैरह.

platform

string

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

dataSource

string

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

activities[]

object(Activity)

इस सेशन की हर गतिविधि की पूरी जानकारी देता है.

sessionDate

string

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

गतिविधि

गतिविधि, उपयोगकर्ता की गतिविधि का डेटा दिखाती है. ध्यान दें कि कोई गतिविधि, हिट से अलग होती है. किसी हिट की वजह से कई ऐक्टिविटी हो सकती हैं. उदाहरण के लिए, अगर किसी हिट में कोई लेन-देन और लक्ष्य पूरा होना शामिल है, तो इस हिट के लिए दो ऐक्टिविटी प्रोटो होंगे, एक ECOMMERCE और एक GOAL के लिए. इसके उलट, कई हिट से एक ऐक्टिविटी भी बनाई जा सकती है. क्लासिक ई-कॉमर्स में, किसी एक लेन-देन का डेटा एक से ज़्यादा हिट के ज़रिए भेजा जा सकता है. इन हिट को एक 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 ऑटो-टैगिंग के लिए, यह प्रॉपर्टी के लिए उपयोग किए जाने वाले ऑनलाइन विज्ञापन अभियान का नाम होता है. अगर इनमें से किसी का भी इस्तेमाल नहीं किया जाता है, तो इसकी वैल्यू (not set) है.

keyword

string

मैन्युअल कैंपेन ट्रैकिंग के लिए, यह utm_term कैंपेन ट्रैकिंग पैरामीटर की वैल्यू है. AdWords ट्रैफ़िक के लिए, इसमें टारगेटिंग की सबसे सही शर्तें मौजूद होती हैं. Display Network के लिए, टारगेट करने की कई शर्तों की वजह से विज्ञापन दिख सकता है. ऐसे में, यह Google Ads की मदद से चुने गए टारगेटिंग के सबसे अच्छे दायरे को दिखाता है. यह Display_keyword, साइट प्लेसमेंट, boomuserlist, user_interest, उम्र या लिंग से जुड़ा हो सकता है. अगर ऐसा नहीं है, तो इसकी वैल्यू (not set) है.

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 है, तो इसे सेट कर दिया जाएगा.

CustomDimension

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

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

number

कस्टम डाइमेंशन की स्लॉट संख्या.

value

string

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

PageviewData

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

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

string

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

pageTitle

string

उस पेज का टाइटल जिसे विज़िटर ने देखा.

ScreenviewData

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

string

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

mobileDeviceBranding

string

मोबाइल मैन्युफ़ैक्चरर या ब्रैंड का नाम. उदाहरण: "Google", "सेब" वगैरह.

mobileDeviceModel

string

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

appName

string

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

EcommerceData

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

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

enum(ECommerceAction)

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

transaction

object(TransactionData)

इस ई-कॉमर्स कार्रवाई के लेन-देन का ब्यौरा.

products[]

object(ProductData)

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

ecommerceType

enum(EcommerceType)

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

ECommerceAction

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

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

TransactionData

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

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

string

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

transactionRevenue

number

बिक्री से होने वाला कुल रेवेन्यू (शिपिंग और टैक्स को छोड़कर).

transactionTax

number

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

transactionShipping

number

शिपिंग का कुल शुल्क.

ProductData

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

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

string

प्रॉडक्ट को दिखाने वाला यूनीक कोड.

productName

string

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

itemRevenue

number

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

productQuantity

string (int64 format)

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

EcommerceType

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

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

GoalSetData

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

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

object(GoalData)

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

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

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

EventData

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

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

string

पेज पर मौजूद वह ऑब्जेक्ट जिसके साथ इंटरैक्ट किया गया था. उदाहरण: 'वीडियो'.

eventAction

string

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

eventLabel

string

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

eventValue

string (int64 format)

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

eventCount

string (int64 format)

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

इसे आज़माएं!