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 được 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 phương thức
newAd()
trên các thực thể
AdGroup
. Thao tác này sẽ trả về
AdBuilderSpace
để tạo trình tạo cho
các loại quảng cáo được hỗ trợ.
Đoạn mã sau đây trình bày 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 quan đến tất cả các loại quảng cáo sẽ có sẵn ngay từ
Ad
, chẳng hạn như
mã nhận dạng của quảng cáo và trạng thái phê duyệt. Ngoài ra, bất kỳ quảng cáo nào cũng có thể bị tạm dừng, bật hoặc xoá.
Để 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ư 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 một
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 từng kiểu.
Đoạn mã sau đây trình bày nội dung mô tả về 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 lặp đều là quảng cáo dạng văn bản mở rộng. Việc cố gắng xem quảng cáo có loại không chính xác sẽ dẫn đến lỗi và dừng quá trình thực thi tập lệnh. Vì vậy, bạn chỉ nên xem các trường theo loại cụ thể 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ó thuộ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ể dùng chế độ xem ad_group_ad
để truy vấn các trường quảng cáo theo loại cụ thể ngoài 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 có chứa cụm từ "Giảm giá ưu đãi" 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;
...
}
Xem hướng dẫn về báo cáo để biết thêm thông tin về cách báo cáo trong tập lệnh.