การย้ายข้อมูลสคริปต์ส่วนขยายโฆษณา

สำคัญ: คุณใช้งานส่วนขยายที่อิงฟีดปัจจุบันต่อได้ผ่านการใช้งานสคริปต์ Google Ads แบบเดิม อย่างไรก็ตาม ส่วนขยายที่อิงกับฟีดจะไม่สามารถใช้งานได้ในเร็วๆ นี้ และส่วนขยายที่อิงกับชิ้นงานจะมีในสคริปต์ Google Ads แบบใหม่เท่านั้น เราขอแนะนำให้ย้ายสคริปต์ Google Ads เดิมไปยังประสบการณ์การใช้งานสคริปต์ Google Ads แบบใหม่โดยเร็วที่สุด

เอกสารนี้อธิบายขั้นตอนการย้ายข้อมูลสำหรับสคริปต์ที่เข้าถึงหรือจัดการส่วนขยายโฆษณา ตั้งแต่วันที่ 28 มีนาคม 2022 เป็นต้นไป ระบบจะย้ายข้อมูลส่วนขยายที่อิงกับฟีดของลูกค้าที่มีสคริปต์ที่อัปเดตส่วนขยายโฆษณาไปยังส่วนขยายใหม่ที่อิงตามชิ้นงาน ตั้งแต่วันที่ 13 พฤษภาคม 2022 เป็นต้นไป ลูกค้าที่มีสคริปต์ดึงข้อมูลส่วนขยายโฆษณา (และไม่มีสคริปต์ที่อัปเดตส่วนขยายโฆษณา) จะย้ายส่วนขยายที่อิงฟีดไปยังส่วนขยายใหม่ที่อิงตามชิ้นงาน

ภาพรวม

หมายเหตุ: หากไม่มีสคริปต์ที่เข้าถึงหรืออัปเดตส่วนขยายโฆษณา คุณก็ไม่จำเป็นต้องดำเนินการใดๆ โปรดดูคู่มือเกี่ยวกับส่วนขยายโฆษณาแทน

เราจะเลิกใช้งานรูปแบบส่วนขยายที่อิงกับฟีดที่มีอยู่แล้วเพื่อใช้ส่วนขยายที่อิงกับชิ้นงานแทน ส่วนขยายที่อิงกับฟีดจะเรียกว่าส่วนขยาย "เดิม" ใน UI ของ Google Ads ขณะที่ส่วนขยายที่อิงกับชิ้นงานจะเรียกว่าส่วนขยาย "อัปเกรดแล้ว" ใน UI ของ Google Ads

ตั้งแต่วันที่ 28 มีนาคม 2022 เป็นต้นไป ระบบจะย้ายข้อมูลส่วนขยายที่อิงตามฟีดไปยังส่วนขยายใหม่ที่อิงตามชิ้นงาน เมื่อย้ายข้อมูลแล้ว ส่วนขยายที่อิงกับฟีดจะหยุดแสดง คู่มือนี้จะระบุการย้ายข้อมูลไม่ว่าคุณจะมีทั้งส่วนขยายโฆษณาแบบฟีดและชิ้นงานในบัญชี Google Ads หรือมีแค่ส่วนขยายโฆษณาแบบฟีดในบัญชี

รายละเอียดการย้ายข้อมูล

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

กำลังดึงส่วนขยายโฆษณา

ชุดตัวเลือกส่วนขยายโฆษณาที่มีอยู่ (เช่น SitelinkSelector สามารถดึงส่วนขยายโฆษณาที่อิงกับฟีดหรือส่วนขยายโฆษณาตามเนื้อหา) โดยค่าเริ่มต้น ตัวเลือกเหล่านี้จะแสดงส่วนขยายโฆษณาประเภทใดก็ตามที่กำลังแสดงอยู่ ตารางต่อไปนี้จะสรุปประเภทของส่วนขยายโฆษณาที่แสดงอยู่ในปัจจุบัน (และจะแสดงโดยค่าเริ่มต้น)

ประเภทส่วนขยายโฆษณาในบัญชี
เฉพาะส่วนขยายโฆษณาที่อิงตามฟีด	ส่วนขยายโฆษณาที่อิงกับฟีดจะแสดงโดยค่าเริ่มต้น
เฉพาะส่วนขยายโฆษณาที่อิงตามชิ้นงาน	ส่วนขยายโฆษณาที่อิงตามเนื้อหาจะแสดงโดยค่าเริ่มต้น
ทั้งส่วนขยายโฆษณาที่อิงฟีดและตามเนื้อหา	ส่วนขยายโฆษณาที่อิงตามเนื้อหาจะแสดงโดยค่าเริ่มต้น

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

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

ในกรณีส่วนใหญ่ ไม่จำเป็นต้องเปลี่ยนแปลงโค้ดใดๆ ก่อนหรือหลังจากที่ย้ายส่วนขยายโฆษณาที่อิงกับฟีดแล้ว อย่างไรก็ตาม มีบางสถานการณ์ที่จำเป็นต้องเปลี่ยนแปลงโค้ด

การกรองส่วนขยายโฆษณาตามรหัส

เมื่อย้ายส่วนขยายโฆษณาที่อิงฟีด ส่วนขยายโฆษณาที่อิงกับชิ้นงานที่เกี่ยวข้องจะมีรหัสต่างกัน ซึ่งหมายความว่าหากขณะนี้สคริปต์ของคุณกรองส่วนขยายโฆษณาตามรหัส สคริปต์จะไม่สามารถดึงส่วนขยายโฆษณาตามเนื้อหาได้

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

