IMA डीएआई SDK टूल का इस्तेमाल शुरू करना

IMA SDK आपकी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापनों को इंटिग्रेट करना आसान बनाते हैं. IMA SDK ये काम कर सकते हैं किसी भी वेबसाइट या ऐप्लिकेशन से विज्ञापनों का अनुरोध करें वीएएसटी का पालन करने वाला विज्ञापन सर्वर और अपने ऐप्लिकेशन में विज्ञापन चलाने की सुविधा को मैनेज करना. IMA डीएआई SDK टूल की मदद से, ऐप्लिकेशन वीओडी या लाइव कॉन्टेंट, विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम अनुरोध. इसके बाद, SDK टूल जोड़ी गई वीडियो स्ट्रीम की सुविधा मिलती है, ताकि आपको विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने को मैनेज न करना पड़े शामिल हैं.

अपनी पसंद का डीएआई सलूशन चुनें

पूरी सेवा पॉड की सुविधा

पॉड के तौर पर काम करने वाला डीएआई

IMA SDK आपकी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापनों को इंटिग्रेट करना आसान बनाते हैं. IMA SDK ये काम कर सकते हैं किसी भी वेबसाइट या ऐप्लिकेशन से विज्ञापनों का अनुरोध करें वीएएसटी का पालन करने वाला विज्ञापन सर्वर और अपने ऐप्लिकेशन में विज्ञापन चलाने की सुविधा को मैनेज करना. IMA डीएआई SDK टूल की मदद से, ऐप्लिकेशन वीओडी या लाइव कॉन्टेंट, विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम अनुरोध. इसके बाद, SDK टूल जोड़ी गई वीडियो स्ट्रीम की सुविधा मिलती है, ताकि आपको विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने को मैनेज न करना पड़े शामिल हैं.

इस गाइड में IMA डीएआई का इस्तेमाल करके डीएआई पॉड सर्विंग स्ट्रीम चलाने का तरीका बताया गया है SDK टूल, जिसमें लाइव और वीओडी (वीडियो ऑन डिमांड) स्ट्रीम चलाने के लिए आसान वीडियो प्लेयर मौजूद है. अगर आपको इंटिग्रेशन के पूरे हो चुके सैंपल को देखना या उसके बारे में जानना है, तो पॉड सर्विंग का उदाहरण.

ध्यान दें: Android के लिए IMA डीएआई SDK टूल, एचएलएस और डैश, दोनों स्ट्रीम के साथ काम करता है.

इस गाइड में एचएलएस स्ट्रीम चलाने के लिए, एक्सोप्लेयर और IMA डीएआई SDK टूल को कॉन्फ़िगर करने का तरीका बताया गया है. किसी एचएलएस और डैश दोनों स्ट्रीम के साथ काम करने वाले वीडियो प्लेयर के उदाहरण के तौर पर, यहां देखें: बेहतर उदाहरण.

अहम जानकारी: IMA डीएआई पॉड सर्विंग का इस्तेमाल करने के लिए, आपको पॉड सर्विंग के साथ काम करना होगा पार्टनर और Ad Manager 360' खाते का होना ज़रूरी है बेहतर खाता. अगर आपके पास Ad Manager खाता, ज़्यादा जानकारी के लिए अपने खाता मैनेजर से संपर्क करें. इसके लिए इसके लिए, Ad Manager सहायता केंद्र पर जाएं. बीच में.

ध्यान दें: अन्य प्लैटफ़ॉर्म के साथ इंटिग्रेट करने या IMA क्लाइंट-साइड SDK टूल की जानकारी के लिए, इंटरैक्टिव मीडिया विज्ञापन SDK टूल.

IMA डीएआई पॉडकिंग के बारे में खास जानकारी

• StreamRequest: एक ऑब्जेक्ट जो स्ट्रीम के अनुरोध के बारे में बताता है Google के विज्ञापन सर्वर पर. इनमें से किसी का इस्तेमाल करके बनाया जाना चाहिए ImaSdkFactory.createPodStreamRequest() या ImaSdkFactory.createPodVodStreamRequest() पॉड सर्विंग चालू करें. इन तरीकों के लिए, एक नेटवर्क कोड ज़रूरी है और createPodStreamRequest के लिए, कस्टम ऐसेट कुंजी और एपीआई पासकोड का होना ज़रूरी नहीं है. दोनों में अन्य वैकल्पिक पैरामीटर शामिल होते हैं.

