हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

पॉड सर्विस डीएआई के साथ सेट अप करना

प्लैटफ़ॉर्म चुनें: HTML5 Android iOS tvOS Cast Roku

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

आईएमए एसडीके, वीएएसटी के साथ काम करने वाले किसी भी विज्ञापन सर्वर से विज्ञापनों का अनुरोध कर सकते हैं. साथ ही, आपके ऐप्लिकेशन में विज्ञापन प्लेबैक को मैनेज कर सकते हैं.

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

इस गाइड में, CAF के लिए IMA डीएआई SDK का इस्तेमाल करके, डीएआई पॉड सर्विंग स्ट्रीम चलाने का तरीका बताया गया है.

इस गाइड का इस्तेमाल करने से पहले, Chromecast ऐप्लिकेशन फ़्रेमवर्क के वेब रिसीवर प्रोटोकॉल के बारे में जानें. इस गाइड में यह माना गया है कि आपको CAF रिसीवर के बुनियादी कॉन्सेप्ट की जानकारी है. जैसे, मैसेज इंटरसेप्टर और mediaInformation ऑब्जेक्ट. साथ ही, आपको CAF सेंडर को एम्युलेट करने के लिए, Cast Command and Control टूल इस्तेमाल करने की जानकारी है.

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

अन्य प्लैटफ़ॉर्म के साथ इंटिग्रेट करने या IMA क्लाइंट-साइड SDK टूल इस्तेमाल करने के बारे में जानकारी पाने के लिए, Interactive Media Ads SDK देखें.

आईएमए डीएआई पॉड सर्विंग की खास जानकारी

IMA CAF DAI SDK का इस्तेमाल करके पॉड सर्विंग की सुविधा लागू करने के लिए, दो मुख्य कॉम्पोनेंट की ज़रूरत होती है. इस गाइड में इनके बारे में बताया गया है:

StreamRequest: यह एक ऐसा ऑब्जेक्ट है जो Google के विज्ञापन सर्वर को स्ट्रीम का अनुरोध भेजता है. अनुरोधों में नेटवर्क कोड, कस्टम ऐसेट पासकोड, और वैकल्पिक एपीआई पासकोड के साथ-साथ अन्य वैकल्पिक पैरामीटर भी शामिल होते हैं.
StreamManager: यह एक ऐसा ऑब्जेक्ट है जो वीडियो स्ट्रीम और आईएमए डीएआई एसडीके के बीच कम्यूनिकेशन को मैनेज करता है. जैसे, ट्रैकिंग पिंग को ट्रिगर करना और स्ट्रीम इवेंट को पब्लिशर को फ़ॉरवर्ड करना.

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

Cast Developer Console खाता, जिसमें टेस्ट डिवाइस रजिस्टर किए गए हों.
होस्ट किया गया वेब रिसीवर ऐप्लिकेशन, जो आपके Cast Developer Console में रजिस्टर हो. साथ ही, इस गाइड में दिए गए कोड को होस्ट करने के लिए, इसमें बदलाव किया जा सकता हो.
एक सेंडर ऐप्लिकेशन, जिसे आपके वेब रिसीवर ऐप्लिकेशन का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया हो. इस उदाहरण के लिए, Cast Command and Control टूल को सेंडर के तौर पर इस्तेमाल करें.

भेजने वाले के MediaInfo ऑब्जेक्ट कॉन्फ़िगर करना

सबसे पहले, अपने सेंडर ऐप्लिकेशन के MediaInfo ऑब्जेक्ट को कॉन्फ़िगर करें, ताकि उसमें ये फ़ील्ड शामिल किए जा सकें:

फ़ील्ड सामग्री

contentId

इस मीडिया आइटम के लिए यूनीक आइडेंटिफ़ायर.

CONTENT_ID

contentUrl

ज़रूरी नहीं. अगर डीएआई स्ट्रीम लोड नहीं हो पाती है, तो बैकअप स्ट्रीम का यूआरएल चलाएं.

BACKUP_STREAM_URL

contentType

ज़रूरी नहीं. कॉन्टेंट बैकअप स्ट्रीम का माइमटाइप. यह सिर्फ़ DASH स्ट्रीम के लिए ज़रूरी है.

CONTENT_STREAM_MIMETYPE

streamType इस वैल्यू के लिए इस्तेमाल की जाने वाली स्ट्रिंग लिटरल या कॉन्स्टेंट, भेजने वाले के प्लैटफ़ॉर्म के हिसाब से अलग-अलग होती है.

customData

