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.expanded_text_ad.headline_part1
แล้ว คุณสามารถใช้ข้อมูลพร็อพเพอร์ตี้ ad_group_ad
เพื่อค้นหาช่องโฆษณาที่เจาะจงประเภทได้
ข้อมูลโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลสถิติสำหรับโฆษณาแบบข้อความที่ขยายออกทั้งหมดที่มี "ลดราคา" ในบรรทัดแรก 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;
...
}
ดูข้อมูลเพิ่มเติมเกี่ยวกับการรายงานในสคริปต์ได้ในคู่มือรายงาน