Loại: AdsRequest

google.ima.AdsRequest

class   public   static

Một lớp chỉ định các thuộc tính của yêu cầu quảng cáo.

Hàm dựng

Yêu cầu quảng cáo

new AdsRequest()

Triển khai

google.ima.AdsRequestInterface

Thuộc tính

Url thẻ quảng cáo

chuỗi

Chỉ định url thẻ quảng cáo được yêu cầu từ máy chủ quảng cáo. Để biết chi tiết về cách tạo URL thẻ quảng cáo, hãy xem bài viết Tạo thẻ video quảng cáo chính theo cách thủ công.

Đây là tham số bắt buộc.

Phản hồi quảng cáo

(Tài liệu rỗng, chuỗi hoặc không rỗng)

Chỉ định tài liệu VAST 2.0 sẽ được dùng làm phản hồi quảng cáo thay vì đưa ra yêu cầu thông qua url thẻ quảng cáo. Cách này có thể hữu ích khi gỡ lỗi và các tình huống khác mà phản hồi VAST đã có sẵn.

Đây là thông số không bắt buộc.

Thời lượng nội dung

(trống hoặc số)

Chỉ định thời lượng nội dung tính bằng giây sẽ hiển thị. Phương thức này được sử dụng trong 2 trường hợp: 1) Nhắm mục tiêu quảng cáo AdX và 2) quyết định thời điểm tải trước VMAP.

Thông số này không bắt buộc.

contentKeywords

(Mảng chuỗi rỗng hoặc không rỗng)

Chỉ định từ khóa được sử dụng để mô tả nội dung sẽ hiển thị. Được sử dụng trong yêu cầu AdX.

Thông số này không bắt buộc.

tiêu đề nội dung

(rỗng hoặc chuỗi)

Chỉ định tiêu đề của nội dung sẽ được hiển thị. Được sử dụng trong yêu cầu AdX.

Thông số này không bắt buộc.

forceNonLinearFullSlot

boolean

Buộc quảng cáo AdSense phi tuyến tính hiển thị dưới dạng toàn thời gian tuyến tính. Nếu được đặt, video nội dung sẽ bị tạm dừng và quảng cáo văn bản hoặc quảng cáo hình ảnh phi tuyến tính sẽ được hiển thị dưới dạng toàn thời gian. Video nội dung sẽ tiếp tục ngay sau khi người xem bỏ qua hoặc đóng quảng cáo.

Chiều cao vùng quảng cáo tuyến tính

số

Chỉ định chiều cao của khu vực hình chữ nhật nơi quảng cáo tuyến tính được hiển thị. Giá trị này được sử dụng làm một trong các tiêu chí để lựa chọn quảng cáo. Giá trị này không cần phải phù hợp với chiều cao quảng cáo thực tế.

Bạn phải sử dụng tham số này.

Chiều rộng vùng quảng cáo tuyến tính

số

Chỉ định chiều rộng của khu vực hình chữ nhật nơi quảng cáo tuyến tính được hiển thị. Giá trị này được sử dụng làm một trong các tiêu chí để lựa chọn quảng cáo. Giá trị này không cần phải khớp với chiều rộng của quảng cáo thực tế.

Đây là tham số bắt buộc.

liveStreamPrefetchSeconds

số

Chỉ định thời gian chờ tối đa tính bằng giây, sau khi gọi requestAds, trước khi yêu cầu URL thẻ quảng cáo. Bạn có thể sử dụng tính năng này để sắp xếp các yêu cầu trong một sự kiện phát trực tiếp để giảm thiểu mức tăng đột biến về số lượng yêu cầu.

Chiều cao vùng quảng cáo không tuyến tính

số

Chỉ định chiều cao của khu vực hình chữ nhật nơi quảng cáo phi tuyến tính được hiển thị. Giá trị này được dùng làm một trong các tiêu chí để lựa chọn quảng cáo. Giá trị này không cần phải phù hợp với chiều cao quảng cáo thực tế.

Bạn bắt buộc phải sử dụng tham số này.

NonLinearAdSlotWidth

