VAST इंटीग्रेशन

1. VAST क्या है

VAST(Video Ad Serving Template) - विज्ञापन सर्वर से प्लेयर तक वीडियो विज्ञापन की मेटाडेटा भेजने का IAB मानक। संस्करण 4.0 - वर्तमान।

इस तरह काम करता है:

1. मुख्य कंटेंट वीडियो से पहले प्लेयर VAST URL कॉल करता है
2. विज्ञापन का XML मिलता है: mp4 कहाँ है, अवधि, कितने सेकंड बाद skip, क्लिक पर कहाँ ले जाना है
3. विज्ञापन चलाता है (pre-roll)
4. इम्प्रेशन गिने जाने का impression-tracking pixel भेजता है
5. मुख्य वीडियो चालू करता है

हमारे JS विजेट से फ़ायदा:आपके मौजूदा प्लेयर में काम करता है। UI में कुछ बदलने की ज़रूरत नहीं।

2. VAST URL कहाँ से लें

VAST फ़ॉर्मेट उपलब्ध हैकेवल इस फ़ॉर्मेट के ब्लॉक के लिएvideo(in-stream 16:9)। ब्लॉक पेज पर/pub/zones/{id}गुलाबी पट्टी «🎬 VAST URL - अपने वीडियो प्लेयर के लिए» दिखेगी:

https://sladu.net/vast/{subid}.xml

उदाहरण:https://sladu.net/vast/tvid9234f7.xml

3. VAST उत्तर की संरचना

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.0" xmlns="http://www.iab.com/VAST">
  <Ad id="impression-uuid-here">
    <InLine>
      <AdSystem version="1.0">Sladu Network</AdSystem>
      <AdTitle><![CDATA[Заголовок креатива]]></AdTitle>
      <Impression><![CDATA[https://sladu.net/openrtb/imptracker/impression-uuid]]></Impression>
      <Creatives>
        <Creative id="creative-id" sequence="1">
          <Linear skipoffset="00:00:05">
            <Duration>00:00:30</Duration>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="640" height="360">
                <![CDATA[https://cdn.advertiser.com/video.mp4]]>
              </MediaFile>
            </MediaFiles>
            <VideoClicks>
              <ClickThrough><![CDATA[https://sladu.net/c/impression-uuid/tracking-token]]></ClickThrough>
            </VideoClicks>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

4. VAST फ़ील्ड

• - क्रिएटिव का शीर्षक
• - इम्प्रेशन गिनने का pixel URL। प्लेयर तब कॉल करता है जब विज्ञापन सचमुच दिखा।
• - mp4 वीडियो का URL, आकार (हमेशा 16:9), MIME प्रकार
• - रोल की अवधि HH:MM:SS में
• skipoffset="00:00:05"- 5 सेकंड बाद Skip बटन दिखा सकते हैं
• - क्लिक पर यूज़र कहाँ जाएगा। इसमें हमारा विज्ञापनदाता रीडायरेक्ट + click-tracking पहले से है।

5. खाली VAST (no_match)

अगर उपयुक्त क्रिएटिव नहीं (आपके जियो पर सक्रिय कैंपेन नहीं, एंटीफ्रॉड फ़िल्टर) - वैध खाली VAST लौटाते हैं:

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.0"></VAST>

प्लेयर इसे «विज्ञापन नहीं» मानकर मुख्य कंटेंट तुरंत चलाए। सभी सामान्य प्लेयर ऐसा करते हैं।

6. JW Player 8+

jwplayer("player").setup({
    file: "your-content.mp4",
    advertising: {
        client: "vast",
        tag: "https://sladu.net/vast/abc12345.xml"
    }
});

midroll / postroll के लिए:

advertising: {
    client: "vast",
    schedule: {
        preroll: { offset: "pre",  tag: "https://sladu.net/vast/abc12345.xml" },
        mid:     { offset: "50%",  tag: "https://sladu.net/vast/abc12345.xml" },
        postroll:{ offset: "post", tag: "https://sladu.net/vast/abc12345.xml" }
    }
}

7. video.js + videojs-ima

8. Google IMA SDK (सार्वभौमिक)

9. HLS.js + Google IMA

HLS.js में अंतर्निहित VAST समर्थन नहीं है। HLS.js (कंटेंट के लिए) + IMA SDK (विज्ञापन के लिए) का संयोजन इस्तेमाल करें:

if (Hls.isSupported()) {
    const hls = new Hls();
    hls.loadSource('your-stream.m3u8');
    hls.attachMedia(videoElement);
}

// VAST через IMA SDK как в примере выше
const adsRequest = new google.ima.AdsRequest();
adsRequest.adTagUrl = "https://sladu.net/vast/abc12345.xml";
adsLoader.requestAds(adsRequest);

10. Plyr / Flowplayer / Bitmovin / Brightcove

• Plyr- अंतर्निहित VAST नहीं, चाहिएplyr-adsGoogle IMA समर्थन वाला प्लगइन
• Flowplayer- Commercial संस्करण में VAST बिल्ट-इन, प्लगइनflowplayer-ima
• Bitmovin Player- अंतर्निहित AdsModule, कॉन्फ़िग:{ ads: [{ tag: { url: "https://sladu.net/vast/...", type: "vast" }, position: "pre" }] }
• Brightcove- प्लगइन के ज़रिएbc-vast-ads-plugin
• Shaka Player - shaka-player-imaGoogle IMA जोड़ता है

11. टेस्टिंग

VAST URL ब्राउज़र में खोलें

XML दिखना चाहिए। अगर खाली () - आपके जियो के लिए उपयुक्त क्रिएटिव नहीं।

Google IMA Sample Player

googleads.github.io/googleads-ima-html5/vsi- VAST URL डालें, Play दबाएँ - IMA SDK हमारा VAST कैसे संभालता है देखें।

IAB VAST Inspector

vasttester.iabtechlab.com- IAB का आधिकारिक इंस्पेक्टर। XML के स्पेसिफ़िकेशन से मेल की जाँच करता है।

curl

curl -v "https://sladu.net/vast/abc12345.xml" \
     -H "Referer: https://yoursite.com/page" \
     -H "User-Agent: Mozilla/5.0 (X11; Linux) Chrome/120"

12. इवेंट ट्रैकिंग

अभी VAST उत्तर में हम न्यूनतम ट्रैकर भेजते हैं:

• - इम्प्रेशन गिना गया
• - हमारे click-tracking वाला URL

अनुरोध पर जोड़ सकते हैंइनके लिए:

• start- वीडियो चलना शुरू हुआ
• firstQuartile, midpoint, thirdQuartile- 25/50/75% देखा गया
• complete- वीडियो अंत तक देखा गया
• skip- यूज़र ने skip दबाया
• mute, unmute, pause, resume, fullscreen

अभी बिलिंग के लिए इनकी ज़रूरत नहीं - इम्प्रेशन ही गिनते हैं। अगर विज्ञापनदाता CPV (cost per view, 100% देखना) देता है - सपोर्ट को टिकट पर चालू करते हैं।