การจัดการโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

ปัจจุบันการสร้างตัวจัดทําซ้ำโฆษณาที่มีเงื่อนไข Type = RESPONSIVE_DISPLAY_AD จะทําซ้ำเฉพาะโฆษณาเดิมเท่านั้น เงื่อนไขนี้เลิกใช้งานแล้ว โปรดอัปเดตโค้ดที่มีอยู่ให้ใช้ Type = LEGACY_RESPONSIVE_DISPLAY_AD อย่างชัดแจ้ง หากต้องการสร้างตัวจัดทําโฆษณาซ้ำในโฆษณาที่รองรับชิ้นงานข้อความ รูปภาพ และวิดีโอหลายรายการ ให้ใช้เงื่อนไข Type = MULTI_ASSET_RESPONSIVE_DISPLAY_AD

ข้อมูลโค้ดต่อไปนี้แสดงความแตกต่างและจุดร่วมบางอย่างของ API ระหว่างโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา 2 ประเภท โปรดอ่านข้อมูลอ้างอิงเกี่ยวกับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาเพื่อดูรายละเอียดเพิ่มเติม

// let legacyRdaIterator = AdsApp.ads().withCondition("Type = RESPONSIVE_DISPLAY_AD").get();
let legacyRdaIterator = AdsApp.ads().withCondition("Type = LEGACY_RESPONSIVE_DISPLAY_AD").get();
while (legacyRdaIterator.hasNext()) {
  let responsiveDisplayAd = legacyRdaIterator.next().asType().responsiveDisplayAd();

  // Legacy responsive display ads have just one long headline.
  let longHeadline = responsiveDisplayAd.getLongHeadline();

  // And they have one short headline, too.
  let shortHeadline = responsiveDisplayAd.getShortHeadline();

  // This call to .getHeadlines() returns null, because the method is not
  // meaningful when called on a legacy responsive display ad.
  assert(responsiveDisplayAd.getHeadlines() === null);

  // ... etc. ...
}

let rdaIterator = AdsApp.ads().withCondition("Type = MULTI_ASSET_RESPONSIVE_DISPLAY_AD").get();
while (rdaIterator.hasNext()) {
  let responsiveDisplayAd = rdaIterator.next().asType().responsiveDisplayAd();

  // Responsive display ads have just one long headline.
  let longHeadline = responsiveDisplayAd.getLongHeadline();

  // But they can have multiple short headline text assets.
  let shortHeadlineAssets = responsiveDisplayAd.getHeadlines();

  // This call to .getShortHeadline() returns null, because the method is only
  // meaningful when called on a legacy responsive display ad.
  assert(responsiveDisplayAd.getShortHeadline() === null);

  // ... etc. ...
}

let rdaAndLegacyIterator = AdsApp.ads().withCondition("Type IN [LEGACY_RESPONSIVE_DISPLAY_AD, MULTI_ASSET_RESPONSIVE_DISPLAY_AD]").get();
while (rdaAndLegacyIterator.hasNext()) {
  let responsiveDisplayAd = legacyRdaIterator.next().asType().responsiveDisplayAd();
  let longHeadline = responsiveDisplayAd.getLongHeadline();

  // The .isLegacy() method can be used to differentiate between responsive
  // display ad types within an iterator over both.
  if (responsiveDisplayAd.isLegacy()) {
    let shortHeadline = responsiveDisplayAd.getShortHeadline();
    // ... etc. ...
  } else {
    let shortHeadlineAssets = responsiveDisplayAd.getHeadlines();
    // ... etc. ...
  }
}