क्वेरी लिखना और चलाना

क्वेरी बनाना

ध्यान दें: सभी उपयोगकर्ता क्वेरी नहीं बना सकते और न ही उनमें बदलाव कर सकते. Ads Data Hub में ऐक्सेस कंट्रोल के बारे में ज़्यादा जानें.

1. Ads Data Hub में, क्वेरी टैब पर जाएं.
2. + क्वेरी बनाएं पर क्लिक करें. विश्लेषण क्वेरी के टेंप्लेट पेज खुलता है.
3. ज़रूरी नहीं: बड़ा करें पर क्लिक करके, टेंप्लेट के SQL का डेटा देखें.
4. टेंप्लेट का इस्तेमाल करें पर क्लिक करके, वह टेंप्लेट चुनें जिसका इस्तेमाल करना है. इसके अलावा, नए सिरे से शुरू करने के लिए, खाली पर क्लिक करें.
5. अपनी रिपोर्ट के लिए कोई नाम डालें.
6. BigQuery के साथ काम करने वाले एसक्यूएल का इस्तेमाल करके, क्वेरी लिखें या उसमें बदलाव करें. Google टेबल टैब में जाकर, उपलब्ध टेबल और फ़ील्ड ढूंढे जा सकते हैं और उन्हें अपने SQL में डाला जा सकता है.
7. ज़रूरी नहीं: पैरामीटर कॉन्फ़िगर करें.
8. ज़रूरी नहीं: फ़िल्टर की गई पंक्ति की खास जानकारी कॉन्फ़िगर करें.
9. सेव करें पर क्लिक करें.

पैरामीटर

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

पैरामीटर के टाइप

इस तरह के पैरामीटर इस्तेमाल किए जा सकते हैं:

• int64
• float64
• bool
• string
• date
• timestamp
• array, अनुमति वाले किसी भी टाइप का

पैरामीटर बनाना

1. सेव की गई कोई क्वेरी खोलें या नई क्वेरी बनाएं.
2. प्रॉपर्टी > पैरामीटर > पैरामीटर जोड़ें पर क्लिक करें.
3. नाम फ़ील्ड में कोई नाम डालें. क्वेरी टेक्स्ट में पैरामीटर का रेफ़रंस देने के लिए, इस नाम का इस्तेमाल किया जाएगा.
4. पैरामीटर टाइप चुनने के लिए, ड्रॉप-डाउन मेन्यू का इस्तेमाल करें.
   • ऐरे चुनने पर, एक और ड्रॉप-डाउन मेन्यू दिखेगा. ड्रॉप-डाउन मेन्यू में, ऐरे टाइप चुनें.
5. ज़रूरी नहीं: दूसरे से चौथे चरण को तब तक दोहराएं, जब तक आप अपने सभी पैरामीटर न जोड़ लें.
6. 'सेव करें' पर क्लिक करें

पैरामीटर का इस्तेमाल करना

