คลาส: AdEvent

google.imaAdEvent

class คงที่

เหตุการณ์นี้จะเพิ่มโดยใช้โฆษณาเป็นการแจ้งเตือนเมื่อสถานะโฆษณามีการเปลี่ยนแปลงและเมื่อผู้ใช้โต้ตอบกับโฆษณา เช่น เมื่อโฆษณาเริ่มเล่น มีการคลิก และอื่นๆ คุณจะลงทะเบียนเข้าร่วมกิจกรรมต่างๆ ที่มีการเปลี่ยนแปลงสถานะได้ใน AdsManager

การแจกแจง

ประเภท

คงที่

สตริง

ประเภทของเหตุการณ์โฆษณา

ค่า
AD_CAN_PLAY	เริ่มทํางานเมื่อโฆษณาพร้อมเล่นโดยไม่มีการบัฟเฟอร์ ไม่ว่าจะตอนเริ่มต้นของโฆษณาหรือหลังการบัฟเฟอร์เสร็จสมบูรณ์แล้ว
คําขอเนื้อหาหยุดชั่วคราว	เริ่มทํางานเมื่อควรหยุดเนื้อหาชั่วคราว กรณีนี้มักเกิดขึ้นก่อนที่โฆษณาจะครอบคลุมเนื้อหา
ส่งคําขอเนื้อหาแล้ว	เริ่มทํางานเมื่อเนื้อหาควรกลับมาทํางานอีกครั้ง ซึ่งมักเกิดขึ้นเมื่อโฆษณาเล่นจบหรือยุบ
คลิก	เริ่มทํางานเมื่อมีผู้คลิกโฆษณา
คลิกวิดีโอแล้ว	เริ่มทํางานเมื่อมีการคลิกส่วนที่ไม่ใช่การคลิกผ่านของโฆษณาวิดีโอ
คลิกไอคอนวิดีโอแล้ว	เริ่มทํางานเมื่อผู้ใช้คลิกไอคอนวิดีโอ
เริ่มต้นแล้ว	เริ่มทํางานเมื่อโฆษณาเริ่มเล่น
ความคืบหน้า	เริ่มทํางานเมื่อค่าเวลาปัจจุบันของโฆษณามีการเปลี่ยนแปลง การเรียก getAdData() ในเหตุการณ์นี้จะแสดงผลออบเจ็กต์ AdProgressData
การบัฟเฟอร์โฆษณา	เริ่มทํางานเมื่อโฆษณาหยุดเล่นบัฟเฟอร์
การแสดงผล	เริ่มทํางานเมื่อใช้คําสั่ง ping กับ URL การแสดงผล
หยุดชั่วคราว	เริ่มทํางานเมื่อโฆษณาหยุดชั่วคราว
เชื่อมต่ออีกครั้งแล้ว	เริ่มทํางานเมื่อโฆษณากลับมาทํางานอีกครั้ง
อันดับแรก - ควอเตอร์	เริ่มทํางานเมื่อส่วนหัวของโฆษณาเล่นข้ามควอร์ไทล์แรก
ตอนกลาง	เริ่มทํางานเมื่อส่วนหัวของตัวควบคุมการเล่นโฆษณาข้ามจุดกึ่งกลาง
สามส่วน	เริ่มทํางานเมื่อส่วนหัวของโฆษณาเล่นข้ามควอร์ไทล์ที่ 3
เสร็จสมบูรณ์	เริ่มทํางานเมื่อโฆษณาเล่นจบ
การเปลี่ยนแปลงระยะเวลา	เริ่มทํางานเมื่อระยะเวลาของโฆษณามีการเปลี่ยนแปลง
ผู้ใช้_ปิด	เริ่มทํางานเมื่อผู้ใช้ปิดโฆษณา
โหลดแล้ว	เริ่มทํางานเมื่อมีข้อมูลโฆษณา
โฆษณาทั้งหมดเสร็จสมบูรณ์	เริ่มทํางานเมื่อตัวจัดการโฆษณาเล่นโฆษณาที่ถูกต้องทั้งหมดในการตอบสนองของโฆษณา หรือเมื่อการตอบสนองไม่แสดงโฆษณาที่ถูกต้อง
ข้าม	เริ่มทํางานเมื่อผู้ใช้ข้ามโฆษณา
บรรทัดมีการเปลี่ยนแปลง	เริ่มทํางานเมื่อโฆษณาที่แสดงอยู่เปลี่ยนจากเชิงเส้นเป็นไม่ใช่เชิงเส้น หรือย้อนกลับ
ข้ามสถานะของรัฐ	เริ่มทํางานเมื่อสถานะโฆษณาแบบข้ามได้ของโฆษณามีการเปลี่ยนแปลง
AD_METADATA	เริ่มทํางานเมื่อโหลดรายการโฆษณา
AD_BREAK_READY	เริ่มทํางานเมื่อกฎโฆษณาหรือช่วงพักโฆษณา VMAP จะเล่นหาก AutoPlayAdBreaks เป็นเท็จ
บันทึก	เริ่มทํางานเมื่อพบข้อผิดพลาดที่ไม่ร้ายแรง ผู้ใช้ไม่ต้องดําเนินการใดๆ เนื่องจาก SDK จะเล่นโฆษณาเดียวกันหรือรายการถัดไปต่อไป ทั้งนี้ขึ้นอยู่กับสถานการณ์ข้อผิดพลาด
มีการเปลี่ยนแปลง	เริ่มทํางานเมื่อปริมาณโฆษณามีการเปลี่ยนแปลง
ปิดเสียง	เริ่มทํางานเมื่อปิดเสียงโฆษณาแล้ว
การโต้ตอบ	เริ่มทํางานเมื่อโฆษณาทริกเกอร์การเรียกกลับการโต้ตอบ การโต้ตอบกับโฆษณามีสตริงรหัสการโต้ตอบในข้อมูลโฆษณา

