google. ima. AdEvent
Loại sự kiện này được quảng cáo đưa ra dưới dạng thông báo khi trạng thái quảng cáo thay đổi và khi người dùng tương tác với quảng cáo. Ví dụ: thời điểm quảng cáo bắt đầu phát, lượt nhấp vào quảng cáo và nhiều thông tin khác. Bạn có thể đăng ký các sự kiện đã thay đổi trạng thái trên AdsManager.
Bảng liệt kê
Loại
chuỗi
Các loại sự kiện quảng cáo
Giá trị |
|
---|---|
QUẢNG CÁO_CHƠI |
Kích hoạt khi quảng cáo sẵn sàng phát mà không cần lưu vào bộ đệm, ở đầu quảng cáo hoặc sau khi lưu vào bộ đệm hoàn tất. |
CONTENT TẠM DỪNG_YÊU CẦU |
Kích hoạt khi tạm dừng nội dung. Việc này thường xảy ra ngay trước khi quảng cáo sắp trình chiếu nội dung. |
NỘI DUNG_YÊU CẦU_YÊU CẦU |
Kích hoạt khi nội dung cần được tiếp tục. Điều này thường xảy ra khi quảng cáo kết thúc hoặc thu gọn. |
LƯỢT NHẤP |
Kích hoạt khi người dùng nhấp vào quảng cáo. |
VIDEO_NHẤP |
Kích hoạt khi người dùng nhấp vào phần không thể nhấp của quảng cáo dạng video. |
VIDEO_ICON_CLICKED ( VIDEO) |
Kích hoạt khi người dùng nhấp vào biểu tượng video. |
ĐÃ BẮT ĐẦU |
Kích hoạt khi quảng cáo bắt đầu phát. |
TRẠNG THÁI QUẢNG CÁO |
Kích hoạt khi giá trị thời gian hiện tại của quảng cáo thay đổi. Việc gọi getAdData() trên sự kiện này sẽ trả về đối tượng AdProgressData. |
QUẢNG CÁO |
Kích hoạt khi quảng cáo đã trì hoãn việc phát đến vùng đệm. |
LƯỢT HIỂN THỊ |
Kích hoạt khi URL hiển thị đã được ping. |
ĐÃ TẠM DỪNG |
Kích hoạt khi quảng cáo bị tạm dừng. |
ĐÃ TIẾP TỤC |
Kích hoạt khi quảng cáo được tiếp tục. |
QUẦN DỊCH ĐẦU TIÊN |
Kích hoạt khi con trỏ quảng cáo vượt qua phần tư đầu tiên. |
TRUNG BÌNH |
Kích hoạt khi con trỏ quảng cáo chạy qua điểm giữa. |
QUẦN THỨ 3 |
Kích hoạt khi con trỏ quảng cáo vượt qua phần tư thứ ba. |
HOÀN TẤT |
Kích hoạt khi quảng cáo phát hết thời lượng. |
THỜI LƯỢNG_THAY ĐỔI |
Kích hoạt khi thời lượng quảng cáo thay đổi. |
NGƯỜI_KHOÁ |
Kích hoạt khi người dùng tắt quảng cáo. |
ĐÃ TẢI |
Kích hoạt khi có dữ liệu quảng cáo. |
TẤT CẢ_ĐÃ_HOÀN TẤT |
Kích hoạt khi trình quản lý quảng cáo phát xong tất cả quảng cáo hợp lệ trong nội dung phản hồi quảng cáo hoặc khi nội dung phản hồi không trả về bất kỳ quảng cáo hợp lệ nào. |
ĐÃ BỎ QUA |
Kích hoạt khi người dùng bỏ qua quảng cáo. |
LINEAR_Changed |
Kích hoạt khi quảng cáo hiển thị thay đổi từ tuyến tính sang phi tuyến tính hoặc đảo ngược. |
SKIPPABLE_STATE_Changed |
Kích hoạt khi trạng thái có thể bỏ qua của quảng cáo hiển thị thay đổi. |
DỮ LIỆU QUẢNG CÁO |
Kích hoạt khi danh sách quảng cáo được tải. |
QUẢNG CÁO_SẴN SÀNG |
Kích hoạt khi quy tắc quảng cáo hoặc điểm chèn quảng cáo VMAP sẽ phát nếu tự động PlayAdBreaks là false. |
ĐĂNG NHẬP |
Kích hoạt khi gặp lỗi không nghiêm trọng. Người dùng không cần làm gì cả vì SDK sẽ tiếp tục phát cùng một quảng cáo hoặc phát quảng cáo tiếp theo tuỳ thuộc vào tình huống lỗi. |
VOLUME_Changed |
Kích hoạt khi số lượng quảng cáo thay đổi. |
sang ẮT_TẮT |
Kích hoạt khi số lượng quảng cáo bị tắt tiếng. |
TƯƠNG TÁC |
Kích hoạt khi quảng cáo kích hoạt lệnh gọi lại tương tác. Hoạt động tương tác với quảng cáo chứa một chuỗi mã tương tác trong dữ liệu quảng cáo. |
Thuộc tính
Loại
chuỗi
Các loại sự kiện quảng cáo
Giá trị |
|
---|---|
QUẢNG CÁO_CHƠI |
Kích hoạt khi quảng cáo sẵn sàng phát mà không cần lưu vào bộ đệm, ở đầu quảng cáo hoặc sau khi lưu vào bộ đệm hoàn tất. |
CONTENT TẠM DỪNG_YÊU CẦU |
Kích hoạt khi tạm dừng nội dung. Việc này thường xảy ra ngay trước khi quảng cáo sắp trình chiếu nội dung. |
NỘI DUNG_YÊU CẦU_YÊU CẦU |
Kích hoạt khi nội dung cần được tiếp tục. Điều này thường xảy ra khi quảng cáo kết thúc hoặc thu gọn. |
LƯỢT NHẤP |
Kích hoạt khi người dùng nhấp vào quảng cáo. |
VIDEO_NHẤP |
Kích hoạt khi người dùng nhấp vào phần không thể nhấp của quảng cáo dạng video. |
VIDEO_ICON_CLICKED ( VIDEO) |
Kích hoạt khi người dùng nhấp vào biểu tượng video. |
ĐÃ BẮT ĐẦU |
Kích hoạt khi quảng cáo bắt đầu phát. |
TRẠNG THÁI QUẢNG CÁO |
Kích hoạt khi giá trị thời gian hiện tại của quảng cáo thay đổi. Việc gọi getAdData() trên sự kiện này sẽ trả về đối tượng AdProgressData. |
QUẢNG CÁO |
Kích hoạt khi quảng cáo đã trì hoãn việc phát đến vùng đệm. |
LƯỢT HIỂN THỊ |
Kích hoạt khi URL hiển thị đã được ping. |
ĐÃ TẠM DỪNG |
Kích hoạt khi quảng cáo bị tạm dừng. |
ĐÃ TIẾP TỤC |
Kích hoạt khi quảng cáo được tiếp tục. |
QUẦN DỊCH ĐẦU TIÊN |
Kích hoạt khi con trỏ quảng cáo vượt qua phần tư đầu tiên. |
TRUNG BÌNH |
Kích hoạt khi con trỏ quảng cáo chạy qua điểm giữa. |
QUẦN THỨ 3 |
Kích hoạt khi con trỏ quảng cáo vượt qua phần tư thứ ba. |
HOÀN TẤT |
Kích hoạt khi quảng cáo phát hết thời lượng. |
THỜI LƯỢNG_THAY ĐỔI |
Kích hoạt khi thời lượng quảng cáo thay đổi. |
NGƯỜI_KHOÁ |
Kích hoạt khi người dùng tắt quảng cáo. |
ĐÃ TẢI |
Kích hoạt khi có dữ liệu quảng cáo. |
TẤT CẢ_ĐÃ_HOÀN TẤT |
Kích hoạt khi trình quản lý quảng cáo phát xong tất cả quảng cáo hợp lệ trong nội dung phản hồi quảng cáo hoặc khi nội dung phản hồi không trả về bất kỳ quảng cáo hợp lệ nào. |
ĐÃ BỎ QUA |
Kích hoạt khi người dùng bỏ qua quảng cáo. |
LINEAR_Changed |
Kích hoạt khi quảng cáo hiển thị thay đổi từ tuyến tính sang phi tuyến tính hoặc đảo ngược. |
SKIPPABLE_STATE_Changed |
Kích hoạt khi trạng thái có thể bỏ qua của quảng cáo hiển thị thay đổi. |
DỮ LIỆU QUẢNG CÁO |
Kích hoạt khi danh sách quảng cáo được tải. |
QUẢNG CÁO_SẴN SÀNG |
Kích hoạt khi quy tắc quảng cáo hoặc điểm chèn quảng cáo VMAP sẽ phát nếu tự động PlayAdBreaks là false. |
ĐĂNG NHẬP |
Kích hoạt khi gặp lỗi không nghiêm trọng. Người dùng không cần làm gì cả vì SDK sẽ tiếp tục phát cùng một quảng cáo hoặc phát quảng cáo tiếp theo tuỳ thuộc vào tình huống lỗi. |
VOLUME_Changed |
Kích hoạt khi số lượng quảng cáo thay đổi. |
sang ẮT_TẮT |
Kích hoạt khi số lượng quảng cáo bị tắt tiếng. |
TƯƠNG TÁC |
Kích hoạt khi quảng cáo kích hoạt lệnh gọi lại tương tác. Hoạt động tương tác với quảng cáo chứa một chuỗi mã tương tác trong dữ liệu quảng cáo. |
Phương pháp
nhận quảng cáo
getAd() trả về Ad
Xem quảng cáo hiện tại đang phát hoặc vừa phát.
- Trả về
-
nullable Ad
Quảng cáo được liên kết với sự kiện này hoặc rỗng nếu không có quảng cáo liên quan.
getAdData
getAdData() trả về Đối tượng
Cho phép truyền thêm dữ liệu từ quảng cáo.
Ví dụ:
if (event.type == google.ima.AdEvent.Type.LOG) {
let adData = event.getAdData();
if (adData['adError']) {
console.log('Non-fatal error occurred: ' +
adData['adError'].getMessage());
}
}
- Trả về
-
nullable Object
Dữ liệu bổ sung cho sự kiện. Ghi lại các sự kiện lỗi mang đối tượng thuộc loại 'google.ima.AdError', có thể truy cập bằng khoá 'adError'.