הגדרת IMA SDK ל-DAI

ערכות IMA SDK מאפשרות לשלב בקלות מודעות מולטימדיה באתרים ובאפליקציות. ‫IMA SDKs יכולים לשלוח בקשות למודעות מכל שרת מודעות שתואם ל-VAST ולנהל את ההפעלה של המודעות באפליקציות. באמצעות IMA DAI SDK, האפליקציות שולחות בקשה לסטרימינג של מודעות ותוכן וידאו – תוכן VOD או תוכן בשידור חי. לאחר מכן, ה-SDK מחזיר זרם וידאו משולב, כך שלא צריך לנהל את המעבר בין מודעה לתוכן וידאו באפליקציה.

בחירת פתרון DAI שמעניין אתכם

הצגת DAI ב-Pod

ערכות IMA SDK מאפשרות לשלב בקלות מודעות מולטימדיה באתרים ובאפליקציות. ‫IMA SDKs יכולים לשלוח בקשות למודעות מכל שרת מודעות שתואם ל-VAST ולנהל את ההפעלה של המודעות באפליקציות. באמצעות IMA DAI SDK, האפליקציות שולחות בקשה לסטרימינג של מודעות ותוכן וידאו – תוכן VOD או תוכן בשידור חי. לאחר מכן, ה-SDK מחזיר זרם וידאו משולב, כך שלא צריך לנהל את המעבר בין מודעה לתוכן וידאו באפליקציה.

במדריך הזה מוסבר איך להפעיל שידור של פוד מודעות ב-DAI באמצעות IMA DAI SDK עם נגן וידאו להפעלה של שידורים חיים ושידורי VOD. כדי לראות או לעקוב אחרי שילוב לדוגמה שהושלם, מורידים את הדוגמה של הצגת פודקאסטים.

סקירה כללית על הצגת מודעות דינמיות (DAI) ב-IMA

• ‫StreamRequest: אובייקט שמגדיר בקשה להזרמת נתונים לשרתי הפרסום של Google. צריך ליצור אותו באמצעות ImaSdkFactory.createPodStreamRequest() או ImaSdkFactory.createPodVodStreamRequest() כדי להפעיל את האפשרות להצגת פודים. השיטות האלה דורשות קוד רשת, והשיטה createPodStreamRequest דורשת גם מפתח נכס בהתאמה אישית ומפתח API אופציונלי. שניהם כוללים פרמטרים אופציונליים נוספים.

• ‫StreamManager: אובייקט שמטפל בתקשורת בין זרם הווידאו לבין IMA DAI SDK, כמו הפעלת פינגים למעקב והעברת אירועים של הזרם לבעל האפליקציה.

דרישות מוקדמות

• אפליקציית Android שכבר הוגדרה עם IMA DAI SDK להפעלת סטרימינג של סרטונים עם מודעות DAI. אם עדיין אין לכם אפליקציה כזו, מומלץ להשתמש ב-Android DAI BasicExample כנקודת התחלה. ב-BasicExample יש בסיס קוד שאליו מתייחס המדריך הזה.

• כדי ש-IMA DAI יפעל, חשוב שהאפליקציה תשלח אירועי ID3 באמצעות VideoStreamPlayerCallback.onUserTextReceived(). דוגמה לקטע קוד של DAI עם שירות מלא

הגדרת משתנים להצגת מודעות ב-Pod

כל השינויים שנדרשים להצגת מודעות ב-Pod מתבצעים ב-SampleAdsWrapper.java. השלב הראשון הוא לעדכן את המשתנים הקבועים.

אלה הקבועים של בקשת הזרמת חבילת מודעות שצריך להוסיף:

• ‫STREAM_URL: משמש רק לשידורים חיים – כתובת ה-URL של זרם הווידאו שסופקה על ידי כלי לשינוי מניפסט או על ידי שותף צד שלישי באמצעות הצגת מודעות בתוך פוד. הוא צריך לדרוש ממך להוסיף את מזהה הסטרימינג שסופק על ידי IMA DAI SDK, לפני שאתה שולח בקשה. במקרה הזה, כתובת ה-URL של הסטרימינג כוללת placeholder,‏ "[[STREAMID]]", שמוחלף במזהה הסטרימינג לפני שליחת הבקשה.

• ‫NETWORK_CODE: קוד הרשת של חשבון Ad Manager 360.

• ‫CUSTOM_ASSET_KEY: משמש רק לשידורים חיים – מפתח הנכס המותאם אישית שמזהה את האירוע של הצגת פודים ב-Ad Manager 360. אפשר ליצור את הקובץ הזה באמצעות כלי לשינוי מניפסט או באמצעות שותף צד שלישי להצגת מודעות ב-Pod.

• ‫API_KEY: משמש רק לשידורים חיים – מפתח API אופציונלי שעשוי להידרש כדי לאחזר מזהה של סטרימינג מ-IMA DAI SDK.

הדוגמה הבסיסית ל-DAI ב-Android מיועדת להפעלה של מגוון סוגים שונים של סטרימינג, אבל להצגת מודעות בבלוקים היא מוגדרת להפעלה של סטרימינג יחיד בלבד. משנים את קטע המשתנים בדוגמה כך שיתאים לערכים הבאים:

/** 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 כדי להפעיל את התכונה 'הצגת פודקאסטים'

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

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

אחרי שיוצרים את מופע בקשת הזרמת הנתונים, שולחים בקשה להזרמת הנתונים באמצעות AdsLoader.requestStream():

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

עריכה והגדרה של כתובת ה-URL של השידור

// 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

// 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

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.