Di chuyển tập lệnh phần mở rộng quảng cáo

Tài liệu này mô tả quy trình di chuyển các tập lệnh truy cập hoặc quản lý phần mở rộng quảng cáo. Kể từ ngày 28 tháng 3 năm 2022, những khách hàng có tập lệnh cập nhật phần mở rộng quảng cáo sẽ được chuyển phần mở rộng dựa trên nguồn cấp dữ liệu sang phần mở rộng mới dựa trên thành phần. Kể từ ngày 13 tháng 5 năm 2022, những khách hàng có tập lệnh tìm nạp phần mở rộng quảng cáo (và không có tập lệnh cập nhật phần mở rộng quảng cáo) sẽ được di chuyển phần mở rộng dựa trên nguồn cấp dữ liệu sang phần mở rộng mới dựa trên thành phần.

Tổng quan

Mô hình phần mở rộng dựa trên nguồn cấp dữ liệu hiện tại sẽ ngừng hoạt động và được thay thế bằng phần mở rộng dựa trên thành phần. Phần mở rộng dựa trên nguồn cấp dữ liệu được gọi là phần mở rộng "Cũ" trong giao diện người dùng Google Ads, còn phần mở rộng dựa trên thành phần được gọi là phần mở rộng "Đã nâng cấp" trong giao diện người dùng Google Ads.

Kể từ ngày 28 tháng 3 năm 2022, phần mở rộng dựa trên nguồn cấp dữ liệu sẽ được di chuyển sang phần mở rộng mới dựa trên thành phần. Sau khi được di chuyển, phần mở rộng dựa trên nguồn cấp dữ liệu sẽ ngừng phân phát. Hướng dẫn này sẽ trình bày cách di chuyển cho dù bạn có cả phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu và phần mở rộng quảng cáo dựa trên thành phần trong tài khoản Google Ads hay chỉ có phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu trong tài khoản.

Chi tiết di chuyển

Để bắt đầu truy cập hoặc cập nhật các phần mở rộng quảng cáo dựa trên thành phần, bạn phải sử dụng trải nghiệm Tập lệnh Google Ads mới. Để biết thông tin về trải nghiệm Tập lệnh Google Ads mới, hãy xem Hướng dẫn bắt đầu sử dụng.

Tìm nạp phần mở rộng quảng cáo