customData फ़ील्ड में, ज़रूरी अन्य फ़ील्ड का की-वैल्यू स्टोर होता है. इस सैंपल में, आपके डीएआई स्ट्रीम पैरामीटर शामिल हैं. इसके बजाय, प्रोडक्शन ऐप्लिकेशन में ऐसा आइडेंटिफ़ायर पास किया जा सकता है जिसका इस्तेमाल करके, आपका कास्ट रिसीवर ऐप्लिकेशन, सर्वर साइड अनुरोध के साथ इन पैरामीटर को वापस पा सके.

फ़ील्ड	सामग्री
`daiStreamType`	आपकी डीएआई स्ट्रीम का टाइप. इनमें से कोई एक: `"LIVE"` या `"VOD"` `DAI_STREAM_TYPE`
`networkCode`	आपके Google Ad Manager 360 खाते का नेटवर्क कोड. `NETWORK_CODE`
`customAssetKey`	यह फ़ील्ड सिर्फ़ लाइव स्ट्रीम के लिए ज़रूरी है. कस्टम ऐसेट कुंजी, जो Google Ad Manager 360 में आपके पॉड सर्विंग इवेंट की पहचान करती है. `CUSTOM_ASSET_KEY`
`apiKey`	आईएमए डीएआई एसडीके से स्ट्रीम आईडी पाने के लिए, एक वैकल्पिक एपीआई पासकोड. `API_KEY`

शुरू करने में आपकी मदद के लिए, यहां कुछ कोड सैंपल दिए गए हैं:

वेब

Cast वेब सेंडर में इन वैल्यू को कॉन्फ़िगर करने के लिए, पहले ज़रूरी डेटा के साथ एक MediaInfo ऑब्जेक्ट बनाएं. इसके बाद, वेब रिसीवर को लोड करने का अनुरोध भेजें.

// Create mediaInfo object
const mediaInfo = new chrome.cast.media.MediaInfo("CONTENT_ID");
mediaInfo.contentUrl = "BACKUP_STREAM_URL";
mediaInfo.contentType = "CONTENT_STREAM_MIMETYPE";
mediaInfo.streamType = chrome.cast.media.StreamType.LIVE;
mediaInfo.customData = {
  daiStreamType: "DAI_STREAM_TYPE",
  networkCode: "NETWORK-CODE",
  customAssetKey: "CUSTOM_ASSET_KEY",
  apiKey: "API_KEY"
};

// Make load request to cast web receiver
const castSession = cast.framework.CastContext.getInstance().getCurrentSession();
const request = new chrome.cast.media.LoadRequest(mediaInfo);
castSession.loadMedia(request).then(
  () => { console.log('Load succeed'); },
  (errorCode) => { console.log('Error code: ' + errorCode); });

Android

Cast वेब सेंडर में इन वैल्यू को कॉन्फ़िगर करने के लिए, पहले ज़रूरी डेटा के साथ MediaInfo ऑब्जेक्ट बनाएं. इसके बाद, वेब रिसीवर को लोड करने का अनुरोध करें.

JSONObject customData = new JSONObject()?
  .put("daiStreamType", "DAI_STREAM_TYPE")
  .put("networkCode", "NETWORK-CODE")
  .put("customAssetKey", "CUSTOM_ASSET_KEY")
  .put("apiKey", "API_KEY");
MediaInfo mediaInfo = MediaInfo.Builder("CONTENT_ID")
  .setContentUrl("BACKUP_STREAM_URL")
  .setContentType("CONTENT_STREAM_MIMETYPE")
  .setStreamType(MediaInfo.STREAM_TYPE_LIVE)
  .setCustomData(customData)
  .build();

RemoteMediaClient remoteMediaClient = mCastSession.getRemoteMediaClient();
remoteMediaClient.load(new MediaLoadRequestData.Builder().setMediaInfo(mediaInfo).build());

iOS (Obj-C)

Cast वेब सेंडर में इन वैल्यू को कॉन्फ़िगर करने के लिए, पहले ज़रूरी डेटा के साथ एक GCKMediaInformation ऑब्जेक्ट बनाएं. इसके बाद, वेब रिसीवर को लोड करने का अनुरोध भेजें.

NSURL url = [NSURL URLWithString:@"BACKUP_STREAM_URL"];
NSDictionary *customData = @{
  @"daiStreamType": @"DAI_STREAM_TYPE",
  @"networkCode": @"NETWORK-CODE",
  @"customAssetKey": @"CUSTOM_ASSET_KEY",
  @"apiKey": @"API_KEY"};
mediaInfoBuilder.customData = customData;

GCKMediaInformationBuilder *mediaInfoBuilder =
  [[GCKMediaInformationBuilder alloc] initWithContentID: @"CONTENT_ID"];
mediaInfoBuilder.contentURL = url;
mediaInfoBuilder.contentType = @"CONTENT_STREAM_MIMETYPE";
mediaInfoBuilder.streamType = GCKMediaStreamTypeLive;
mediaInfoBuilder.customData = customData;
self.mediaInformation = [mediaInfoBuilder build];

