Nội dung nghe nhìn quảng cáo

Một số loại quảng cáo, chẳng hạn như ImageAd và ResponsiveDisplayAd, chứa hình ảnh và các phần tử nội dung đa phương tiện khác. Hướng dẫn này mô tả cách tải lên và truy vấn nội dung nghe nhìn bằng tập lệnh Google Ads.

Đang tải hình ảnh lên

Bạn có thể tải hình ảnh lên bằng lớp ImageBuilder. Lớp này sẽ lấy tên và dữ liệu hình ảnh. Dữ liệu được cung cấp dưới dạng đối tượng trao đổi dữ liệu Blob mà các dịch vụ như Drive hoặc tìm nạp URL có thể tạo.

Đoạn mã sau đây cho biết cách tải hình ảnh lên từ một URL bên ngoài:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Ngoài ra, bạn có thể tải blob hình ảnh từ Google Drive:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Tải các gói phương tiện lên

Gói phương tiện là tệp lưu trữ ZIP chứa các thành phần HTML5. Bạn có thể sử dụng các thành phần này để tạo quảng cáo HTML5. Tải gói nội dung nghe nhìn lên bằng lớp MediaBundleBuilder. Lớp này sẽ lấy tên và dữ liệu tệp. Cũng như hình ảnh, dữ liệu được cung cấp dưới dạng đối tượng trao đổi dữ liệu Blob.

Đoạn mã sau đây cho biết cách tải một gói nội dung đa phương tiện lên từ một URL bên ngoài:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Truy vấn nội dung nghe nhìn

Bạn có thể truy vấn nội dung nghe nhìn thuộc mọi loại trong tập lệnh Google Ads bằng cách sử dụng MediaSelector. Sử dụng thuộc tính withCondition() để lọc nội dung nghe nhìn theo tên, loại hoặc các trường khác. Ví dụ: đoạn mã sau đây tìm tất cả hình ảnh trong một tài khoản:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

Tạo quảng cáo có nội dung nghe nhìn

Hãy xem bài viết về quảng cáo để biết một số ví dụ về mã tạo quảng cáo được hỗ trợ có nội dung nghe nhìn đính kèm.