ประเภทโฆษณา

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

การสร้างวิดีโอ

สคริปต์สามารถสร้างโฆษณาได้โดยใช้เมธอด newAd() ในอินสแตนซ์ AdGroup การดำเนินการนี้จะแสดงผล 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;
  ...
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการรายงานในสคริปต์ได้ในคู่มือรายงาน