क्वेरी टेक्स्ट में, स्टैंडर्ड SQL पैरामीटर फ़ॉर्मैट का इस्तेमाल करें. इसके लिए, पैरामीटर के नाम के पहले @ का इस्तेमाल करें. नीचे दिए गए उदाहरण में, क्वेरी में @campaign_ids नाम का पैरामीटर है:

  /* Parameters:
  * @campaign_ids (ARRAY of INT64): A list of campaign IDs
  *   to conduct analysis on */

  WITH user_reach AS (
  SELECT 
    user_id,
    count(*) AS num_views
  FROM 
    adh.google_ads_impressions
  WHERE 
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY 
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM 
    user_reach

क्वेरी चलाने पर, नई जॉब डायलॉग में एक पैरामीटर फ़ील्ड दिखेगा. आपने जो पैरामीटर तय किए हैं उनके लिए वैल्यू डालें.

पैरामीटर हटाना

1. वह क्वेरी खोलें जिसमें मौजूद पैरामीटर को मिटाना है.
2. प्रॉपर्टी टैब खोलें.
3. पैरामीटर कार्ड में, आपको जिस पैरामीटर को मिटाना है उसके बगल में मौजूद, मिटाएं मिटाएं पर क्लिक करें.
4. 'सेव करें' पर क्लिक करें.

रिज़र्व किए गए पैरामीटर

नीचे दी गई टेबल में, Ads Data Hub के लिए रिज़र्व किए गए पैरामीटर की सूची दी गई है. इन पैरामीटर का इस्तेमाल अपनी क्वेरी में किया जा सकता है. हालांकि, रिज़र्व पैरामीटर के नाम से कोई पैरामीटर नहीं बनाया जा सकता.

start_date	date क्वेरी जॉब के शुरू होने की तारीख. इस नाम वाले उपयोगकर्ता के तय किए गए पैरामीटर को अनदेखा कर दिया जाएगा और नई नौकरी डायलॉग में सेट की गई वैल्यू से बदल दिया जाएगा.
end_date	date क्वेरी जॉब के खत्म होने की तारीख. इस नाम वाले उपयोगकर्ता के तय किए गए पैरामीटर को अनदेखा कर दिया जाएगा और नई नौकरी डायलॉग में सेट की गई वैल्यू से बदल दिया जाएगा.
time_zone	string क्वेरी जॉब के लिए टाइम ज़ोन. इस नाम वाले उपयोगकर्ता के तय किए गए पैरामीटर को अनदेखा कर दिया जाएगा और नई नौकरी डायलॉग में सेट की गई वैल्यू से बदल दिया जाएगा. सलाह: WHERE क्लॉज़ जैसी क्वेरी में टाइमज़ोन का इस्तेमाल करते समय, अंतर को रोकने के लिए, नई नौकरी में सेट किए गए टाइमज़ोन से मैच करने के लिए, time_zone का इस्तेमाल किया जा सकता है. डेटा सोर्स के लिए इस्तेमाल किए गए टाइमज़ोन का इस्तेमाल करना भी ज़रूरी है.

फ़िल्टर की गई लाइन की खास जानकारी

फ़िल्टर की गई लाइन की खास जानकारी में, निजता जांच की वजह से फ़िल्टर किया गया डेटा शामिल होता है. फ़िल्टर की गई लाइनों के डेटा को जोड़कर, सभी लाइनों वाली पंक्ति में जोड़ा जाता है. फ़िल्टर किए गए डेटा का विश्लेषण नहीं किया जा सकता. हालांकि, इससे यह जानकारी मिलती है कि नतीजों से कितना डेटा फ़िल्टर किया गया.

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

क्वेरी में बदलाव करना

1. Ads Data Hub में, क्वेरी टैब पर जाएं.
2. उस क्वेरी के नाम पर क्लिक करें जिसमें आपको बदलाव करना है.
3. क्वेरी में बदलाव करें.
4. सेव करें पर क्लिक करें.

क्वेरी चलाना

अहम जानकारी: असल डेटा पर क्वेरी चलाने से पहले, आपको उन्हें सैंडबॉक्स का इस्तेमाल करके लिखना और टेस्ट करना चाहिए. Ads Data Hub में क्वेरी लिखने के सबसे सही तरीकों के बारे में ज़्यादा जानें

क्वेरी चलाने से पहले, पक्का करें कि आपने सेवा खाते dataEditor को उस डेटासेट की अनुमति दी हो जिसमें आपके जॉइन का आउटपुट शामिल होगा. BigQuery में ऐक्सेस कंट्रोल के बारे में ज़्यादा जानें.

1. Ads Data Hub में क्वेरी टैब पर जाएं.
2. उस क्वेरी के नाम पर क्लिक करें जिसे आपको चलाना है.
3. चालू करें पर क्लिक करें.
   • क्वेरी में इस्तेमाल होने वाले बाइट की अनुमानित संख्या, पेज पर सबसे ऊपर दिखती है.
4. Ads से मिला डेटा फ़ील्ड में कोई आईडी चुनें. यह उस खाते का आईडी होना चाहिए जिससे जुड़े विज्ञापन डेटा के लिए आपको क्वेरी करनी है. (अगर आपको सैंडबॉक्स डेटा के बारे में क्वेरी करनी है, तो ADH सैंडबॉक्स ग्राहक चुनें.)
5. अगर मैच टेबल का इस्तेमाल किया जा रहा है, तो मैच टेबल फ़ील्ड में मैच टेबल चुनें.
6. निजता मोड चुनें. निजता मोड के बारे में ज़्यादा जानें.
7. डेस्टिनेशन टेबल फ़ील्ड में बताएं कि आपकी क्वेरी के नतीजों को कहां सेव किया जाना चाहिए.
8. अपनी क्वेरी की तारीख की सीमा तय करने के लिए, शुरू और खत्म होने की तारीखें डालें.
9. टाइम ज़ोन डालें. यह टाइम ज़ोन, खरीदारी के लिए चुने गए डोअर के टाइम ज़ोन से मेल खाना चाहिए.
10. ज़रूरी नहीं: किसी भी पैरामीटर के लिए वैल्यू डालें.
11. चलाएं पर क्लिक करें.

अपने नतीजे देखना

क्वेरी पूरी होने के बाद, "नौकरियां" पेज पर नतीजों की झलक देखी जा सकती है. डेटा को BigQuery, Sheets या Data Studio में भी एक्सप्लोर किया जा सकता है.

झलक देखें

पूरे हो चुके जॉब में, झलक देखें पर क्लिक करें. पहले 20 नतीजे, जॉब के नीचे दिखेंगे.

BigQuery

आपके नतीजे, डिफ़ॉल्ट रूप से BigQuery में एक्सपोर्ट हो जाते हैं. BigQuery को नई विंडो में खोलने के लिए, टेबल देखें पर क्लिक करें.

Sheets और Data Studio

एक्सप्लोर करें ड्रॉपडाउन मेन्यू खोलें और विकल्पों में से Sheets की मदद से एक्सप्लोर करें या Data Studio की मदद से एक्सप्लोर करें को चुनें. इससे डेटा, नई विंडो में खुलता है.