Google Analytics में Ask Advisor का प्रोग्राम के हिसाब से इस्तेमाल करके, अपने डेटा के बारे में क्वेरी करना और उसका विश्लेषण करना

Data API का chat तरीका, Google Analytics में Ask Advisor को प्रोग्राम के हिसाब से ऐक्सेस करने की सुविधा देता है. यह एआई की मदद से काम करने वाला एक ऐसा असिस्टेंट है जो नैचुरल लैंग्वेज का इस्तेमाल करके, Google Analytics डेटा को क्वेरी करने, उसका विश्लेषण करने, और उसकी जांच करने में आपकी मदद करता है.

'सलाह पूछें' सुविधा, Google Analytics के उपयोगकर्ता इंटरफ़ेस में इंटरैक्टिव तरीके से उपलब्ध है. वहीं, chat एपीआई की मदद से डेवलपर, ऑटोनॉमस एआई एजेंट, और इंटरनल टूल, एचटीटीपी पर प्रोग्राम के हिसाब से 'सलाह पूछें' सुविधा के साथ इंटरैक्ट कर सकते हैं.

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

खास जानकारी

chat तरीके से, डेटा से जुड़े सवालों के जवाब तुरंत पाए जा सकते हैं. साथ ही, सिलसिलेवार बातचीत वाले सेशन भी किए जा सकते हैं:

  1. एक बार में पूछे जाने वाले सवाल: तुरंत विश्लेषण करने वाले सवाल पूछें. जैसे, "पिछले हफ़्ते, ट्रैफ़िक पाने वाले हमारे सबसे लोकप्रिय चैनल कौनसे थे?" इसके जवाब, स्ट्रक्चर्ड डेटा टेबल के साथ-साथ नैचुरल लैंग्वेज में पाएं.
  2. सिलसिलेवार बातचीत: बातचीत का इतिहास बनाए रखने के लिए, sessionId पास करें. साथ ही, गड़बड़ी का पता लगाने के लिए फ़ॉलो-अप वाले सवाल पूछें. जैसे, "उस अवधि में ऑर्गैनिक ट्रैफ़िक में गिरावट क्यों आई?"
  3. स्ट्रक्चर्ड डेटा के जवाब: जवाबों में टेक्स्ट के साथ-साथ, कॉलम हेडर और लाइनों वाले स्ट्रक्चर्ड table ब्लॉक भी शामिल होते हैं.
  4. चैट के कोटे की निगरानी: returnPropertyQuota को true पर सेट करके, हर दिन और हर घंटे के हिसाब से बचे हुए चैट टोकन के कोटे की जांच करें.

पुष्टि करना

chat तरीके को कॉल करने के लिए, OAuth 2.0 की अनुमति ज़रूरी है. इसके लिए, यह स्कोप इस्तेमाल करें:

शुरू करने से पहले

  1. gcloud सीएलआई को इंस्टॉल और शुरू करें.

  2. ऐप्लिकेशन के लिए डिफ़ॉल्ट क्रेडेंशियल जनरेट करने और अपने खाते को ज़रूरी स्कोप देने के लिए, यह कमांड चलाएं:

    gcloud auth application-default login --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/analytics.chatbot.read"

  3. Google Analytics के यूज़र इंटरफ़ेस (यूआई) में जाकर, अपने उपयोगकर्ता खाते को Google Analytics प्रॉपर्टी का ऐक्सेस दें.

  4. यहां दी गई जानकारी डालकर, अपने एनवायरमेंट वैरिएबल कॉन्फ़िगर करें. PROJECT_ID को अपने प्रोजेक्ट के आईडी से और PROPERTY_ID को अपनी Google Analytics प्रॉपर्टी के आईडी से बदलें. 

      export PROJECT_ID=PROJECT_ID
  export PROPERTY_ID=PROPERTY_ID

पहला उदाहरण: कोटे को ट्रैक करने वाली सिंगल-टर्न क्वेरी

नई बातचीत शुरू करने के लिए, ChatRequest बनाएं. इसमें userQuery शामिल करें. अपने बचे हुए टोकन का बैलेंस देखने के लिए, returnPropertyQuota को true पर सेट करें.

सिनारियो: डिवाइस के हिसाब से रेवेन्यू और कन्वर्ज़न रेट

आपको पिछले 30 दिनों में, अलग-अलग डिवाइसों पर रेवेन्यू और सेशन कन्वर्ज़न रेट की तुलना करनी हो.

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

curl -X POST \
  "https://analyticsdata.googleapis.com/v1alpha/properties/${PROPERTY_ID}:chat" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: ${PROJECT_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Compare our revenue and conversion rate across mobile vs desktop over the last 30 days.",
    "returnPropertyQuota": true
  }'

एचटीटीपी रिस्पॉन्स

