ตั้งค่า IMA SDK สําหรับ DAI

เลือกแพลตฟอร์ม: HTML5 Android iOS tvOS Cast Roku

IMA SDK ช่วยให้ผสานรวมโฆษณามัลติมีเดียเข้ากับเว็บไซต์และแอปได้อย่างง่ายดาย IMA SDK สามารถ ขอโฆษณาจากเซิร์ฟเวอร์โฆษณา ที่รองรับ VAST และจัดการการเล่นโฆษณาในแอปได้ เมื่อใช้ IMA DAI SDK แอปจะส่ง คำขอสตรีมสำหรับโฆษณาและเนื้อหาวิดีโอ ไม่ว่าจะเป็นเนื้อหา VOD หรือเนื้อหาสด จากนั้น SDK จะแสดงสตรีมวิดีโอที่รวมกัน เพื่อให้คุณไม่ต้องจัดการการสลับระหว่างโฆษณาและวิดีโอเนื้อหา ภายในแอป

เลือกโซลูชัน DAI ที่คุณสนใจ

บริการเต็มรูปแบบ การแสดงพอด

DAI Pod Serving

IMA SDK ช่วยให้ผสานรวมโฆษณามัลติมีเดียเข้ากับเว็บไซต์และแอปได้อย่างง่ายดาย IMA SDK สามารถ ขอโฆษณาจากเซิร์ฟเวอร์โฆษณา ที่รองรับ VAST และจัดการการเล่นโฆษณาในแอปได้ เมื่อใช้ IMA DAI SDK แอปจะส่ง คำขอสตรีมสำหรับโฆษณาและเนื้อหาวิดีโอ ไม่ว่าจะเป็นเนื้อหา VOD หรือเนื้อหาสด จากนั้น SDK จะแสดงสตรีมวิดีโอที่รวมกัน เพื่อให้คุณไม่ต้องจัดการการสลับระหว่างโฆษณาและวิดีโอเนื้อหา ภายในแอป

คู่มือนี้แสดงวิธีเล่นสตรีม DAI Pod Serving โดยใช้ IMA DAI SDK กับวิดีโอเพลเยอร์สำหรับการเล่นสตรีมแบบสดและ VOD หากต้องการดูหรือทำตามการผสานรวมตัวอย่างที่เสร็จสมบูรณ์แล้ว ให้ดาวน์โหลดตัวอย่างการแสดงพ็อด

หมายเหตุ: IMA DAI SDK สำหรับ Android รองรับทั้งสตรีม HLS และ DASH

คู่มือนี้อธิบายวิธีกำหนดค่า Exoplayer และ IMA DAI SDK เพื่อเล่นสตรีม HLS ดูตัวอย่างวิดีโอเพลเยอร์ที่รองรับทั้งสตรีม HLS และ DASH ได้ที่ตัวอย่างขั้นสูง

ประเด็นสำคัญ: หากต้องการใช้การแสดงพ็อด DAI ของ IMA คุณต้องทำงานร่วมกับพาร์ทเนอร์การแสดงพ็อด และต้องมีบัญชี Ad Manager 360 Advanced หากมี บัญชี Ad Manager โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอรายละเอียดเพิ่มเติม ดูข้อมูลเกี่ยวกับการลงชื่อสมัครใช้ Ad Manager ได้ที่ศูนย์ช่วยเหลือของ Ad Manager

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

ภาพรวมของ DAI Pod Serving ใน IMA

• StreamRequest: ออบเจ็กต์ที่กำหนดคำขอสตรีมไปยังเซิร์ฟเวอร์โฆษณาของ Google ต้องสร้างโดยใช้ ImaSdkFactory.createPodStreamRequest() หรือ ImaSdkFactory.createPodVodStreamRequest() เพื่อเปิดใช้การแสดงพ็อด วิธีการเหล่านี้ต้องใช้รหัสเครือข่าย และcreatePodStreamRequest ต้องใช้คีย์เนื้อหาที่กำหนดเองและคีย์ API (ไม่บังคับ) ด้วย ทั้ง 2 รายการมีพารามิเตอร์อื่นๆ ที่ไม่บังคับ

