विज्ञापन प्रकार

Google Ads में, कई तरह के विज्ञापन दिखाए जा सकते हैं. जैसे, टेक्स्ट, इमेज, और मोबाइल विज्ञापन. इस गाइड में, Google Ads स्क्रिप्ट का इस्तेमाल करके विज्ञापन बनाने, वापस पाने, और उनकी रिपोर्टिंग करने का तरीका बताया गया है. Google Ads में दिखाए जा सकने वाले सभी तरह के विज्ञापनों की खास जानकारी पाने के लिए, एपीआई गाइड देखें.

कॉन्टेंट बनाने के

स्क्रिप्ट, newAd() तरीके का इस्तेमाल करके AdGroup इंस्टेंस पर विज्ञापन बना सकती हैं. इससे एक AdBuilderSpace मिलता है. यह, काम करने वाले विज्ञापन टाइप के लिए बिल्डर बनाता है.

यहां दिए गए स्निपेट में, रिस्पॉन्सिव सर्च विज्ञापन बनाने का तरीका बताया गया है:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

कीड़ों की मौजूदगी की जांच करना

Ad से, सभी तरह के विज्ञापनों से जुड़ी कुछ जानकारी तुरंत उपलब्ध होती है. जैसे, विज्ञापन का आईडी और मंज़ूरी की स्थिति. इसके अलावा, किसी भी विज्ञापन को रोका, चालू या हटाया जा सकता है.

किसी विज्ञापन के टाइप के हिसाब से फ़ील्ड ऐक्सेस करने के लिए, जैसे, रिस्पॉन्सिव सर्च विज्ञापन की हेडलाइन, asType() तरीके का इस्तेमाल करके AdViewSpaceबनाएं. इससे, Ad के बढ़े हुए वर्शन का ऐक्सेस मिलता है. इसमें, टाइप के हिसाब से खास तरीके शामिल होते हैं.

यहां दिए गए स्निपेट में, हर रिस्पॉन्सिव सर्च विज्ञापन की हेडलाइन पाने का तरीका बताया गया है:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

ध्यान दें कि Type = RESPONSIVE_SEARCH_AD की शर्त से यह पक्का होता है कि इटरेटर का हर विज्ञापन, रिस्पॉन्सिव सर्च विज्ञापन हो. गलत टाइप वाला विज्ञापन देखने की कोशिश करने पर, एक गड़बड़ी होगी. इससे आपकी स्क्रिप्ट का एक्ज़ीक्यूशन रुक जाएगा. इसलिए, टाइप के हिसाब से फ़ील्ड सिर्फ़ तब देखें, जब किसी विज्ञापन का टाइप पता हो.

यहां दिए गए स्निपेट में, यह पता लगाने का तरीका बताया गया है कि कोई विज्ञापन सही टाइप का है या नहीं इसका इस्तेमाल करके Ad.isType() तरीका:

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

स्टैंडर्ड सिलेक्टर का इस्तेमाल करके, हेडलाइन के टेक्स्ट के हिसाब से विज्ञापनों को फ़िल्टर नहीं किया जा सकता. हालांकि, उन्हें वापस पाने के बाद, JavaScript में फ़िल्टर किया जा सकता है:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

रिपोर्टिंग

`ad_group_ad view` का इस्तेमाल, सामान्य आंकड़ों के अलावा विज्ञापन के फ़ील्ड के बारे में क्वेरी करने के लिए किया जा सकता है. उदाहरण के लिए, आप विज्ञापन के प्रकार के आधार पर फ़िल्टर कर सकते हैं का उपयोग करके ad_group_ad.ad.type. यहां दिए गए स्निपेट में, सभी रिस्पॉन्सिव सर्च विज्ञापनों के आंकड़े वापस पाने का तरीका बताया गया है:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

ऐसेट के कॉन्टेंट के हिसाब से फ़िल्टर करना

रिस्पॉन्सिव सर्च विज्ञापनों को उनकी हेडलाइन या ब्यौरे के कॉन्टेंट के हिसाब से फ़िल्टर करने के लिए, ad_group_ad_asset_view संसाधन का इस्तेमाल करें. इस व्यू में, हर हेडलाइन और ब्यौरे को एक अलग पंक्ति के तौर पर दिखाया जाता है. इससे, ऐसेट के टेक्स्ट के हिसाब से फ़िल्टर किया जा सकता है.

यहां दिए गए स्निपेट में, उन सभी रिस्पॉन्सिव सर्च विज्ञापनों के आंकड़े वापस पाने का तरीका बताया गया है जिनमें कोई खास हेडलाइन शामिल है:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

स्क्रिप्ट में रिपोर्टिंग के बारे में ज़्यादा जानने के लिए, रिपोर्ट की गाइड देखें.