GCKRequest *request = [self.sessionManager.currentSession.remoteMediaClient loadMedia:self.mediaInformation];
if (request != nil) {
  request.delegate = self;
}

iOS (Swift)

let url = URL.init(string: "BACKUP_STREAM_URL")
guard let mediaURL = url else {
  print("invalid mediaURL")
  return
}

let customData = [
  "daiStreamType": "DAI_STREAM_TYPE",
  "networkCode": "NETWORK-CODE",
  "customAssetKey": "CUSTOM_ASSET_KEY",
  "region": "API_KEY"
]

let mediaInfoBuilder = GCKMediaInformationBuilder.init(contentId: "CONTENT_ID")
mediaInfoBuilder.contentURL = mediaUrl
mediaInfoBuilder.contentType = @"CONTENT_STREAM_MIMETYPE"
mediaInfoBuilder.streamType = GCKMediaStreamType.Live
mediaInfoBuilder.customData = customData
mediaInformation = mediaInfoBuilder.build()

guard let mediaInfo = mediaInformation else {
  print("invalid mediaInformation")
  return
}

if let request = sessionManager.currentSession?.remoteMediaClient?.loadMedia
(mediaInfo) {
  request.delegate = self
}

सीएसी टूल

Cast Command and Control टूल में इन वैल्यू को कॉन्फ़िगर करने के लिए, Load Media टैब पर क्लिक करें. इसके बाद, कस्टम लोड अनुरोध टाइप को LOAD पर सेट करें. इसके बाद, टेक्स्ट एरिया में मौजूद JSON डेटा को इस JSON से बदलें:

{
  "media": {
    "contentId": "CONTENT_ID",
    "contentUrl": "BACKUP_STREAM_URL",
    "contentType": ""CONTENT_STREAM_MIMETYPE"",
    "streamType": "LIVE",
    "customData": {
      "daiStreamType": "DAI_STREAM_TYPE",
      "networkCode": "NETWORK-CODE",
      "customAssetKey": "CUSTOM_ASSET_KEY",
      "oAuthToken": "API_KEY"
    }
  }
}

इस कस्टम लोड अनुरोध को रिसीवर को भेजा जा सकता है, ताकि बाकी चरणों की जांच की जा सके.

एक बेसिक सीएएफ़ रिसीवर बनाना

CAF SDK कस्टम वेब रिसीवर गाइड में बताए गए तरीके से, कस्टम वेब रिसीवर बनाएं.

रिसीवर का कोड कुछ ऐसा दिखेगा:

<html>
<head>
  <script
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    // ...
  </script>
</body>
</html>

आईएमए डीएआई एसडीके इंपोर्ट करना और प्लेयर मैनेजर पाना

अपने वेब रिसीवर में CAF के लिए आईएमए डीएआई एसडीके टूल इंपोर्ट करने के लिए, CAF को लोड करने वाली स्क्रिप्ट के ठीक बाद एक स्क्रिप्ट टैग जोड़ें. स्क्रिप्ट टैग में, रिसीवर को शुरू करने से पहले, रिसीवर कॉन्टेक्स्ट और प्लेयर मैनेजर को कॉन्सटेंट के तौर पर सेव करें.

<html>
<head>
  <script
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();

    castContext.start();
  </script>
</body>
</html>

आईएमए स्ट्रीम मैनेजर को शुरू करना

आईएमए स्ट्रीम मैनेजर को शुरू करें.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    castContext.start();
  </script>
</body>
</html>

स्ट्रीम मैनेजर लोड इंटरसेप्टर बनाना

अपने मीडिया आइटम को सीएएफ़ में पास करने से पहले, LOAD मैसेज इंटरसेप्टर में स्ट्रीम का अनुरोध करें.

    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    /**
     * Creates a livestream request object for a Pod Serving stream.
     * @param {!LoadRequestData} castRequest The request object from the cast sender
     * @return {StreamRequest} an IMA stream request
     */
    const createStreamRequest = (castRequest) => { /* ... */};

    /**
     * Initates a DAI stream request for the final stream manifest.
     * @param {!LoadRequestData} castRequest The request object from the cast sender
     * @return {Promise<LoadRequestData>} a promise that resolves to an updated castRequest, containing the DAI stream manifest
     */
    const createDAICastRequest = (castRequest) => {
        return streamManager.requestStream(castRequest, createStreamRequest(castRequest))
          .then((castRequestWithPodStreamData) => {
            console.log('Successfully made DAI stream request.');
            // ...
            return castRequestWithPodStreamData;
          })
          .catch((error) => {
            console.log('Failed to make DAI stream request.');
            // CAF will automatically fallback to the content URL
            // that it can read from the castRequest object.
            return castRequest;
          });
    };

    playerManager.setMessageInterceptor(
        cast.framework.messages.MessageType.LOAD, createDAICastRequest);

    castContext.start();