số

Chỉ định chiều rộng của khu vực hình chữ nhật nơi quảng cáo phi tuyến tính được hiển thị. Giá trị này được dùng làm một trong các tiêu chí để lựa chọn quảng cáo. Giá trị này không cần phải khớp với chiều rộng của quảng cáo thực tế.

Bạn bắt buộc phải sử dụng tham số này.

omidAccessModeRules

Đối tượng khác rỗng có thuộc tính chuỗi

Đối tượng Cài đặt để liên kết các nhà cung cấp dịch vụ xác minh với Chế độ truy cập OMID. Khóa phải là giá trị trong google.ima.OmidVerificationProvider và phải là giá trị trong google.ima.OmidAccessMode.

URL tập lệnh xác minh được so khớp nội bộ với các biểu thức chính quy do nhà cung cấp cung cấp để phân giải thành khóa OmidVerificationProvider. Sau đó, IMA sẽ tra cứu chế độ truy cập cho nhà cung cấp đã cho bằng cách sử dụng đối tượng này.

Đối với các URL tập lệnh không phân giải được với một nhà cung cấp đã biết hoặc nếu nhà cung cấp OmidVerification đã giải quyết không được cung cấp trong đối tượng này, IMA sẽ sử dụng chế độ truy cập được cung cấp cho OmidVerificationProvider.OTHER. Nếu bạn không cung cấp thông tin về Nhà cung cấp OmidVerification.OTHER, thì chế độ truy cập LIMITED sẽ được sử dụng.

Url trang

(rỗng hoặc chuỗi)

Xác định url đầy đủ của trang sẽ được đưa vào yêu cầu quảng cáo Google để nhắm mục tiêu. Url cần phải là một url hợp lệ. Nếu được chỉ định, giá trị này sẽ được dùng cho macro VAST [PAGEURL].

Thông số này không bắt buộc.

vastLoadTimeout

số

Ghi đè thời gian chờ tải VAST mặc định tính bằng mili giây cho một trình bao bọc duy nhất. Thời gian chờ mặc định là 5000 mili giây.

Thông số này không bắt buộc.

Phương thức

setAdWillAutoPlay

setAdWillAutoPlay(autoPlay) trả về không hợp lệ

Thông báo cho SDK xem liệu trình phát có ý định bắt đầu nội dung và quảng cáo để phản hồi cho một hành động của người dùng hay không hoặc liệu trò chơi có được tự động phát hay không. Việc thay đổi tùy chọn cài đặt này sẽ không ảnh hưởng đến việc phát quảng cáo.

Thông số
tự động phát	boolean Liệu nội dung và quảng cáo có được tự động phát hay không hoặc liệu quá trình sẽ bắt đầu bằng hành động của người dùng.

Trả về

void 

setAdWillPlayMute

setAdWillPlayMute(bị bỏ qua) trả về không có hiệu lực

Thông báo cho SDK xem trình phát có định bắt đầu quảng cáo trong khi bị tắt tiếng hay không. Việc thay đổi tùy chọn cài đặt này sẽ không ảnh hưởng đến việc phát quảng cáo, nhưng sẽ gửi tín hiệu thích hợp trong yêu cầu quảng cáo để cho phép người mua đặt giá thầu trên khoảng không quảng cáo đã ẩn.

Thông số
đã tắt tiếng	boolean Liệu quảng cáo có được phát trong khi bị tắt tiếng hay không.

Trả về

void 

Đặt phát lại liên tục

set Liên chế phát(liên tục Phát) trả về

Thông báo cho SDK xem trình phát có ý định liên tục phát lần lượt các video nội dung tương tự như chương trình phát sóng trên TV hay không. Việc thay đổi tùy chọn cài đặt này sẽ không ảnh hưởng đến việc phát quảng cáo, nhưng sẽ gửi tín hiệu thích hợp trong yêu cầu quảng cáo này để cho phép người mua đặt giá thầu cho loại khoảng không quảng cáo.

Thông số
Phát liên tục	boolean Liệu video nội dung có được phát lần lượt không.

Trả về

void