IMA SDK ช่วยให้ผสานรวมโฆษณามัลติมีเดียเข้ากับเว็บไซต์และแอปได้อย่างง่ายดาย IMA SDK สามารถ ขอโฆษณาจากเซิร์ฟเวอร์โฆษณา ที่รองรับ VAST และจัดการการเล่นโฆษณาในแอปของคุณ เมื่อใช้ IMA DAI SDK แอปจะส่ง คำขอสตรีมสำหรับโฆษณาและเนื้อหาวิดีโอ ไม่ว่าจะเป็นเนื้อหา VOD หรือเนื้อหาแบบสด จากนั้น SDK จะแสดงสตรีมวิดีโอที่รวมกัน เพื่อให้คุณไม่ต้องจัดการการสลับระหว่างโฆษณาและวิดีโอเนื้อหาภายในแอป
เลือกโซลูชัน DAI ที่คุณสนใจ
DAI Pod Serving
คู่มือนี้ครอบคลุมการผสานรวม IMA DAI SDK เข้ากับแอปวิดีโอ เพลเยอร์ หากต้องการดูหรือทำตามตัวอย่างการผสานรวมที่เสร็จสมบูรณ์แล้ว ให้ดาวน์โหลด PodServingExample จาก GitHub
ภาพรวม IMA DAI
การติดตั้งใช้งาน IMA DAI เกี่ยวข้องกับคอมโพเนนต์ SDK หลัก 4 อย่างตามที่คู่มือนี้ แสดงให้เห็น
IMAAdDisplayContainer– ออบเจ็กต์คอนเทนเนอร์ที่อยู่เหนือองค์ประกอบการเล่นวิดีโอและมีองค์ประกอบ UI ของโฆษณาIMAAdsLoader– ออบเจ็กต์ที่ขอสตรีมและจัดการเหตุการณ์ที่ทริกเกอร์โดยออบเจ็กต์การตอบกลับคำขอสตรีม คุณควรสร้างอินสแตนซ์ของ AdsLoader เพียงรายการเดียว ซึ่งสามารถนำกลับมาใช้ใหม่ได้ตลอดอายุการใช้งานของแอปพลิเคชันIMAStreamRequest–IMAPodVODStreamRequestหรือIMAPodStreamRequestIMAStreamManager– ออบเจ็กต์ที่จัดการสตรีมการแทรกโฆษณาแบบไดนามิกและการโต้ตอบกับแบ็กเอนด์ DAI Stream Manager ยังจัดการ Pings การติดตามและส่งต่อเหตุการณ์สตรีมและโฆษณาไปยัง ผู้เผยแพร่โฆษณาด้วย
นอกจากนี้ หากต้องการเล่นสตรีมที่แสดงพ็อด ให้ใช้ตัวแฮนเดิล VTP ที่กำหนดเอง ตัวแฮนเดิล VTP ที่กำหนดเองนี้จะส่งรหัสสตรีม ไปยังพาร์ทเนอร์ด้านเทคนิคของวิดีโอ (VTP) พร้อมกับข้อมูลอื่นๆ ที่ จำเป็นต่อการแสดงไฟล์ Manifest ของสตรีมที่มีทั้งเนื้อหาและโฆษณาที่เย็บ VTP ของคุณมีวิธีการติดตั้งใช้งานตัวแฮนเดิล VTP ที่กำหนดเอง
ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้น คุณต้องมีสิ่งต่อไปนี้
- Xcode 13 ขึ้นไป
- วิธีติดตั้ง IMA SDK
- Swift Package Manager (แนะนำ)
- สำเนาที่ดาวน์โหลดของ IMA SDK สำหรับ iOS
นอกจากนี้ คุณยังต้องใช้พารามิเตอร์เพื่อขอสตรีมจาก IMA SDK ด้วย
| พารามิเตอร์ไลฟ์สด | |
|---|---|
| รหัสเครือข่าย |
รหัสเครือข่ายสำหรับบัญชี Ad Manager 360 |
| คีย์เนื้อหาที่กำหนดเอง |
คีย์ชิ้นงานที่กำหนดเองซึ่งระบุเหตุการณ์การแสดงโฆษณาพอดใน Ad
Manager 360 ผู้จัดการไฟล์ Manifest หรือพาร์ทเนอร์ Pod Serving บุคคลที่สามเป็นผู้สร้างไฟล์นี้ |
| พารามิเตอร์สตรีม VOD | |
| รหัสเครือข่าย |
รหัสเครือข่ายสำหรับบัญชี Ad Manager 360 |
สร้างโปรเจ็กต์ Xcode ใหม่
ใน Xcode ให้สร้างโปรเจ็กต์ iOS ใหม่โดยใช้ Objective-C ชื่อ "PodServingExample"
เพิ่ม IMA DAI SDK ลงในโปรเจ็กต์ Xcode
หากต้องการติดตั้ง IMA SDK ให้เลือกวิธีที่ต้องการ
แนะนำ: ติดตั้ง SDK โดยใช้ Swift Package Manager
SDK โฆษณาสื่ออินเทอร์แอกทีฟรองรับ Swift Package Manager ตั้งแต่เวอร์ชัน 3.18.4 เป็นต้นไป ทำตาม ขั้นตอนเหล่านี้เพื่อนำเข้าแพ็กเกจ Swift
ใน Xcode ให้ติดตั้งแพ็กเกจ Swift ของ IMA DAI SDK โดยไปที่ ไฟล์ > เพิ่มแพ็กเกจ
ในพรอมต์ที่ปรากฏขึ้น ให้ค้นหาที่เก็บ IMA DAI SDK Swift Package GitHub
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosเลือกเวอร์ชันของแพ็กเกจ IMA DAI SDK Swift ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ ให้ใช้อัปเดตเป็นเวอร์ชันหลักถัดไป
เมื่อดำเนินการเสร็จแล้ว Xcode จะแก้ไขการขึ้นต่อกันของแพ็กเกจและดาวน์โหลดไว้ในเบื้องหลัง ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีเพิ่มการอ้างอิงแพ็กเกจได้ที่บทความของ Apple
ดาวน์โหลดและติดตั้ง SDK ด้วยตนเอง
หากไม่ต้องการใช้ Swift Package Manager ให้ดาวน์โหลดและเพิ่ม IMA SDK ลงในโปรเจ็กต์ด้วยตนเอง
สร้างวิดีโอเพลเยอร์
ใช้วิดีโอเพลเยอร์ในตัวควบคุมมุมมองหลัก และห่อหุ้ม AVPlayer ในมุมมอง UI IMA SDK ใช้มุมมอง UI เพื่อแสดงองค์ประกอบ UI ของโฆษณา
Objective-C
Swift
เริ่มต้นเครื่องมือโหลดโฆษณา
นำเข้า IMA SDK ไปยังตัวควบคุมมุมมองและใช้โปรโตคอล
IMAAdsLoaderDelegate
และ
IMAStreamManagerDelegate
เพื่อจัดการเหตุการณ์ของเครื่องมือโหลดโฆษณาและเครื่องมือจัดการสตรีม
เพิ่มพร็อพเพอร์ตี้ส่วนตัวต่อไปนี้เพื่อจัดเก็บคอมโพเนนต์หลักของ IMA SDK
IMAAdsLoader- จัดการคำขอสตรีมตลอดอายุการใช้งานของแอป
IMAAdDisplayContainer- จัดการการแทรกและจัดการองค์ประกอบอินเทอร์เฟซผู้ใช้ของโฆษณา
IMAAVPlayerVideoDisplay- สื่อสารระหว่าง IMA SDK กับมีเดียเพลเยอร์และจัดการข้อมูลเมตาที่กำหนดเวลาIMAStreamManager- จัดการการเล่นสตรีมและทริกเกอร์เหตุการณ์ที่เกี่ยวข้องกับโฆษณา
เริ่มต้นตัวโหลดโฆษณา คอนเทนเนอร์ที่แสดงโฆษณา และการแสดงวิดีโอหลังจากที่ โหลดมุมมอง
Objective-C
Swift
ส่งคำขอสตรีม
เมื่อผู้ใช้กดปุ่มเล่น ให้ส่งคำขอสตรีมใหม่
ใช้คลาส
IMAPodStreamRequest
สำหรับไลฟ์สด สำหรับสตรีม VOD ให้ใช้คลาส
IMAPodVODStreamRequest
คำขอสตรีมต้องใช้พารามิเตอร์สตรีม รวมถึงการอ้างอิงถึง คอนเทนเนอร์ที่แสดงโฆษณาและวิดีโอที่แสดง
Objective-C
Swift
รอเหตุการณ์การโหลดสตรีม
คลาส IMAAdsLoader
เรียกใช้เมธอด
IMAAdsLoaderDelegate
เมื่อการเริ่มต้นสำเร็จหรือคำขอสตรีมล้มเหลว
ในเมธอด adsLoadedWithData
delegate ให้ตั้งค่า
IMAStreamManagerDelegate
ส่งรหัสสตรีมไปยังแฮนเดิล VTP ที่กำหนดเอง แล้วเรียก URL ของไฟล์ Manifest ของสตรีม
สำหรับไลฟ์สด ให้โหลด URL ของไฟล์ Manifest ลงในวิดีโอที่แสดง
แล้วเริ่มเล่น สำหรับสตรีม VOD ให้ส่ง URL ของไฟล์ Manifest ไปยังเมธอด loadThirdPartyStream
ของตัวจัดการสตรีม
วิธีนี้จะขอข้อมูลเหตุการณ์โฆษณาจาก Ad Manager 360 จากนั้นจะโหลด
URL ของไฟล์ Manifest และเริ่มเล่น
ในเมธอด
failedWithErrorData
delegate ให้บันทึกข้อผิดพลาด คุณจะเล่นสตรีมสำรองหรือไม่ก็ได้ ดูแนวทางปฏิบัติแนะนำสำหรับ DAI
Objective-C
Swift
ใช้ตัวแฮนเดิล VTP ที่กำหนดเอง
แฮนเดิล VTP ที่กำหนดเองจะส่งรหัสสตรีมของผู้ชมไปยังพาร์ทเนอร์ด้านเทคนิค วิดีโอ (VTP) พร้อมกับข้อมูลอื่นๆ ที่ VTP ต้องการเพื่อส่งคืน ไฟล์ Manifest ของสตรีมที่มีทั้งเนื้อหาและโฆษณาที่ผสานรวม VTP ของคุณจะให้วิธีการที่เฉพาะเจาะจงเกี่ยวกับวิธีติดตั้งใช้งานตัวแฮนเดิล VTP ที่กำหนดเอง
เช่น VTP อาจมี URL ของเทมเพลตไฟล์ Manifest ที่มีมาโคร
[[STREAMID]] ในตัวอย่างนี้ ตัวแฮนเดิลจะแทรกรหัสสตรีมแทนที่มาโคร
และแสดงผล URL ของไฟล์ Manifest ที่ได้
Objective-C
Swift
รอเหตุการณ์โฆษณา
IMAStreamManager
เรียกใช้เมธอด
IMAStreamManagerDelegate
เพื่อส่งเหตุการณ์และข้อผิดพลาดของสตรีมไปยังแอปพลิเคชัน
ในตัวอย่างนี้ ให้บันทึกเหตุการณ์โฆษณาหลักไปยังคอนโซล
Objective-C
Swift
ล้างข้อมูลชิ้นงาน IMA DAI
หากต้องการหยุดการเล่นสตรีม หยุดการติดตามโฆษณาทั้งหมด และปล่อยชิ้นงานสตรีมที่โหลดทั้งหมด ให้เรียกใช้ IMAStreamManager.destroy()
เรียกใช้แอป หากสำเร็จ ให้ขอและเล่นสตรีม DAI ของ Google ด้วย IMA SDK ดูข้อมูลเกี่ยวกับฟีเจอร์ SDK ขั้นสูงเพิ่มเติมได้ในคำแนะนำอื่นๆ ที่แสดงในแถบด้านข้างทางซ้ายหรือตัวอย่างใน GitHub