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

क्वेरी बनाएं

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

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

पैरामीटर

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

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

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

• int64
• float64
• bool
• string
• date
• timestamp
• array, अनुमति दिए गए प्रकारों में से किसी भी तरह के

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

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

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

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

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

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

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

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

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

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

क्वेरी चलाएं

अहम जानकारी: अपनी क्वेरी को असल डेटा पर चलाने से पहले, sandbox का इस्तेमाल करके लिखें और उनकी जांच करें. 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 को नई विंडो में खोलने के लिए, टेबल देखें पर क्लिक करें.

शीट और Data Studio

एक्सप्लोर करें ड्रॉपडाउन मेन्यू खोलें और विकल्पों से Sheets के साथ एक्सप्लोर करें या Data Studio के साथ एक्सप्लोर करें चुनें. इससे डेटा एक नई विंडो में खुलेगा.