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 thành phần nội dung nghe nhì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 cách sử dụng lớp ImageBuilder. Lớp này sẽ lấy tên và dữ liệu hình ảnh. Dữ liệu này đượ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 ra.

Đ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 tài sản HTML5 mà bạn có thể dùng để tạo quảng cáo HTML5. Tải các gói phương tiện lên bằng lớp MediaBundleBuilder. Lớp này sẽ lấy tên và dữ liệu tệp. Giố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 gói 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 mọi loại nội dung nghe nhìn 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 sẽ tìm tất cả cá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 bằng nội dung nghe nhìn

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