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, quảng cáo dạng 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.

Lưu ý: Quảng cáo hiển thị thích ứng đã được hỗ trợ nhiều thành phần văn bản, hình ảnh và video trong cùng một quảng cáo. Quảng cáo hiển thị thích ứng cũ không hỗ trợ những tính năng mới này. Cả quảng cáo mới và quảng cáo cũ sẽ tiếp tục phân phát như bình thường, nhưng API để truy xuất và thao tác với quảng cáo hiển thị thích ứng đã thay đổi. Xem phần Xử lý quảng cáo hiển thị thích ứng cũ.

dựa trên xu hướng

Tập lệnh có thể tạo quảng cáo bằ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 tìm kiếm thích ứng:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

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

Một số thông tin liên quan đến tất cả các loại quảng cáo có sẵn ngay lập tức từ mộ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 một loại quảng cáo, chẳng hạn như dòng tiêu đề của quảng cáo tìm kiếm thích ứ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, giúp hiển thị các phương thức dành riêng cho từng loại.

Đoạn mã sau đây sẽ lấy dòng tiêu đề của mọi quảng cáo tìm kiếm thích ứng:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

Xin lưu ý rằng điều kiện Type = RESPONSIVE_SEARCH_AD đảm bảo mọi quảng cáo từ trình lặp đều là quảng cáo tìm kiếm thích ứng. Việc cố gắng xem một quảng cáo có loại không chính xác sẽ dẫn đến lỗi khiến quá trình thực thi tập lệnh của bạn dừng lại. Vì vậy, bạn chỉ nên 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 một 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().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

Mặc dù không thể lọc quảng cáo theo văn bản tiêu đề bằng cách sử dụng bộ chọn tiêu chuẩn, nhưng bạn có thể lọc quảng cáo trong JavaScript sau khi truy xuất:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

Báo cáo

Bạn có thể dùng chế độ xem ad_group_ad để truy vấn các trường quảng cáo ngoài số liệu thống kê thông thường. Ví dụ: bạn có thể lọc theo loại quảng cáo bằng cách sử dụng ad_group_ad.ad.type. Đ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 tìm kiếm thích ứng:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

Lọc theo nội dung của thành phần

Để lọc quảng cáo tìm kiếm thích ứng theo nội dung của dòng tiêu đề hoặc nội dung mô tả ở quy mô lớn, hãy sử dụng tài nguyên ad_group_ad_asset_view. Chế độ xem này coi mỗi dòng tiêu đề và nội dung mô tả là một hàng riêng biệt, cho phép bạn lọc văn bản của thành phần.

Đoạn mã sau đây truy xuất số liệu thống kê cho tất cả quảng cáo tìm kiếm thích ứng có chứa một dòng tiêu đề cụ thể:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

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.