Loại Quảng cáo

Google Ads hỗ trợ nhiều loại quảng cáo, chẳng hạn như quảng cáo dạng văn bản, hình ảnh và quảng cáo trên thiết bị di động. Hướng dẫn này trình bày cách tạo, truy xuất và báo cáo về quảng cáo bằng tập lệnh Google Ads. Để biết thông tin tổng quan về tất cả các loại quảng cáo mà Google Ads hỗ trợ, hãy xem hướng dẫn về API.

dựa trên xu hướng

Tập lệnh có thể tạo quảng cáo bằng cách sử dụng phương thức newAd() trên các thực thể AdGroup. Thao tác này sẽ trả về một AdBuilderSpace tạo trình tạo cho các loại quảng cáo được hỗ trợ.

Đoạn mã sau đây minh hoạ cách tạo quảng cáo dạng văn bản mở rộng:

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Kiểm soát loài vật gây hại

Một số thông tin liên kết với tất cả các loại quảng cáo sẽ có sẵn ngay lập tức từ Ad, chẳng hạn như mã nhận dạng và trạng thái phê duyệt của quảng cáo. Ngoài ra, bạn có thể tạm dừng, bật hoặc xoá bất kỳ quảng cáo nào.

Để truy cập vào các trường dành riêng cho loại quảng cáo, chẳng hạn như nội dung mô tả của quảng cáo dạng văn bản mở rộng, hãy sử dụng phương thức asType() để tạo AdViewSpace. Thao tác này cung cấp quyền truy cập vào phiên bản mở rộng của Ad hiển thị các phương thức dành riêng cho loại.

Đoạn mã sau đây sẽ lấy nội dung mô tả của mọi quảng cáo dạng văn bản mở rộng:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Lưu ý rằng điều kiện Type = EXPANDED_TEXT_AD đảm bảo mọi quảng cáo từ trình duyệt là quảng cáo dạng văn bản mở rộng. Nếu bạn cố gắng xem một quảng cáo có loại không chính xác, thì lỗi sẽ xảy ra và ngăn việc thực thi tập lệnh. Vì vậy, điều quan trọng là bạn chỉ xem các trường dành riêng cho loại khi biết loại quảng cáo.

Đoạn mã sau đây cho biết cách xác định xem quảng cáo có đ��ng loại hay không bằng cách sử dụng phương thức Ad.isType():

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Báo cáo

Bạn cũng có thể sử dụng thành phần hiển thị ad_group_ad để truy vấn các trường quảng cáo theo loại cụ thể ngoài các số liệu thống kê thông thường, chẳng hạn như ad_group_ad.expanded_text_ad.headline_part1. Đoạn mã sau đây cho biết cách truy xuất số liệu thống kê cho tất cả quảng cáo dạng văn bản mở rộng chứa cụm từ "Chiết khấu" trong dòng tiêu đề 1:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Hãy xem hướng dẫn về báo cáo để biết thêm thông tin về việc báo cáo trong tập lệnh.