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

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

मुख्य शब्द: क्वेरी, एसक्यूएल टेक्स्ट होता है. यह रिपोर्ट का आधार होता है.

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

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

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

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

---

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

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

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

---

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

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

---

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

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