अपने डेटा को क्वेरी करने और उसका विश्लेषण करने के लिए, Analytics Advisor का इस्तेमाल करना

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

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

अहम जानकारी: यह प्रॉडक्ट एआई का इस्तेमाल करता है. ऐसा हो सकता है कि इसमें आपको गलत जानकारी दिखे. आपकी चैट की गतिविधि का इस्तेमाल, प्रॉडक्ट को बेहतर बनाने के लिए किया जा सकता है. इस प्रॉडक्ट के इस्तेमाल पर, 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."
  }'

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

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

{
  "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: न्यूमेरिक फ़्लोटिंग-पॉइंट नंबर.

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

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

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

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

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

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

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

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

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

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

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

अपने-आप एक्ज़ीक्यूटिव ब्रीफ़िंग और सूचनाएं पाने की सुविधा

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

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