रिपोर्टिंग

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