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