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

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

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

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

खास जानकारी

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

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

दूसरा उदाहरण: सिलसिलेवार बातचीत के ज़रिए समस्याओं की पहचान करना

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

परिदृश्य: पिछली अवधि से तुलना करना

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

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

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."
  }'

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

Ask 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%"
              }
            ]
          }
      }
    }
  ]
}

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

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

ब्लॉक का टाइप फ़ील्ड ब्यौरा
नैरेटिव टेक्स्ट 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 तरीके का इस्तेमाल कर सकता है.
  • एजेंट को सटीक जानकारी वाली खास जानकारी और स्ट्रक्चर्ड टेबल मिलती हैं. इनकी मदद से, मल्टी-चैनल मार्केटिंग के लिए सुझाव दिए जा सकते हैं.

ऑटोमेटेड एक्ज़ीक्यूटिव ब्रीफ़िंग और अलर्ट की सुविधा

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

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

अगले चरण