Bộ chọn bộ chọn Tiện ích quảng cáo hiện có (ví dụ: SitelinkSelector có thể tìm nạp phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu hoặc phần mở rộng quảng cáo dựa trên thành phần. Theo mặc định, các bộ chọn này sẽ trả về bất kỳ loại phần mở rộng quảng cáo nào đang phân phát. Bảng sau đây tóm tắt loại phần mở rộng quảng cáo đang được phân phát (và theo đó sẽ được trả về theo mặc định):

Loại phần mở rộng quảng cáo trong tài khoản
Chỉ phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu Phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu sẽ được trả về theo mặc định
Chỉ phần mở rộng quảng cáo dựa trên thành phần Phần mở rộng quảng cáo dựa trên thành phần sẽ được trả về theo mặc định
Cả phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu và dựa trên thành phần Phần mở rộng quảng cáo dựa trên thành phần sẽ được trả về theo mặc định

Sau khi di chuyển tất cả phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu, tất cả bộ chọn phần mở rộng quảng cáo sẽ trả về phần mở rộng quảng cáo dựa trên thành phần theo mặc định. Bạn vẫn có thể tìm nạp phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu bằng phương thức withOnlyLegacy. Việc này rất hữu ích cho việc thu thập các chỉ số trước đây.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

Trong hầu hết các trường hợp, bạn không cần thay đổi mã trước hoặc sau khi di chuyển phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu. Tuy nhiên, có một vài trường hợp có thể cần phải thay đổi mã.

Lọc phần mở rộng quảng cáo theo mã nhận dạng

Khi di chuyển một phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu, phần mở rộng quảng cáo dựa trên thành phần tương ứng sẽ có một mã khác. Điều này có nghĩa là nếu tập lệnh của bạn hiện đang lọc phần mở rộng quảng cáo theo mã nhận dạng, thì tập lệnh đó sẽ không thể tìm nạp phần mở rộng quảng cáo dựa trên thành phần.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

Để giải quyết vấn đề này, bạn nên lọc theo một thuộc tính khác hoặc cập nhật mã để sử dụng mã của phần mở rộng quảng cáo dựa trên thành phần.

Lọc phần mở rộng quảng cáo theo số liệu thống kê

Khi di chuyển một phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu, phần mở rộng quảng cáo dựa trên thành phần tương ứng sẽ được đặt lại số liệu thống kê. Bạn nên cân nhắc điều này khi lọc phần mở rộng quảng cáo theo số liệu thống kê. Ví dụ: nếu bạn yêu cầu phần mở rộng về đường liên kết trang web có Clicks > 100 trong LAST_MONTH, thì bạn có thể thấy ít phần mở rộng quảng cáo hơn bình thường nếu gần đây bạn di chuyển các phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu.

Bạn cũng nên lưu ý điều này khi tạo báo cáo hiệu suất cho phần mở rộng quảng cáo của mình. Báo cáo của bạn có thể thấy những thay đổi hoặc mức giảm đáng kể khi các phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu của bạn được di chuyển.

Các phương thức ngừng hoạt động

Trong quá trình di chuyển, một số trường không được hỗ trợ nữa. Ví dụ: ngày bắt đầu và ngày kết thúc không còn được dùng trong Phần mở rộng về đoạn mã. Các lệnh gọi đến getStartDate() sẽ trả về null. Ngoài ra, một thông báo cảnh báo cũng sẽ được ghi lại. Hãy xem bảng sau đây để tìm hiểu các phương thức không còn được dùng nữa:

Lớp Các phương thức ngừng hoạt động
Chú thích Không có phương thức nào không dùng nữa
MobileApp getSchedules
PhoneNumber getEndDate
getStartDate
Giá getEndDate
getSchedules
getStartDate
Đường liên kết của trang web Không có phương thức nào không dùng nữa
Đoạn trích getEndDate
getSchedules
getStartDate

Đang cập nhật phần mở rộng quảng cáo

Trong quá trình di chuyển, một số trường không được hỗ trợ nữa. Ví dụ: ngày bắt đầu và ngày kết thúc không còn được dùng trong Phần mở rộng về đoạn mã. Các lệnh gọi đến setStartDate sẽ không ảnh hưởng đến phần mở rộng quảng cáo. Ngoài ra, một thông báo cảnh báo sẽ được ghi lại. Hãy xem bảng sau đây để tìm hiểu các phương thức không được dùng nữa:

Lớp Các phương thức ngừng hoạt động
Chú thích Không có phương thức nào không dùng nữa
MobileApp setSchedules
PhoneNumber clearEndDate
clearStartDatesetEndDate
setStartDate
Giá clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate
Đường liên kết của trang web Không có phương thức nào không dùng nữa
Đoạn trích clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate

Tạo phần mở rộng quảng cáo

Tập hợp các trình tạo Phần mở rộng quảng cáo hiện có (ví dụ: SitelinkBuilder có thể tạo phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu hoặc phần mở rộng quảng cáo dựa trên thành phần. Theo mặc định, các trình tạo này sẽ tạo bất kỳ loại phần mở rộng quảng cáo nào hiện đang phân phát. Bảng sau đây tóm tắt loại phần mở rộng quảng cáo đang được phân phát (và loại phần mở rộng này sẽ được tạo theo mặc định):

Loại phần mở rộng quảng cáo trong tài khoản
Chỉ phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu Phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu sẽ được tạo theo mặc định
Chỉ phần mở rộng quảng cáo dựa trên thành phần Phần mở rộng quảng cáo dựa trên thành phần sẽ được tạo theo mặc định
Cả phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu và dựa trên thành phần Phần mở rộng quảng cáo dựa trên thành phần sẽ được tạo theo mặc định

Sau khi khách hàng đã di chuyển phần mở rộng, tất cả các trình tạo phần mở rộng quảng cáo sẽ tạo phần mở rộng quảng cáo dựa trên thành phần theo mặc định. Chúng tôi sẽ không hỗ trợ việc tạo phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu nữa vì phần mở rộng quảng cáo dựa trên nguồn cấp dữ liệu sẽ không còn phân phát nữa.

Nếu muốn tạo tiện ích dựa trên nguồn cấp dữ liệu thay vì dựa vào hành vi mặc định, bạn có thể thực hiện việc này bằng cách gọi build(true) thay vì build(), ví dụ:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

Nếu muốn tạo phần mở rộng dựa trên thành phần và tài khoản của bạn hiện chỉ có phần mở rộng dựa trên nguồn cấp dữ liệu, thì bạn có thể đợi đến ngày 28 tháng 3 hoặc gọi hàm build(false).

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

Các trường không được hỗ trợ

Trong quá trình di chuyển phần mở rộng quảng cáo, một số trường nhất định đã không được dùng nữa. Ví dụ: chúng tôi đã ngừng sử dụng ngày bắt đầu và ngày kết thúc trong Phần mở rộng về đoạn mã. Các lệnh gọi đến withEndDate hoặc withStartDate sẽ không có bất kỳ ảnh hưởng nào đến tiện ích này—thay vào đó, thông báo cảnh báo sẽ được ghi lại. Hãy xem bảng sau đây để tìm hiểu các phương thức không còn được dùng cho từng lớp:

Lớp Các phương thức ngừng hoạt động
CalloutBuilder withMobilePreferred
MobileAppBuilder withMobilePreferred
withSchedules
PhoneNumberBuilder withEndDate
withMobilePreferred
withStartDate
PriceBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate
SitelinkBuilder withMobilePreferred
SnippetBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate