रिपोर्ट बनाना और चलाना

इस गाइड में, रिपोर्ट बनाने और चलाने का तरीका बताया गया है. साथ ही, इसमें नतीजे देखने का तरीका भी बताया गया है.

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

रिपोर्ट बनाएं

विश्लेषक और सुपर उपयोगकर्ता, रिपोर्ट बना सकते हैं और उनमें बदलाव कर सकते हैं. Ads Data Hub में ऐक्सेस कंट्रोल के बारे में ज़्यादा जानें.

अहम जानकारी: बदलावों को सेव करने के लिए, किसी रिपोर्ट में बदलाव करने के बाद, सेव करें पर क्लिक करें. इसमें शेड्यूल भी शामिल हैं.

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

---

पैरामीटर

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

यहां दिए गए उदाहरण में, रिपोर्ट में campaign_ids नाम का एक पैरामीटर है, जो int64 में से array कैंपेन आईडी स्वीकार करता है:

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

  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

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

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

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

रिपोर्ट में पैरामीटर जोड़ना

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

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

1. वह रिपोर्ट खोलें जिसमें पैरामीटर कॉन्फ़िगर किए गए हैं.
2. सेटअप पैनल में, अपने तय किए गए हर पैरामीटर के लिए वैल्यू डालें
3. पैरामीटर वैल्यू को सेव करने के लिए, सेव करें पर क्लिक करें.

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

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

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

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

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

---

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

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

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

---

रिपोर्ट में बदलाव करें

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

---

रिपोर्ट चलाना

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

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

1. Ads Data Hub में, रिपोर्ट पेज खोलें.
2. उस रिपोर्ट के नाम पर क्लिक करें जिसे चलाना है.
3. चलाएं पर क्लिक करें.

शेड्यूल के हिसाब से रिपोर्ट चलाना

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

होम पेज पर शेड्यूल की गई जॉब दिखाने के लिए, मालिक फ़िल्टर सूची से कोई भी चुनें.

---

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

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

झलक देखें

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

BigQuery

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

Sheets और Data Studio

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