रिपोर्टिंग

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

रिपोर्ट बनाम खोज

शिकायत करने के दो मुख्य तरीके हैं. दोनों में एक ही तरह की क्वेरी स्वीकार की जाती हैं. हालांकि, दोनों के नतीजे दिखाने का तरीका अलग-अलग होता है.

दोनों मामलों के लिए, हम इस क्वेरी का इस्तेमाल करेंगे:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

इससे आपको खोज के नतीजों का एक फ़्लैट, डिक्शनरी जैसा प्रतिनिधित्व मिलेगा. फ़ील्ड को ऐसे ऐक्सेस किया जा सकता है जैसे किसी डिक्शनरी का इस्तेमाल किया जा रहा हो. जैसे, row["campaign.id"] और row["metrics.impressions"] को सीधे तौर पर ऐक्सेस किया जा सकता है. इस फ़ॉर्मैट का इस्तेमाल करके, नतीजों को सीधे स्प्रेडशीट में एक्सपोर्ट किया जा सकता है. इसके लिए, exportToSheet() तरीके का इस्तेमाल करें. यह वह डिफ़ॉल्ट फ़ॉर्मैट नहीं है जिसमें Google Ads API से नतीजे दिखाए जाते हैं. इसलिए, कुछ मामलों में इस फ़ॉर्मैट में कुछ फ़ील्ड उपलब्ध नहीं हो सकते. अगर ऐसा है, तो आपको इसके बजाय search का इस्तेमाल करना चाहिए.

AdsApp.search()

इससे GoogleAdsRow ऑब्जेक्ट की एक सूची मिलेगी. इसमें कई फ़ील्ड होते हैं. साथ ही, हर फ़ील्ड में सब-फ़ील्ड हो सकते हैं. इसलिए, डेटा फ़ेच करने के लिए row.campaign.id और row.metrics.impressions को ऐक्सेस किया जाएगा. आम तौर पर, यह तब ज़्यादा काम का होता है, जब आपको डेटा को प्रोग्राम के हिसाब से प्रोसेस करना हो. साथ ही, कुछ फ़ील्ड सिर्फ़ search फ़ॉर्मैट में उपलब्ध हो सकते हैं, अगर उन्हें फ़्लैट फ़ॉर्मैट में नहीं बदला जा सकता.

ध्यान दें: AdsApp.search का इस्तेमाल करने पर, दिखाए जाने वाले फ़ील्ड lowerCamelCase में होंगे. भले ही, उन्हें क्वेरी में underscore_case में बताया गया हो. उदाहरण के लिए, अगर क्वेरी में आपका फ़ील्ड campaign.start_date है, तो पंक्ति से नतीजा फ़ेच करने के लिए, आपको campaign.startDate का इस्तेमाल करना होगा.

रिपोर्ट का उदाहरण

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

इस व्यू को इस्तेमाल करने के बारे में पूरी जानकारी के लिए, AdsApp.report दस्तावेज़ देखें.

खोज का उदाहरण

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

सभी संभावित सेटिंग के लिए, पूरा Adsapp.search दस्तावेज़ देखें.