ในการแก้ปัญหานี้ คุณควรกรองตามแอตทริบิวต์อื่นหรืออัปเดตโค้ดให้ใช้รหัสส่วนขยายโฆษณาที่อิงกับชิ้นงานแทน

การกรองส่วนขยายโฆษณาตามสถิติ

เมื่อย้ายส่วนขยายโฆษณาที่อิงฟีด ส่วนขยายโฆษณาตามเนื้อหาที่เกี่ยวข้องจะรีเซ็ตสถิติ คุณควรคำนึงถึงเรื่องนี้ เมื่อกรองส่วนขยายโฆษณาตามสถิติ ตัวอย่างเช่น หากขอส่วนขยายไซต์ลิงก์โดยใช้ Clicks > 100 ใน LAST_MONTH คุณอาจเห็นส่วนขยายโฆษณาน้อยกว่าปกติหากเพิ่งย้ายส่วนขยายโฆษณาที่อิงฟีดเมื่อเร็วๆ นี้

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

วิธีการที่เลิกใช้งานแล้ว

ระบบไม่รองรับช่องหลายช่องอีกต่อไปซึ่งเป็นส่วนหนึ่งของการย้ายข้อมูล ตัวอย่างเช่น เราได้เลิกใช้งานวันที่เริ่มต้นและวันที่สิ้นสุดจากส่วนขยายข้อมูลเพิ่มเติม สายที่โทรหา getStartDate() จะส่งกลับ null นอกจากนี้ ข้อความเตือนจะถูกบันทึก โปรดดูตารางต่อไปนี้เพื่อทำความเข้าใจว่าวิธีใดบ้างที่เลิกใช้งาน

ระดับ	วิธีการที่เลิกใช้งานแล้ว
ข้อความเสริม	ไม่มีวิธีการที่เลิกใช้งานแล้ว
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
ราคา	getEndDate getSchedules getStartDate
ไซต์ลิงก์	ไม่มีวิธีการที่เลิกใช้งานแล้ว
ตัวอย่างข้อมูล	getEndDate getSchedules getStartDate

กำลังอัปเดตส่วนขยายโฆษณา

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

ระดับ	วิธีการที่เลิกใช้งานแล้ว
ข้อความเสริม	ไม่มีวิธีการที่เลิกใช้งานแล้ว
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
ราคา	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
ไซต์ลิงก์	ไม่มีวิธีการที่เลิกใช้งานแล้ว
ตัวอย่างข้อมูล	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

การสร้างส่วนขยายโฆษณา

ชุดเครื่องมือสร้างส่วนขยายโฆษณาที่มีอยู่ (เช่น SitelinkBuilder สามารถสร้างส่วนขยายโฆษณาตามฟีดหรือส่วนขยายโฆษณาตามเนื้อหา) โดยค่าเริ่มต้น เครื่องมือสร้างเหล่านี้จะสร้างส่วนขยายโฆษณาประเภทใดก็ตามที่แสดงอยู่ในขณะนั้น ตารางต่อไปนี้สรุปประเภทของส่วนขยายโฆษณาที่แสดงอยู่ในปัจจุบัน (ซึ่งระบบจะสร้างขึ้นโดยค่าเริ่มต้น)

ประเภทส่วนขยายโฆษณาในบัญชี
เฉพาะส่วนขยายโฆษณาที่อิงตามฟีด	ระบบจะสร้างส่วนขยายโฆษณาที่อิงกับฟีดโดยค่าเริ่มต้น
เฉพาะส่วนขยายโฆษณาที่อิงตามชิ้นงาน	ระบบจะสร้างส่วนขยายโฆษณาตามเนื้อหาโดยค่าเริ่มต้น
ทั้งส่วนขยายโฆษณาที่อิงฟีดและตามเนื้อหา	ระบบจะสร้างส่วนขยายโฆษณาตามเนื้อหาโดยค่าเริ่มต้น

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

หากคุณต้องการสร้างส่วนขยายที่อิงกับฟีดแทนที่จะใช้ลักษณะการทำงานเริ่มต้น คุณจะทำได้โดยการเรียก build(true) แทนที่จะเป็น build() เช่น

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

แต่หากต้องการสร้างส่วนขยายที่อิงตามชิ้นงาน และปัจจุบันบัญชีของคุณมีส่วนขยายที่อิงตามฟีดเท่านั้น ให้รอจนถึงวันที่ 28 มีนาคม หรือโทรติดต่อ build(false)

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

ช่องที่ไม่รองรับ

ระบบได้เลิกใช้งานช่องบางช่องไปแล้ว ซึ่งเป็นส่วนหนึ่งของการย้ายข้อมูลส่วนขยายโฆษณา ตัวอย่างเช่น เราเลิกใช้งานวันที่เริ่มต้นและวันที่สิ้นสุดจากส่วนขยายข้อมูลเพิ่มเติมแล้ว การเรียกใช้ withEndDate หรือ withStartDate จะไม่ส่งผลต่อส่วนขยายแต่อย่างใด แต่ระบบจะบันทึกข้อความเตือนแทน โปรดดูตารางต่อไปนี้เพื่อทำความเข้าใจว่าวิธีใดมีการเลิกใช้งานสำหรับแต่ละคลาส

ระดับ	วิธีการที่เลิกใช้งานแล้ว
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate