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:

Để 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.

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ợ tương tự bằng cách sử dụng trình lặp tương ứng.

Sáng tạo

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ợ bằng trình tạo. 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 số điện thoại đó chưa xuất hiện cùng với bất kỳ quảng cáo nào. Trước tiên, bạn cần thêm thành phần 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 các phần mở rộng quảng cáo khác được hỗ trợ và liên kết với các chiến dịch hoặc nhóm quảng cáo theo cùng một cách bằng trình tạo tương ứng.

Xem 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ụ: để nhận số liệu thống kê về đường liên kết của trang web, hãy làm như sau:

// 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ể xem số liệu thống kê cho các phần mở rộng quảng cáo khác được hỗ trợ 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 before.
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 before.
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"

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

Truy cập vào 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 các 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ề những 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 số điện thoại đã được thêm vào chiến dịch có chứa nhóm quảng cáo, thì lệnh gọi phương thức sau đây sẽ không trả về các số điện thoại đó, ngay cả khi các số điện thoại đó đủ điều kiện xuất hiện trên 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ể truy cập vào các phần mở rộng quảng cáo khác được hỗ trợ ở cấp nhóm quảng cáo theo cách tương tự.

Sử dụng 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 các 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 thể thêm đường liên kết của 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 các ứng dụng di động và bài đánh giá ở cấp tài khoản theo cách tương tự.

Cách thêm phần mở rộng quảng cáo cấp tài khoản quảng cáo 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 quảng cáo hoặc cấp nhóm quảng cáo. Ví dụ sau đây 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);

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

Xoá 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ợ việc xoá tất cả 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ự, để xoá một ứng dụng di động ở cấp nhóm quảng cáo hoặc cấp tài khoản, hãy làm như sau:

// 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 won't
// 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ả ứng dụng di động bị xoá khỏi một chiến dịch, thì chiến dịch đó sẽ không còn phần mở rộng về ứng dụng di động nữa. Để xoá tất cả ứng dụng di động khỏi chiến dịch, bạn cần truy xuất danh sách ứng dụng di động cho chiến dịch đó và xoá từng ứng dụng một. Quy trình này cũng giống như quy trình đối với các phần mở rộng quảng cáo khác được hỗ trợ.