• StreamManager: ออบเจ็กต์ที่จัดการการสื่อสารระหว่าง วิดีโอสตรีมกับ IMA DAI SDK เช่น การส่งการติดตามแบบ Ping และ การส่งต่อเหตุการณ์สตรีมไปยังผู้เผยแพร่โฆษณา

ข้อกำหนดเบื้องต้น

• แอป Android ที่ตั้งค่าด้วย IMA DAI SDK เพื่อเล่นสตรีมวิดีโอที่มีโฆษณา DAI อยู่แล้ว หากยังไม่มีแอปดังกล่าว เราขอแนะนำให้ใช้ Android DAI BasicExample เป็นจุดเริ่มต้น BasicExample มีโค้ดเบสที่อ้างอิงในคู่มือนี้

• แอปของคุณต้องส่งเหตุการณ์ ID3 โดยใช้ VideoStreamPlayerCallback.onUserTextReceived() เพื่อให้ IMA DAI ทำงานได้ ดูตัวอย่างข้อมูลโค้ด DAI แบบเต็มรูปแบบนี้

ตั้งค่าตัวแปร Pod Serving

การเปลี่ยนแปลงทั้งหมดที่จำเป็นสำหรับ Pod Serving จะดำเนินการใน SampleAdsWrapper.java ขั้นตอนแรกคือการอัปเดตตัวแปรค่าคงที่

ค่าคงที่ของคำขอสตรีมพ็อดโฆษณาที่ต้องเพิ่มมีดังนี้

• STREAM_URL: ใช้สำหรับไลฟ์สดเท่านั้น - URL สตรีมวิดีโอที่ได้รับจาก เครื่องมือจัดการไฟล์ Manifest หรือพาร์ทเนอร์บุคคลที่สามที่ใช้ Pod Serving โดยคุณควรต้อง แทรกรหัสสตรีมที่ได้รับจาก IMA DAI SDK ก่อนที่จะ ส่งคำขอ ในกรณีนี้ URL ของสตรีมจะมีตัวยึดตำแหน่ง "[[STREAMID]]" ซึ่งจะถูกแทนที่ด้วยรหัสสตรีมก่อนที่จะส่งคำขอ

• NETWORK_CODE: รหัสเครือข่ายสำหรับบัญชี Ad Manager 360

• CUSTOM_ASSET_KEY: ใช้สำหรับสตรีมแบบสดเท่านั้น - คีย์ชิ้นงานที่กำหนดเองซึ่งระบุเหตุการณ์การแสดงโฆษณาพอดใน Ad Manager 360 โดยสามารถสร้างได้โดย เครื่องมือจัดการไฟล์ Manifest หรือพาร์ทเนอร์ Pod Serving บุคคลที่สาม

• API_KEY: ใช้สำหรับไลฟ์สดเท่านั้น - คีย์ API ที่ไม่บังคับซึ่งอาจต้องใช้เพื่อดึงรหัสสตรีมจาก IMA DAI SDK

Android DAI BasicExample ออกแบบมาเพื่อเล่นสตรีมประเภทต่างๆ แต่สำหรับการแสดงโฆษณาพ็อด จะตั้งค่าให้เล่นสตรีมเดียวเท่านั้น เปลี่ยนส่วนตัวแปรของตัวอย่างให้ตรงกับส่วนต่อไปนี้

หมายเหตุ: พารามิเตอร์สตรีมที่ระบุไว้ใช้สำหรับสตรีมพอดแคสต์สด หากต้องการทดสอบด้วยสตรีม VOD ที่แสดงพ็อด คุณต้องระบุพารามิเตอร์สตรีมทดสอบของคุณเอง

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;
SampleAdsWrapper.java

