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

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

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

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

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

पैरामीटर

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

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

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

• 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 के साथ एक्सप्लोर करें चुनें. इससे डेटा एक नई विंडो में खुलेगा.