ส่วนขยายโฆษณา

สคริปต์ Google Ads รองรับส่วนขยายโฆษณาต่อไปนี้

• แอปบนอุปกรณ์เคลื่อนที่
• หมายเลขโทรศัพท์
• ไฮไลต์
• ราคา
• ข้อมูลโค้ด
• ไซต์ลิงก์

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

ข้อควรระวัง: ส่วนขยายที่อิงตามชิ้นงานจะมาแทนที่ส่วนขยายที่อิงตามฟีดในเร็วๆ นี้ ดูข้อมูลเพิ่มเติมได้ในคำแนะนำในการย้ายข้อมูล

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

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

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

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

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

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

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

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

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

กำลังเรียกดูสถิติ

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

ตัวอย่างเช่น หากต้องการดูสถิติไซต์ลิงก์ ให้ทำดังนี้

// Account-level stats
// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
const sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
console.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
const campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
console.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.log(adGroupSitelinkStats.getClicks());

คุณสามารถเข้าถึงสถิติสำหรับส่วนขยายโฆษณาอื่นๆ ที่รองรับได้ในลักษณะเดียวกัน

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

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

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as above.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
console.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as above.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns
// and ad groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

หมายเหตุ: การแก้ไข Sitelink จะส่งผลต่อการแสดงโฆษณาในแคมเปญและกลุ่มโฆษณาทั้งหมดที่เชื่อมโยงกับไซต์ลิงก์ดังกล่าว กฎนี้จะมีผลไม่ว่าคุณจะเรียกไซต์ลิงก์จากบัญชีโดยตรง จาก CampaignSitelink ของแคมเปญที่เชื่อมโยง หรือจาก AdGroupSitelink ของกลุ่มโฆษณาที่เชื่อมโยง ตัวอย่างโค้ดก่อนหน้าแสดงลักษณะการทำงานนี้

แนวคิดเดียวกันนี้ก็ใช้กับส่วนขยายโฆษณาอื่นๆ ที่รองรับด้วยเช่นกัน

การเข้าถึงส่วนขยายโฆษณาระดับกลุ่มโฆษณา

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

// This will return phone numbers that have been explicitly added to this
// ad group.
const adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

คุณสามารถเข้าถึงส่วนขยายโฆษณาอื่นๆ ที่รองรับซึ่งระดับกลุ่มโฆษณาได้ในลักษณะเดียวกัน

การเข้าถึงส่วนขยายโฆษณาระดับบัญชี

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

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.currentAccount().extensions().callouts().get();

แอปบนอุปกรณ์เคลื่อนที่ระดับบัญชีและรีวิวสามารถเข้าถึงได้ในลักษณะเดียวกัน

การเพิ่มส่วนขยายโฆษณาระดับบัญชีจะคล้ายกับการเพิ่มส่วนขยายโฆษณาระดับแคมเปญหรือระดับกลุ่มโฆษณา ตัวอย่างต่อไปนี้แสดงวิธีเพิ่มส่วนขยายไฮไลต์ระดับบัญชี

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.currentAccount().addCallout(newCallout);

คุณสามารถเพิ่มแอปบนอุปกรณ์เคลื่อนที่และรีวิวระดับบัญชีได้ในลักษณะเดียวกัน

การนำส่วนขยายโฆษณาของแคมเปญ กลุ่มโฆษณา และบัญชีออก

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

// Get a mobile app from a campaign.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the
// following iterator.
const mobileAppIterator = AdsApp.extensions().mobileApps().get();

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

// Get a mobile app from an ad group.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it will
// not serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

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