• StreamManager: एक ऑब्जेक्ट जो दोनों के बीच कम्यूनिकेशन मैनेज करता है वीडियो स्ट्रीम और IMA डीएआई SDK टूल का इस्तेमाल करना, जैसे कि ट्रैकिंग पिंग ट्रिगर करना और स्ट्रीम इवेंट को प्रकाशक को फ़ॉरवर्ड करने की सुविधा मिलती है.

ज़रूरी शर्तें

• IMA डीएआई SDK टूल के साथ पहले से सेट अप किया गया Android ऐप्लिकेशन, जिससे वीडियो स्ट्रीम चलाए जा सकते हैं डीएआई विज्ञापन. अगर आपके पास पहले से ऐसा कोई ऐप्लिकेशन नहीं है, तो हमारा सुझाव है कि Android डीएआई BasicExample प्रारंभ बिंदु. BasicExample में मौजूद कोडबेस के बारे में इस गाइड में बताया गया है.

• आपके ऐप्लिकेशन के लिए यह ज़रूरी है कि वह इसका इस्तेमाल करके ID3 इवेंट भेजे VideoStreamPlayerCallback.onUserTextReceived() IMA डीएआई के काम करने के लिए किया जा सकता है. पूरी सेवा वाले डीएआई कोड स्निपेट का उदाहरण देखें.

पॉड सर्विंग वैरिएबल सेट अप करना

पॉड सर्विंग के लिए ज़रूरी सभी बदलाव SampleAdsWrapper.java में किए जाते हैं. कॉन्टेंट बनाने पहला कदम कॉन्सटैंट वैरिएबल को अपडेट करना है.

यहां विज्ञापनों के पॉड स्ट्रीम के लिए अनुरोध किए जाने वाले कॉन्सटेंट की जानकारी दी गई है:

• STREAM_URL: सिर्फ़ लाइव स्ट्रीम के लिए इस्तेमाल किया गया - वीडियो स्ट्रीम का यूआरएल: पॉड सर्विंग का इस्तेमाल करके, मेनिफ़ेस्ट मैनेज करने वाले या तीसरे पक्ष के पार्टनर को जोड़ें. इसे ऐसा होना चाहिए इसके लिए, आपको पहले IMA डीएआई SDK टूल से मिला स्ट्रीम आईडी डालना होगा कोई अनुरोध करो. इस मामले में, स्ट्रीम के यूआरएल में एक प्लेसहोल्डर शामिल होगा, "[[STREAMID]]" को स्ट्रीम आईडी से बदल दिया जाता है. अनुरोध.

• NETWORK_CODE: आपके Ad Manager 360 खाते का नेटवर्क कोड.

• CUSTOM_ASSET_KEY: सिर्फ़ लाइव स्ट्रीम के लिए इस्तेमाल किया जाता है - यह कस्टम ऐसेट कुंजी होती है, जो Ad Manager 360 में आपके पॉड सर्विंग इवेंट की पहचान करता है. इसे इनके ज़रिए बनाया जा सकता है: मेनिफ़ेस्ट में बदलाव करने वाले या तीसरे पक्ष के पॉड सर्विंग पार्टनर को सबमिट करने की अनुमति दें.

• API_KEY: सिर्फ़ लाइव स्ट्रीम के लिए इस्तेमाल किया जाता है - एक वैकल्पिक एपीआई कुंजी, जिसे को IMA डीएआई SDK टूल से स्ट्रीम आईडी फिर से हासिल करना होगा.

Android DAI के बेसिक उदाहरण को अलग-अलग तरह की स्ट्रीम चलाने के लिए डिज़ाइन किया गया है पॉड सर्विंग के लिए सेट अप की जाती हैं. हालांकि, इसे सिर्फ़ एक स्ट्रीम चलाने के लिए सेट अप किया जाता है. उदाहरण के वैरिएबल सेक्शन में बदलाव करें, ताकि वह इनसे मैच कर सके:

ध्यान दें: दिए गए स्ट्रीम पैरामीटर, लाइव पॉड स्ट्रीम के लिए होते हैं. किसी वीओडी (वीडियो ऑन डिमांड) स्ट्रीम दिखाने वाले पॉड के लिए, आपको टेस्ट स्ट्रीम के अपने पैरामीटर देने होंगे.

