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

क्वेरी बनाना

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

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

पैरामीटर

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

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

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

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

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

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

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

क्वेरी टेक्स्ट में, स्टैंडर्ड एसक्यूएल पैरामीटर फ़ॉर्मैट का इस्तेमाल करें. इसके तहत, पैरामीटर के नाम से पहले @ लगाना होता है. यहां दिए गए उदाहरण में, क्वेरी में @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 का इस्तेमाल किया जा सकता है. इससे नया जॉब में सेट किए गए टाइमज़ोन से मिलान किया जा सकता है. डेटा सोर्स के समय क्षेत्र का इस्तेमाल करना भी ज़रूरी है.
params	string एक्सपोर्ट की गई टेबल के नाम रखने के लिए नेमस्पेस. अपनी क्वेरी में प्लेसहोल्डर बनाने के लिए, इस फ़ॉर्मैट का इस्तेमाल करें. इसके बाद, रिपोर्ट चलाते समय टेबल का नाम डालें: params.TABLE_NAME (अन्य पैरामीटर के लिए इस्तेमाल किए जाने वाले @ का इस्तेमाल न करें). इस पैरामीटर का इस्तेमाल करने के बारे में ज़्यादा जानने और उदाहरण देखने के लिए, एक क्वेरी का इस्तेमाल करके, कई टेबल एक्सपोर्ट करना लेख पढ़ें.

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

फ़िल्टर की गई लाइन की खास जानकारी में, निजता की जांच की वजह से फ़िल्टर किए गए डेटा का मिलान किया जाता है. फ़िल्टर की गई लाइनों में मौजूद डेटा को जोड़ा जाता है और 'अन्य' लाइन में शामिल किया जाता है. फ़िल्टर किए गए डेटा का आगे विश्लेषण नहीं किया जा सकता. हालांकि, इससे यह पता चलता है कि नतीजों से कितना डेटा फ़िल्टर किया गया था.

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

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

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

क्वेरी चलाना

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

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

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

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

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

झलक देखें

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

BigQuery

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

Sheets और Data Studio

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