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

สคริปต์ 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);

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