रिपोर्टिंग

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