สร้างคำขอสตรีมพ็อดแบบสดหรือ VOD เพื่อเปิดใช้ Pod Serving

การแสดงพ็อดแคสต์ในไลฟ์สด

นำวิธีการ buildStreamRequest() ที่ใช้สลับระหว่าง การสร้างสตรีมประเภทต่างๆ ออก จากนั้นแก้ไข requestAndPlayAds() เพื่อเรียกใช้ ImaSdkFactory.createPodStreamRequest() เพื่อสร้างคำขอโฆษณา การแสดงพ็อดแคสต์แบบสด

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
SampleAdsWrapper.java

การแสดงพ็อดในสตรีม VOD

นำวิธีการ buildStreamRequest() ที่ใช้สลับระหว่าง การสร้างสตรีมประเภทต่างๆ ออก จากนั้นแก้ไข requestAndPlayAds() เพื่อเรียกใช้ ImaSdkFactory.createPodVodStreamRequest() เพื่อสร้างคำขอโฆษณา VOD Pod Serving

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
SampleAdsWrapper.java

หลังจากสร้างอินสแตนซ์คำขอสตรีมแล้ว ให้ขอสตรีมโดยใช้ AdsLoader.requestStream()

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);
SampleAdsWrapper.java

แก้ไขและตั้งค่า URL ของสตรีม

การแสดงพ็อดแคสต์ในไลฟ์สด

เรียกใช้เมธอด StreamManager.getStreamId() เพื่อรับรหัสสตรีม ต้องแทรกข้อมูลนี้ลงใน STEAM_URL แทนที่ "[[STREAMID]]" หลังจากทำการเปลี่ยนแปลงนี้แล้ว ให้ตั้งค่า URL ของสตรีมใหม่โดยใช้videoPlayer.setStreamUrl() เมธอด และเรียกใช้เมธอด videoPlayer.play() เพื่อเริ่มการเล่นสตรีม

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();
SampleAdsWrapper.java

การแสดงพ็อดในสตรีม VOD

1. เรียกใช้เมธอด StreamManager.getStreamId() เพื่อรับรหัสสตรีม
2. ขอ URL ของสตรีมจากพาร์ทเนอร์เทคโนโลยีวิดีโอ (VTP)
3. หลังจากได้รับ URL จาก VTP แล้ว ให้เรียกใช้เมธอด StreamManager.loadThirdPartyStream() พร้อม URL เพื่อโหลดสตรีม พร้อมคำบรรยายแทนเสียงที่ VTP ส่งคืน

// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);
SampleAdsWrapper.java

สำหรับคำขอการแสดงโฆษณาพ็อด VOD ทาง IMA จะเรียกใช้VideoStreamPlayer.loadUrl() การเรียกกลับเมื่อสตรีมโหลดแล้ว หากต้องการเริ่มการเล่นสตรีม ให้เพิ่มการเรียก videoPlayer.setStreamUrl() และ videoPlayer.play() ไปยัง VideoStreamPlayer.loadUrl() Callback ดังนี้

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }
SampleAdsWrapper.java

ล้างข้อมูลชิ้นงาน IMA DAI

เมื่อขอและแสดงโฆษณาในสตรีมการแสดงโฆษณาพ็อดด้วย IMA DAI SDK เสร็จเรียบร้อยแล้ว เราขอแนะนำให้คุณล้างข้อมูลทรัพยากรทั้งหมดหลังจากเซสชันการแสดงโฆษณาพ็อดเสร็จสมบูรณ์ เรียกใช้ StreamManager.destroy() เพื่อหยุดการเล่นสตรีม หยุดการติดตามโฆษณาทั้งหมด และปล่อยชิ้นงานสตรีมที่โหลดทั้งหมด

ดูตัวอย่างอื่นๆ ของการใช้ Android SDK ได้ที่ ตัวอย่างใน GitHub