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 dành cho thiết bị 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 được hỗ trợ khác 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 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 này 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 chiến dịch hoặc nhóm quảng cáo đó và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 các 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.

Nhận 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 tiện ích 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 một Sitelink, điều này sẽ ảnh hưởng đến việc phân phát quảng cáo trong tất cả chiến dịch và nhóm quảng cáo mà đường liên kết của trang web đó được 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 một chiến dịch được liên kết hoặc từ AdGroupSitelink của một nhóm quảng cáo được liên kết. Ví dụ về mã trước đó minh hoạ hành vi này.

Các khái niệm tương tự cũng áp dụng cho các tiện ích quảng cáo được hỗ trợ khác.

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ề các số điện thoại đã được thêm vào một nhóm quảng cáo một cách rõ ràng. Xin lưu ý rằng nếu bạn đã thêm số điện thoại vào chiến dịch mà nhóm quảng cáo thuộc về, 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 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 được hỗ trợ khác ở cấp nhóm quảng cáo theo cách tương tự.

Truy cập vào 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 dành cho thiết bị 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 trang web và số điện thoại ở cấp tài khoản. Lệnh gọi phương thức sau sẽ trả về các chú thích đã được thêm vào tài khoản của bạn một cách rõ ràng.

// 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ự.

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ư việc thêm phần mở rộng quảng cáo ở cấp chiến dịch hoặc cấp 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);

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

Xóa phần mở rộng quảng cáo ở cấp 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 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ả ứ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 ứ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 dành cho thiết bị di động. Quy trình này cũng tương tự như đối với các tiện ích quảng cáo được hỗ trợ khác.