स्ट्रीम का अनुरोध करना

सीएएफ़ लोड अनुरोध के आधार पर पॉड सर्विंग स्ट्रीम बनाने के लिए, createStreamRequest फ़ंक्शन को पूरा करें.

    /**
     * Creates a livestream request object for a Pod Serving stream.
     * @param {!LoadRequestData} castRequest The request object from the cast sender
     * @return {StreamRequest} an IMA stream request
     */
    const createStreamRequest = (castRequest) => {
      const customData = castRequest.media.customData;
      let streamRequest;
      if (customData.daiStreamType == "LIVE") {
        streamRequest = new google.ima.cast.dai.api.PodStreamRequest();
        streamRequest.customAssetKey = customData.customAssetKey;
        streamRequest.networkCode = customData.networkCode;
        streamRequest.apiKey = customData.apiKey;
      } else if (customData.daiStreamType == "VOD") {
        streamRequest = new google.ima.cast.dai.api.PodVodStreamRequest();
        streamRequest.networkCode = customData.networkCode;
        streamRequest.apiKey = customData.apiKey;
      }
      return streamRequest;
    };

अपने वीटीपी से स्टिच किया गया मेनिफ़ेस्ट वापस पाना

अगर स्ट्रीम का अनुरोध पूरा हो जाता है, तो स्ट्रीम का आईडी पाने के लिए streamManager.getStreamId() का इस्तेमाल करें. आपका वीडियो टेक्निकल पार्टनर (वीटीपी) या कस्टम मेनिफ़ेस्ट मैनिपुलेटर, इस स्ट्रीम आईडी का इस्तेमाल करके मेनिफ़ेस्ट यूआरएल को वापस पाने के निर्देश देगा.

मेनिफ़ेस्ट यूआरएल वापस पाने के बाद, मौजूदा contentUrl को नए manifestUrl से बदलें.

आखिर में, बदले गए स्ट्रीम मेनिफ़ेस्ट को वापस करने से पहले, अपने streamManager पर loadStreamMetadata मेथड को कॉल करें. इससे IMA SDK को यह जानकारी मिलेगी कि वह स्ट्रीम मेटाडेटा का सुरक्षित तरीके से अनुरोध कर सकता है. यह कॉल सिर्फ़ वीओडी स्ट्रीम के लिए ज़रूरी है.

    /**
     * Initates a DAI stream request for the final stream manifest.
     * @param {!LoadRequestData} castRequest The request object from the cast sender
     * @return {Promise<LoadRequestData>} a promise that resolves to an updated castRequest, containing the DAI stream manifest
     */
    const createDAICastRequest = (castRequest) => {
        return streamManager.requestStream(castRequest, createStreamRequest(castRequest))
          .then((castRequestWithPodStreamData) => {
            console.log('Successfully made DAI stream request.');

            // This is a sample VTP integration. Consult your VTP documentation
            // for how to retrieve an ad-stitched stream manifest URL.
            const manifestTemplate = "https://.../manifest.m3u8?gam_stream_id=[[STREAMID]]";
            const streamId = streamManager.getStreamId();
            const manifestUrl = manifestTemplate.replace('[[STREAMID]]', streamId)
            // Assign your manifestUrl to the request's content URL.
            castRequestWithPodStreamData.media.contentUrl = manifestUrl;

            // After generating the manifest URL, VOD streams must notify the
            // IMA SDK that it is safe to request ad pod metadata.
            // This is only necessary for VOD streams. It is a no-op for
            // livestreams, so no conditional is needed.
            streamManager.loadStreamMetadata();

            return castRequestWithPodStreamData;
          })
          .catch((error) => {
            console.log('Failed to make DAI stream request.');
            // CAF will automatically fallback to the content URL
            // that it can read from the castRequest object.
            return castRequest;
          });
    };

आईएमए डीएआई ऐसेट को क्लीन अप करना

आईएमए डीएआई एसडीके की मदद से, पॉड सर्विंग स्ट्रीम में विज्ञापनों का अनुरोध करने और उन्हें दिखाने की प्रोसेस पूरी होने के बाद, हमारा सुझाव है कि आप पॉड सर्विंग सेशन पूरा होने के बाद सभी रिसॉर्स मिटा दें. स्ट्रीम प्लेबैक को रोकने, विज्ञापन की सभी ट्रैकिंग बंद करने, और लोड की गई सभी स्ट्रीम ऐसेट को रिलीज़ करने के लिए, StreamManager.destroy() को कॉल करें.