Interface NonceManager

จัดการ Nonce และการรายงานเหตุการณ์สำหรับการเล่นเนื้อหาครั้งเดียว หากต้องการเปิดใช้ การสร้างรายได้อัตโนมัติ ให้เรียกใช้เมธอดวงจรการเล่นเนื้อหาต่อไปนี้:
  • sendAdClick
  • sendAdTouch
  • sendPlaybackStart
  • sendPlaybackEnd
เมธอด
getNonce
sendAdClick
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่ามีการคลิกผ่านโฆษณาเกิดขึ้นระหว่างการ เล่นเนื้อหาครั้งที่กำหนด
sendAdImpression
เลิกใช้งานแล้ว แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าคุณกำลังแสดงเฟรมแรก ของโฆษณา
sendAdTouch
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าผู้ใช้แตะหรือคลิกโฆษณา เช่น ข้าม, ปิดเสียง และแตะ ระหว่างการเล่นเนื้อหาครั้งที่กำหนด
sendPlaybackEnd
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าการเล่นเนื้อหาครั้งที่กำหนดสิ้นสุดลงแล้ว
sendPlaybackStart
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าการเล่นเนื้อหาครั้งที่กำหนดเริ่มต้นขึ้นแล้ว

เมธอด


getNonce

getNonce(): string
แสดงผล
string Nonce ที่สร้างขึ้นสำหรับผู้จัดการรายนี้ ค่านี้จะไม่เปลี่ยนแปลงสำหรับอินสแตนซ์ NonceManager ที่กำหนด ค่า Nonce นี้ใช้ได้สำหรับการเล่นเนื้อหาครั้งเดียวเท่านั้น โดยมีระยะเวลาสูงสุด 6 ชั่วโมง

sendAdClick

sendAdClick(): void
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่ามีการคลิกผ่านโฆษณาเกิดขึ้นระหว่างการเล่นเนื้อหาครั้งที่กำหนด

sendAdImpression

sendAdImpression(): void
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าคุณกำลังแสดงเฟรมแรกของโฆษณา โฆษณานี้ คือโฆษณาที่คุณขอโดยใช้ Nonce ที่อินสแตนซ์NonceManagerนี้ สร้างขึ้น

sendAdTouch

sendAdTouch(clickOrTouchEvent: MouseEvent | TouchEvent): void
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าผู้ใช้แตะหรือคลิกโฆษณา เช่น ข้าม, ปิดเสียง และแตะ ระหว่างการเล่นเนื้อหาครั้งที่กำหนด การโต้ตอบกับโฆษณานี้แตกต่างจากการคลิกผ่าน ซึ่งผู้ใช้จะคลิกโฆษณาเพื่อไปยังเว็บไซต์ของผู้ลงโฆษณา
พารามิเตอร์
clickOrTouchEvent: MouseEvent | TouchEvent เหตุการณ์การแตะหรือกิจกรรมการคลิกของเบราว์เซอร์ตามการโต้ตอบของผู้ใช้ด้วยการแตะและคลิก

sendPlaybackEnd

sendPlaybackEnd(): void
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าการเล่นเนื้อหาครั้งที่กำหนดสิ้นสุดลงแล้ว เรียกใช้เมธอดนี้เมื่อการเล่นสิ้นสุดลง รายการต่อไปนี้แสดงรายละเอียดตัวอย่างของการเล่นที่สิ้นสุดลง
  • เพลเยอร์เล่นถึงจุดสิ้นสุดของสตรีม
  • ผู้ใช้ออกจากระบบการเล่นกลางคัน
  • ผู้ใช้ออกจากหน้าเว็บ
  • เมื่อเลื่อนไปยังรายการเนื้อหาถัดไปในการตั้งค่าเพลย์ลิสต์
เมธอดนี้จะสิ้นสุดการเรียกใช้แบบอะซิงโครนัสไปยังเซิร์ฟเวอร์ของ Google

sendPlaybackStart

sendPlaybackStart(): void
แจ้งให้เซิร์ฟเวอร์โฆษณาของ Google ทราบว่าการเล่นเนื้อหาครั้งที่กำหนดเริ่มต้นขึ้นแล้ว เรียกใช้เมธอดนี้เมื่อวิดีโอเพลเยอร์เริ่มเล่น เรียกใช้เมธอดนี้เพื่อตอบสนองต่อการดำเนินการที่ ผู้ใช้เริ่มต้น เช่น คลิกเพื่อเล่น หรือการดำเนินการที่หน้าเว็บเริ่มต้น เช่น เล่นอัตโนมัติ

เมธอดนี้จะเริ่มการเรียกใช้แบบอะซิงโครนัสไปยังเซิร์ฟเวอร์ของ Google และ รวบรวมสัญญาณที่จำเป็นสำหรับการตรวจสอบและการตรวจหาการเข้าชมที่ไม่ถูกต้อง (IVT)