พร็อพเพอร์ตี้

ประเภท

คงที่

สตริง

ประเภทของเหตุการณ์โฆษณา

ค่า
AD_CAN_PLAY	เริ่มทํางานเมื่อโฆษณาพร้อมเล่นโดยไม่มีการบัฟเฟอร์ ไม่ว่าจะตอนเริ่มต้นของโฆษณาหรือหลังการบัฟเฟอร์เสร็จสมบูรณ์แล้ว
คําขอเนื้อหาหยุดชั่วคราว	เริ่มทํางานเมื่อควรหยุดเนื้อหาชั่วคราว กรณีนี้มักเกิดขึ้นก่อนที่โฆษณาจะครอบคลุมเนื้อหา
ส่งคําขอเนื้อหาแล้ว	เริ่มทํางานเมื่อเนื้อหาควรกลับมาทํางานอีกครั้ง ซึ่งมักเกิดขึ้นเมื่อโฆษณาเล่นจบหรือยุบ
คลิก	เริ่มทํางานเมื่อมีผู้คลิกโฆษณา
คลิกวิดีโอแล้ว	เริ่มทํางานเมื่อมีการคลิกส่วนที่ไม่ใช่การคลิกผ่านของโฆษณาวิดีโอ
คลิกไอคอนวิดีโอแล้ว	เริ่มทํางานเมื่อผู้ใช้คลิกไอคอนวิดีโอ
เริ่มต้นแล้ว	เริ่มทํางานเมื่อโฆษณาเริ่มเล่น
ความคืบหน้า	เริ่มทํางานเมื่อค่าเวลาปัจจุบันของโฆษณามีการเปลี่ยนแปลง การเรียก getAdData() ในเหตุการณ์นี้จะแสดงผลออบเจ็กต์ AdProgressData
การบัฟเฟอร์โฆษณา	เริ่มทํางานเมื่อโฆษณาหยุดเล่นบัฟเฟอร์
การแสดงผล	เริ่มทํางานเมื่อใช้คําสั่ง ping กับ URL การแสดงผล
หยุดชั่วคราว	เริ่มทํางานเมื่อโฆษณาหยุดชั่วคราว
เชื่อมต่ออีกครั้งแล้ว	เริ่มทํางานเมื่อโฆษณากลับมาทํางานอีกครั้ง
อันดับแรก - ควอเตอร์	เริ่มทํางานเมื่อส่วนหัวของโฆษณาเล่นข้ามควอร์ไทล์แรก
ตอนกลาง	เริ่มทํางานเมื่อส่วนหัวของตัวควบคุมการเล่นโฆษณาข้ามจุดกึ่งกลาง
สามส่วน	เริ่มทํางานเมื่อส่วนหัวของโฆษณาเล่นข้ามควอร์ไทล์ที่ 3
เสร็จสมบูรณ์	เริ่มทํางานเมื่อโฆษณาเล่นจบ
การเปลี่ยนแปลงระยะเวลา	เริ่มทํางานเมื่อระยะเวลาของโฆษณามีการเปลี่ยนแปลง
ผู้ใช้_ปิด	เริ่มทํางานเมื่อผู้ใช้ปิดโฆษณา
โหลดแล้ว	เริ่มทํางานเมื่อมีข้อมูลโฆษณา
โฆษณาทั้งหมดเสร็จสมบูรณ์	เริ่มทํางานเมื่อตัวจัดการโฆษณาเล่นโฆษณาที่ถูกต้องทั้งหมดในการตอบสนองของโฆษณา หรือเมื่อการตอบสนองไม่แสดงโฆษณาที่ถูกต้อง
ข้าม	เริ่มทํางานเมื่อผู้ใช้ข้ามโฆษณา
บรรทัดมีการเปลี่ยนแปลง	เริ่มทํางานเมื่อโฆษณาที่แสดงอยู่เปลี่ยนจากเชิงเส้นเป็นไม่ใช่เชิงเส้น หรือย้อนกลับ
ข้ามสถานะของรัฐ	เริ่มทํางานเมื่อสถานะโฆษณาแบบข้ามได้ของโฆษณามีการเปลี่ยนแปลง
AD_METADATA	เริ่มทํางานเมื่อโหลดรายการโฆษณา
AD_BREAK_READY	เริ่มทํางานเมื่อกฎโฆษณาหรือช่วงพักโฆษณา VMAP จะเล่นหาก AutoPlayAdBreaks เป็นเท็จ
บันทึก	เริ่มทํางานเมื่อพบข้อผิดพลาดที่ไม่ร้ายแรง ผู้ใช้ไม่ต้องดําเนินการใดๆ เนื่องจาก SDK จะเล่นโฆษณาเดียวกันหรือรายการถัดไปต่อไป ทั้งนี้ขึ้นอยู่กับสถานการณ์ข้อผิดพลาด
มีการเปลี่ยนแปลง	เริ่มทํางานเมื่อปริมาณโฆษณามีการเปลี่ยนแปลง
ปิดเสียง	เริ่มทํางานเมื่อปิดเสียงโฆษณาแล้ว
การโต้ตอบ	เริ่มทํางานเมื่อโฆษณาทริกเกอร์การเรียกกลับการโต้ตอบ การโต้ตอบกับโฆษณามีสตริงรหัสการโต้ตอบในข้อมูลโฆษณา

วิธีการ

รับโฆษณา

getAd() แสดงโฆษณา

ดูโฆษณาปัจจุบันที่เล่นหรือเพิ่งเล่น

การคืนสินค้า

nullable Ad โฆษณาที่เชื่อมโยงกับเหตุการณ์ หรือเป็นค่าว่างหากไม่มีโฆษณาที่เกี่ยวข้อง

รับข้อมูลโฆษณา

getAdData() แสดงผลออบเจ็กต์

อนุญาตให้ส่งข้อมูลเพิ่มเติมจากโฆษณา

ตัวอย่าง

if (event.type == google.ima.AdEvent.Type.LOG) {
  let adData = event.getAdData();
  if (adData['adError']) {
    console.log('Non-fatal error occurred: ' +
        adData['adError'].getMessage());
  }
}

การคืนสินค้า

nullable Object ข้อมูลเพิ่มเติมสําหรับเหตุการณ์ เหตุการณ์บันทึกที่ยกขึ้นมาสําหรับข้อผิดพลาดจะมีออบเจ็กต์ประเภท "google.ima.AdError" ซึ่งเข้าถึงได้โดยใช้คีย์ "adError"