IMA SDK รองรับการโหลดเนื้อหาโฆษณาวิดีโอล่วงหน้า คุณสามารถเปิดใช้ฟีเจอร์นี้ในการผสานรวม SDK เพื่อให้การเปลี่ยนระหว่างโฆษณาและเนื้อหาเป็นไปอย่างราบรื่นยิ่งขึ้น คู่มือนี้จะอธิบายรายละเอียดทางเทคนิคของการใช้การโหลดสื่อล่วงหน้าด้วย IMA SDK
วิชาบังคับก่อน
การโหลดล่วงหน้าต้องใช้ IMA Android SDK เวอร์ชัน 3.17.0 ขึ้นไป
เปิดใช้งานการโหลดล่วงหน้า
หากต้องการเปิดใช้การโหลดล่วงหน้า ให้ใช้AdsRenderingSettings.setEnablePreloading()
เพื่อตั้งค่าการโหลดล่วงหน้าเป็น "จริง" ซึ่งต้องทำภายในการเรียกกลับ onAdsManagerLoaded()
:
@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent adsManagerLoadedEvent) {
...
AdsRenderingSettings adsRenderingSettings =
ImaSdkFactory.getInstance().createAdsRenderingSettings();
adsRenderingSettings.setEnablePreloading(true);
mAdsManager.init(adsRenderingSettings);
}
การรองรับการโหลดล่วงหน้าด้วย VideoAdPlayer ที่กำหนดเอง
เราขอแนะนำให้ใช้ ส่วนขยาย ExoPlayer-IMA ที่ใช้ใน แอป Android BasicExample เมื่อผสานรวมแล้ว ส่วนขยาย ExoPlayer-IMA จะเปิดใช้การโหลดล่วงหน้าโดยค่าเริ่มต้นและมีการรองรับการโหลดล่วงหน้าในตัว
หากคุณใช้การโหลดล่วงหน้าโดยไม่มีส่วนขยาย ExoPlayer-IMA คุณจะต้องทำการเปลี่ยนแปลงเพิ่มเติมเมื่อมีการเรียกใช้ setEnablePreloading()
โปรแกรมเล่นวิดีโอต้องติดตามออบเจ็กต์ AdMediaInfo
รายการที่ส่งในการโทรจาก loadAd()
และ playAd()
และมี AdMediaInfo
ที่ถูกต้องในการเรียก AdPlayerCallback
เพื่อให้โปรแกรมเล่นวิดีโอรองรับการโหลดโฆษณาล่วงหน้า วิธีนี้อาจต้องใช้โครงสร้างข้อมูลเพื่อจัดการออบเจ็กต์ AdMediaInfo
เนื่องจาก loadAd()
สำหรับ AdMediaInfo
ที่ตามมาอาจเกิดขึ้นขณะที่ AdMediaInfo
ก่อนหน้ากำลังเล่นอยู่ ตัวอย่างต่อไปนี้แสดงให้เห็นการเปลี่ยนแปลงบางส่วนที่คุณอาจต้องดำเนินการเพื่อให้แอปรองรับการโหลดล่วงหน้า
// enum for cases of PlayerState.
static enum PlayerState {
IDLE,
LOADED,
PLAYING,
PAUSED,
}
...
private final List<VideoAdPlayer.VideoAdPlayerCallback> callbacks;
private final ArrayList<AdMediaInfo> mediaInfos = new ArrayList<>();
private PlayerState playerState;
private boolean adCurrentlyLoaded;
...
@Override
public void playAd(AdMediaInfo adMediaInfo) {
switch (playerState) {
case LOADED:
for (VideoAdPlayerCallback callback : callbacks) {
callback.onPlay(adMediaInfo);
}
break;
case PAUSED:
for (VideoAdPlayerCallback callback : callbacks) {
callback.onResume(adMediaInfo);
}
break;
case PLAYING:
// Intentionally and silently ignore since it is already playing from a prior media item,
// note that onPlay is triggered by positionDiscontinuity.
return;
case IDLE:
throw new IllegalStateException("Call to playAd when player state is not LOADED.");
}
playerState = PlayerState.PLAYING;
player.setPlayWhenReady(true);
}
@Override
public void loadAd(AdMediaInfo adMediaInfo, AdPodInfo adPodInfo) {
if (adCurrentlyLoaded == true) {
mediaInfos.add(adMediaInfo);
return;
}
player.stop();
player.seekTo(0);
mediaInfos.clear();
mediaInfos.add(adMediaInfo);
player.setPlayWhenReady(false);
player.loadMedia(adMediaInfo.getUrl());
playerState = PlayerState.LOADED;
adCurrentlyLoaded = true;
}
@Override
public void stopAd(AdMediaInfo adMediaInfo) {
if (allAdsInBreakHavePlayed()) {
if (isFinalAd(adMediaInfo)) {
// handle clean up after all ads have played.
} else {
seekToNextItem(player);
}
} else {
mediaInfos.remove(adMediaInfo);
}
}
private boolean allAdsInBreakHavePlayed() {
// Code to determine if all the ads in the current ad break have completed.
}
private boolean isFinalAd(AdMediaInfo adMediaInfo) {
// Code to determine if this adMediaInfo is the final ad.
}
private void seekToNextItem(YourPlayerClass player) {
// Code to seek your player to the next media item.
}
การทดสอบการใช้งานการโหลดล่วงหน้าที่กำหนดเอง
สำหรับการใช้งานการโหลดล่วงหน้าที่กำหนดเอง ขอแนะนำให้ทดสอบกรณี Edge ต่อไปนี้เพื่อยืนยันการตั้งค่าการโหลดล่วงหน้าที่ถูกต้อง
- โฆษณาตอนต้นโฆษณารายการเดียว
- โฆษณาตอนต้นพ็อดโฆษณา 3 รายการ
- โฆษณาตอนกลาง 3 พ็อดโฆษณา
- กรอไปยังโฆษณาตอนกลางที่ 2 หลังจากโฆษณาตอนกลางรายการแรกเริ่มโหลดล่วงหน้าแต่ก่อนที่วิดีโอจะเล่น
- การเล่นโฆษณาตอนท้าย
ช่วงเวลา
ตารางต่อไปนี้สรุปการเปลี่ยนแปลงของเวลาที่ใช้ในการโหลดโฆษณาเมื่อเปิดใช้การโหลดล่วงหน้า
เหตุการณ์ | พร้อมการโหลดล่วงหน้า | ไม่มีการโหลดล่วงหน้า |
---|---|---|
ขอ VAST โฆษณาแล้ว | AdsLoader.requestAds() |
AdsLoader.requestAds() |
โหลดโฆษณาตอนต้นแล้ว (โฆษณาเดียว) | AdsManager.init() |
AdsManager.start() |
โหลดโฆษณาตอนต้นแล้ว (VMAP/กฎโฆษณา) | AdsManager.init() |
AdsManager.init() |
โหลดโฆษณาตอนกลางหรือโฆษณาตอนท้ายแล้ว | สำหรับโฆษณาชิ้นแรกในช่วงพักโฆษณา หรือ 8 วินาทีก่อนเวลาเริ่มต้นโฆษณา สำหรับโฆษณาก่อนหน้า เมื่อโฆษณาก่อนหน้าเริ่มเล่น | ในเวลาเริ่มต้นโฆษณา |
คำถามที่พบบ่อย
- การโหลดสื่อล่วงหน้าจะโหลดครีเอทีฟโฆษณาที่สมบูรณ์ไหม
- ไม่ ครีเอทีฟโฆษณามักจะโหลดไม่สมบูรณ์เมื่อเริ่มเล่นโฆษณา การโหลดล่วงหน้ามีไว้เพื่อปรับปรุงประสบการณ์ของผู้ใช้โดยลดเวลาที่ใช้ในการโหลดโฆษณา ไม่ได้มีไว้เพื่อรองรับการแสดงโฆษณาแบบออฟไลน์
- จำเป็นต้องเปิดใช้การโหลดสื่อล่วงหน้าสำหรับ VAST และโฆษณากับสื่อไหม
- ไม่ SDK จะโหลด VAST ของโฆษณาล่วงหน้าเสมอ ไม่ว่าการตั้งค่าการโหลดล่วงหน้านี้จะเป็นอย่างไรก็ตาม