Phần mở rộng quảng cáo

Tập lệnh Google Ads hỗ trợ các phần mở rộng quảng cáo sau:

• Ứng dụng di động
• Số điện thoại
• Chú thích
• Giá
• Đoạn trích
• Đường liên kết của trang web

Để tìm hiểu thêm về phần mở rộng quảng cáo, hãy truy cập vào trung tâm trợ giúp.

Thận trọng: Phần mở rộng dựa trên thành phần sẽ sớm thay thế phần mở rộng dựa trên nguồn cấp dữ liệu. Hãy xem hướng dẫn di chuyển để biết thêm thông tin.

Tập lệnh Google Ads cho phép bạn truy cập vào các phần mở rộng quảng cáo được hỗ trợ trong tài khoản của mình. Ví dụ: đoạn mã sau đây truy cập vào đường liên kết của trang web:

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

Bạn có thể truy xuất các phần mở rộng quảng cáo khác được hỗ trợ theo cách tương tự bằng cách sử dụng các trình lặp tương ứng.

dựa trên xu hướng

Tập lệnh Google Ads cho phép bạn tạo các phần mở rộng quảng cáo được hỗ trợ. Ví dụ: đoạn mã sau đây sử dụng trình tạo số điện thoại để tạo một số điện thoại trong tài khoản của bạn:

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

Khi build() được gọi, số điện thoại sẽ được tạo trong tài khoản, nhưng chưa hiển thị cùng với bất kỳ quảng cáo nào. Trước tiên, bạn cần thêm đơn vị quảng cáo này vào một chiến dịch hoặc nhóm quảng cáo:

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

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

Bạn có thể tạo và liên kết các phần mở rộng quảng cáo được hỗ trợ khác với chiến dịch hoặc nhóm quảng cáo theo cách tương tự với trình tạo tương ứng.

Đang lấy số liệu thống kê

Tập lệnh Google Ads cho phép bạn truy cập vào số liệu thống kê cho các phần mở rộng quảng cáo được hỗ trợ ở cấp tài khoản, chiến dịch hoặc nhóm quảng cáo.

Ví dụ: để xem số liệu thống kê về đường liên kết của trang web:

// 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());

Bạn có thể truy cập vào số liệu thống kê cho các phần mở rộng quảng cáo được hỗ trợ khác theo cách tương tự.

Sửa đổi phần mở rộng quảng cáo

Bạn có thể sửa đổi các phần mở rộng quảng cáo hiện được hỗ trợ bằng tập lệnh Google Ads. Ví dụ: đoạn mã sau đây sẽ sửa đổi một đường liên kết của trang web hiện có:

// 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"

Lưu ý: Nếu bạn sửa đổi Sitelink, thao tác này sẽ ảnh hưởng đến việc phân phát quảng cáo trong tất cả các chiến dịch và nhóm quảng cáo mà đường liên kết của trang web đó liên kết. Quy tắc này áp dụng cho dù bạn truy xuất đường liên kết của trang web trực tiếp từ tài khoản, từ CampaignSitelink của chiến dịch đã liên kết hay từ AdGroupSitelink của nhóm quảng cáo đã liên kết. Ví dụ về mã ở trên minh hoạ hành vi này.

Các khái niệm tương tự áp dụng cho các phần mở rộng quảng cáo được hỗ trợ khác.

Truy cập phần mở rộng quảng cáo cấp nhóm quảng cáo

Tập lệnh Google Ads cho phép bạn truy cập vào phần mở rộng quảng cáo ở cấp nhóm quảng cáo. Lệnh gọi phương thức sau đây sẽ trả về các số điện thoại đã được thêm rõ ràng vào một nhóm quảng cáo. Xin lưu ý rằng nếu bạn đã thêm số điện thoại vào chiến dịch chứa nhóm quảng cáo, thì lệnh gọi phương thức sau đây sẽ không trả về số điện thoại ngay cả khi số điện thoại đủ điều kiện để xuất hiện trên các quảng cáo được phân phát từ nhóm quảng cáo đó.

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

Bạn có thể sử dụng các phần mở rộng quảng cáo được hỗ trợ khác ở cấp nhóm quảng cáo theo cách tương tự.

Truy cập phần mở rộng quảng cáo cấp tài khoản

Tập lệnh Google Ads cho phép bạn truy cập vào phần mở rộng quảng cáo ở cấp tài khoản. Bạn có thể thêm chú thích, ứng dụng di động và bài đánh giá dưới dạng phần mở rộng quảng cáo cấp tài khoản, nhưng không có các đường liên kết trang web và số điện thoại ở cấp tài khoản. Lệnh gọi phương thức sau đây sẽ trả về những chú thích đã được thêm rõ ràng vào tài khoản của bạn.

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

Bạn có thể truy cập vào ứng dụng dành cho thiết bị di động và bài đánh giá cấp tài khoản theo cách tương tự.

Việc thêm phần mở rộng quảng cáo cấp tài khoản cũng tương tự như cách thêm phần mở rộng quảng cáo cấp chiến dịch hoặc nhóm quảng cáo. Ví dụ sau minh hoạ cách thêm phần mở rộng về chú thích ở cấp tài khoản:

// 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);

Có thể thêm ứng dụng dành cho thiết bị di động và bài đánh giá cấp tài khoản theo cách tương tự.

Xóa phần mở rộng quảng cáo của chiến dịch, nhóm quảng cáo và tài khoản

Bạn có thể xoá các phần mở rộng quảng cáo được hỗ trợ khỏi chiến dịch và nhóm quảng cáo ở cấp tài khoản. Tập lệnh Google Ads không hỗ trợ xoá phần mở rộng quảng cáo khỏi một tài khoản cùng một lúc.

// 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();

Tương tự, cách xoá một ứng dụng di động cấp nhóm quảng cáo hoặc cấp tài khoản:

// 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);

Nếu tất cả các ứng dụng dành cho thiết bị di động bị xóa khỏi một chiến dịch, chiến dịch sẽ không còn tiện ích mở rộng ứng dụng dành cho thiết bị di động nữa. Để xóa tất cả ứng dụng dành cho thiết bị di động khỏi chiến dịch của mình, bạn cần truy xuất danh sách ứng dụng dành cho thiết bị di động cho chiến dịch đó và xóa từng ứng dụng một. Quy trình tương tự đối với các phần mở rộng quảng cáo được hỗ trợ khác.