जवाब में ये शामिल हैं:

  • नया असाइन किया गया sessionId, जिसका इस्तेमाल फ़ॉलो-अप के लिए किया जा सकता है.
  • blocks की सूची. इसमें नैचुरल लैंग्वेज में दी गई जानकारी (text) और स्ट्रक्चर्ड टेबल (table) दोनों शामिल हैं. टेक्स्ट ब्लॉक में मार्कडाउन फ़ॉर्मैटिंग शामिल हो सकती है. जैसे, टेक्स्ट को बोल्ड करने की सुविधा, हेडिंग, और लिंक.
  • प्रॉपर्टी की propertyQuota जानकारी.
{
  "sessionId": "692e9ab9-b338-4426-b006-a05f21ac7cd6",
  "blocks": [
    {
      "text": "Your report on revenue and conversion rates for mobile vs. desktop over the last 30 days (August 15 - September 13, 2026) is ready.\n\nHere is a summary of your revenue and conversion rate by device category:\n"
    },
   {
      "table": {
        "headers": [
          {
            "header": "Device Category",
            "dataType": "string"
          },
          {
            "header": "Total Revenue",
            "dataType": "string"
          },
          {
            "header": "User Conversion Rate",
            "dataType": "string"
          }
        ],
        "rows": [
          {
            "columns": [
              {
                "value": "Desktop"
              },
              {
                "value": "$17,412.62"
              },
              {
                "value": "99.9%"
              }
            ]
          },
          {
            "columns": [
              {
                "value": "Mobile"
              },
              {
                "value": "$15,309.41"
              },
              {
                "value": "99.46%"
              }
            ]
          }
      }
    },
    {
      "text": "**Revenue and Conversion Rate Trends:**\n\nRevenue from desktop devices saw a peak on August 18th, while mobile revenue peaked on August 30th. Conversion rates remained high and relatively stable for both desktop and mobile throughout the period."
    },
    {
      "text": "This product uses AI and may display inaccurate info. Your chat activity may be used to improve the product and your use is subject to Google's [Terms](https://policies.google.com/terms), [AI Use Policy](https://policies.google.com/terms/generative-ai/use-policy), and [Privacy Policy](https://policies.google.com/privacy). [Learn more about Chat AI Privacy](https://support.google.com/helpguide/answer/14185196)."
    }
  ],
   "propertyQuota": {
    "tokensPerDay": {
      "consumed": 26849,
      "remaining": 3723151
    },
    "tokensPerHour": {
      "consumed": 26849,
      "remaining": 473151
    }
  }
}

उदाहरण 2: बातचीत के आधार पर कई चरणों में डाइग्नोस्टिक्स करना

कॉन्टेक्स्ट को बनाए रखते हुए फ़ॉलो-अप वाला सवाल पूछने के लिए, अपने अनुरोध में पिछले जवाब से मिले sessionId को शामिल करें.

उदाहरण: पिछली अवधि से तुलना करना

डिवाइस की तुलना करने के पिछले अनुरोध के बाद, आपने सलाहकार से नतीजों की तुलना पिछली अवधि से करने के लिए कहा.

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

curl -X POST \
  "https://analyticsdata.googleapis.com/v1alpha/properties/${PROPERTY_ID}:chat" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: ${PROJECT_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "692e9ab9-b338-4426-b006-a05f21ac7cd6",
    "userQuery": "Compare results with the same period in the previous mounth."
  }'

एचटीटीपी रिस्पॉन्स

'सलाह पूछें' सुविधा, सेशन मेमोरी का इस्तेमाल करती है, ताकि नतीजों की तुलना पिछली अवधि से की जा सके.

{
  "sessionId": "eb3284b2-49ce-4aed-b6d0-fdc15cb87b5f",
  "blocks": [
    {
      "text": "The following table provides a detailed comparison of total revenue and user conversion rate by device category for the two periods.\n"
    },
    {
      "table": {
        "headers": [
          {
            "header": "Device Category",
            "dataType": "string"
          },
          {
            "header": "Metric",
            "dataType": "string"
          },
          {
            "header": "Jul 16 - Aug 15, 2026",
            "dataType": "string"
          },
          {
            "header": "Aug 16 - Sep 14, 2026",
            "dataType": "string"
          }
        ],
        "rows": [
          {
            "columns": [
              {
                "value": "Desktop"
              },
              {
                "value": "Total Revenue"
              },
              {
                "value": "$17,412.62"
              },
              {
                "value": "$19,565.46"
              }
            ]
          },
          {
            "columns": [
              {
                "value": "Desktop"
              },
              {
                "value": "User Conversion Rate"
              },
              {
                "value": "1.90%"
              },
              {
                "value": "1.95%"
              }
            ]
          },
          {
            "columns": [
              {
                "value": "Mobile"
              },
              {
                "value": "Total Revenue"
              },
              {
                "value": "$13,997.19"
              },
              {
                "value": "$15,309.41"
              }
            ]
          },
          {
            "columns": [
              {
                "value": "Mobile"
              },
              {
                "value": "User Conversion Rate"
              },
              {
                "value": "1.95%"
              },
              {
                "value": "1.99%"
              }
            ]
          }
      }
    }
  ]
}

जवाब का स्ट्रक्चर और डेटा ब्लॉक

ChatResponse ऑब्जेक्ट, blocks कलेक्शन में स्ट्रक्चर्ड कॉम्पोनेंट दिखाता है:

ब्लॉक का टाइप फ़ील्ड ब्यौरा
Narrative Text blocks[].text किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला डेटा और विश्लेषण से जुड़ी खास बातें.
स्ट्रक्चर्ड टेबल blocks[].table टेबल के फ़ॉर्मैट में डेटा का ब्रेकडाउन, जिसमें headers (नाम और डेटा टाइप) और rows (सेल की वैल्यू) शामिल हैं.

टेबल के हेडर के डेटा टाइप

blocks[].table.headers में मौजूद कॉलम, सिमैंटिक डेटा टाइप के बारे में बताते हैं:

  • string: कैटगरिकल टेक्स्ट वैल्यू (जैसे, "desktop", "/shop/apparel").
  • float: फ़्लोटिंग पॉइंट वाले संख्यात्मक मान.

चैट के कोटे को मैनेज करना

Ask Advisor की सुविधा के लिए किए गए अनुरोधों में, चैट टोकन का इस्तेमाल होता है. यह इस बात पर निर्भर करता है कि क्वेरी कितनी मुश्किल है. returnPropertyQuota true होने पर, मौजूदा कोटा की स्थिति propertyQuota में दिखती है:

  • tokensPerDay: रोज़ाना इस्तेमाल किए जा सकने वाले टोकन की सीमा और बाकी बचे टोकन.
  • tokensPerHour: हर घंटे के हिसाब से अनुरोध संख्या सीमित करने की स्लाइडिंग विंडो और बचा हुआ बैलेंस.

इंटिग्रेशन के लिए सुझाए गए ऐप्लिकेशन

properties.chat तरीके से, अलग-अलग टीमों और टूल के लिए कई इंटिग्रेशन आर्किटेक्चर अनलॉक किए जा सकते हैं:

एंटरप्राइज़ चैट और टीमवर्क के लिए बॉट

अपनी टीम चैट के वर्कस्पेस को सीधे Google Analytics से कनेक्ट करें.

  • थ्रेड वाले सेशन: चैट थ्रेड आईडी के साथ sessionId को सेव करें, ताकि टीम के सदस्य मिलकर फ़ॉलो-अप सवाल पूछ सकें.
  • रिच कार्ड रेंडरिंग: जवाब वाले ब्लॉक को इंटरैक्टिव कार्ड विजेट में table फ़ॉर्मैट करें.

ऑटोनॉमस एआई एजेंट और मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) टूल

एलएलएम ऑर्केस्ट्रेटर (जैसे कि Gemini, LangChain या Claude) को GA के विश्लेषण टूल के साथ इस्तेमाल करें:

  • एलएलएम को मुश्किल runReport क्वेरी जनरेट करने के लिए मजबूर करने के बजाय, एलएलएम एजेंट, नैचुरल लैंग्वेज इंटेंट के साथ chat मेथड को लागू कर सकता है.
  • एजेंट को तथ्यों का सही होना वाली खास जानकारी और स्ट्रक्चर्ड टेबल मिलती हैं. इनसे वह मल्टी-चैनल मार्केटिंग से जुड़ी सलाह दे पाता है.

एक्ज़ीक्यूटिव के लिए अपने-आप तैयार होने वाली खास जानकारी और सूचनाएं

शेड्यूल की गई ऐसी सेवाएं बनाएं जो गड़बड़ियों की पहचान करने के लिए, पहले से ही जांच करती हैं:

  • हर दिन की क्रॉन जॉब क्वेरी: "बीते कल की मुख्य परफ़ॉर्मेंस मेट्रिक की खास जानकारी दो और कन्वर्ज़न में हुई किसी भी तरह की असामान्य गिरावट का पता लगाओ."
  • अगर कोई गड़बड़ी मिलती है, तो स्क्रिप्ट अपने-आप फ़ॉलो-अप क्वेरी ट्रिगर करती है. इससे गड़बड़ी की मुख्य वजहों का पता चलता है. साथ ही, यह इंटरनल डैशबोर्ड या सीआरएम सिस्टम में खास जानकारी पोस्ट करती है.