/** This class adds ad-serving support to Sample HlsVideoPlayer */
public class SampleAdsWrapper
        implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Podserving Stream Constants.
  private static final String STREAM_URL =
          "https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/" +
          "master.m3u8?gen-seg-redirect=true&network=51636543&event=google-sample" +
          "&pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000" +
          "&seg-host=dai.google.com&stream_id=[[STREAMID]]";
  private static final String NETWORK_CODE = "51636543";
  private static final String CUSTOM_ASSET_KEY = "google-sample";
  private static final String API_KEY = "";

  private static final String PLAYER_TYPE = "DAISamplePlayer";

  /** Log interface, so we can output the log commands to the UI or similar. */
  public interface Logger {

...

पॉड विज्ञापन दिखाने की सुविधा चालू करने के लिए, लाइव या वीओडी (वीडियो ऑन डिमांड) पॉड स्ट्रीम का अनुरोध करें

लाइव स्ट्रीम पॉड सर्विंग

वह तरीका हटाएं जिसका इस्तेमाल buildStreamRequest() के बीच स्विच करने के लिए किया जा रहा था जिससे अलग-अलग तरह की स्ट्रीम बनाई जा सकती हैं. इसके बाद, requestAndPlayAds() को कॉल करने के लिए बदलें लाइव पॉड दिखाने वाला विज्ञापन बनाने के लिए ImaSdkFactory.createPodStreamRequest() अनुरोध. आखिर में, AdsLoader.requestStream() का इस्तेमाल करके स्ट्रीम का अनुरोध करें.

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

वीओडी (वीडियो ऑन डिमांड) स्ट्रीम पॉड सर्विंग

वह तरीका हटाएं जिसका इस्तेमाल buildStreamRequest() के बीच स्विच करने के लिए किया जा रहा था जिससे अलग-अलग तरह की स्ट्रीम बनाई जा सकती हैं. इसके बाद, requestAndPlayAds() को कॉल करने के लिए बदलें वीओडी (वीडियो ऑन डिमांड) पॉड दिखाने वाला विज्ञापन बनाने के लिए ImaSdkFactory.createPodVodStreamRequest() अनुरोध. आखिर में, AdsLoader.requestStream() का इस्तेमाल करके स्ट्रीम का अनुरोध करें.

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

स्ट्रीम के यूआरएल में बदलाव करना और उसे सेट करना

लाइव स्ट्रीम पॉड सर्विंग

स्ट्रीम आईडी पाने के लिए, StreamManager.getStreamId() पर कॉल करें. इसके बाद, यह ज़रूरी है कि "[[STREAMID]]" की जगह STEAM_URL में डाला गया. इस बदलाव के बाद तो, स्ट्रीम का नया यूआरएल videoPlayer.setStreamUrl() का इस्तेमाल करके सेट किया जा सकता है.

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  String streamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);

  streamManager.init();

  videoPlayer.setStreamUrl(streamUrl);
  videoPlayer.play();
}

वीओडी (वीडियो ऑन डिमांड) स्ट्रीम पॉड सर्विंग

स्ट्रीम आईडी पाने के लिए, StreamManager.getStreamId() पर कॉल करें. इसके बाद, आपके वीडियो टेक्नोलॉजी पार्टनर (VTP) से मिला स्ट्रीम यूआरएल. फिर कॉल करें IMA को स्ट्रीम के यूआरएल और किसी भी यूआरएल को लोड करने के लिए StreamManager.loadThirdPartyStream() आपके TVP ने सबटाइटल लौटाए.

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  // 'vtpInterface' is a place holder for your own video technology partner
  // (VTP) API calls.
  String streamUrl = vtpInterface.requestStreamURL(streamID);

  streamManager.init();

  // Pass any subtitles returned by your VTP in this step as well.
  streamManager.loadThirdPartyStream(streamUrl, subtitles);
}

पॉड सर्विंग की सुविधा चालू होने पर, IMA इन्हें कॉल नहीं करता VideoStreamPlayer.loadUrl(), ताकि आप इनमें से कोई भी कॉल निकाल सकें इससे videoPlayer.setStreamUrl() और videoPlayer.play() मिले हैं.

हो गया! इस समय, पॉड सर्विंग स्ट्रीम में विज्ञापनों का अनुरोध किया जा रहा है और उन्हें दिखाया जा रहा है: IMA डीएआई SDK टूल. इस्तेमाल किए जा रहे Android SDK के अन्य उदाहरण देखने के लिए, इसे देखो GitHub पर सैंपल देखें.