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

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

अगर आपको किसी विज्ञापन के टाइप के लिए बने फ़ील्ड ऐक्सेस करने हैं, जैसे कि बड़े किए गए टेक्स्ट विज्ञापन का ब्यौरा, तो asType() तरीके का इस्तेमाल करके AdViewSpace बनाएं. इससे 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 पक्का करती है कि इटरेटर का हर विज्ञापन, बड़ा किया गया टेक्स्ट विज्ञापन हो. किसी गलत प्रकार वाला विज्ञापन देखने की कोशिश करने से एक गड़बड़ी होगी, जिससे आपकी स्क्रिप्ट का निष्पादन रुक जाएगा, इसलिए प्रकार-विशिष्ट फ़ील्ड देखना सिर्फ़ तब ज़रूरी है, जब विज्ञापन के प्रकार की जानकारी हो.

इस स्निपेट में 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;
  ...
}

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