रिपोर्टिंग

रिपोर्ट में, आपके खाते में मौजूद सभी अलग-अलग संसाधनों के बारे में जानकारी होती है. इससे कैंपेन, विज्ञापन ग्रुप, और उनके आंकड़ों के बारे में जानकारी फ़ेच की जा सकती है. साथ ही, अपने खाते के लिए बदलाव का इतिहास और अन्य जानकारी भी देखी जा सकती है. रिपोर्टिंग इन्फ़्रास्ट्रक्चर, 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 का पूरा दस्तावेज़ देखें.