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

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

शॉर्ट वीडियो

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

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

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

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

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

किसी विज्ञापन टाइप के खास फ़ील्ड को ऐक्सेस करने के लिए, AdViewSpace बनाने के लिए asType() वाले तरीके का इस्तेमाल करें. जैसे, बड़े किए गए टेक्स्ट विज्ञापन का ब्यौरा. इससे, Ad के एक्सटेंडेड वर्शन का ऐक्सेस मिलता है. इसमें, टाइप के हिसाब से अलग-अलग तरीके दिखते हैं.

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

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

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

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

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

रिपोर्टिंग

ad_group_ad व्यू का इस्तेमाल, सामान्य आंकड़ों के अलावा, टाइप के हिसाब से विज्ञापन फ़ील्ड की क्वेरी करने के लिए भी किया जा सकता है. जैसे, ad_group_ad.expanded_text_ad.headline_part1. नीचे दिए गए स्निपेट में, उन सभी बड़े किए गए टेक्स्ट विज्ञापनों के आंकड़े पाने का तरीका बताया गया है जिनकी हेडलाइन 1 में "छूट वाली बिक्री" शामिल है:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

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