এই গাইডে Pod পরিবেশন API এবং আপনার ম্যানিফেস্ট ম্যানিপুলেটর সহ HLS বা DASH লাইভস্ট্রিম লোড করার জন্য একটি ক্লায়েন্ট অ্যাপ্লিকেশন ডেভেলপ করার বিষয়ে আলোচনা করা হয়েছে।
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, আপনার কাছে নিম্নলিখিতগুলি থাকতে হবে:
Pod serving redirectDAI ধরনের সাথে কনফিগার করা লাইভ স্ট্রিম ইভেন্টের জন্য কাস্টম অ্যাসেট কী। এই 'কী' পেতে, এগুলি অনুসরণ করুন:LiveStreamEventঅবজেক্ট এবংdynamicAdInsertionTypeপ্রপার্টিPOD_SERVING_REDIRECTenum ভ্যালুতে সেট করেLiveStreamEventService.createLiveStreamEventsমেথড কল করতে SOAP API ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন। সব ক্লায়েন্ট লাইব্রেরির জন্য, ক্লায়েন্ট লাইব্রেরি এবং উদাহরণ কোড দেখুন।
আপনার প্ল্যাটফর্মের জন্য Interactive Media Ads (IMA) SDK উপলভ্য কিনা তা নির্ধারণ করুন। মোট উপার্জন বাড়াতে আমরা IMA SDK ব্যবহার করার সাজেশন দিই। আরও জানতে, DAI-এর জন্য IMA SDK সেট-আপ করুন লিঙ্ক দেখুন।
স্ট্রিম করার অনুরোধ করা
আপনার ব্যবহারকারী কোনও স্ট্রিম বেছে নিলে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
লাইভস্ট্রিম পরিষেবা পদ্ধতিতে
POSTঅনুরোধ করুন। আরও জানতে, পদ্ধতি: স্ট্রিম দেখুন।application/x-www-form-urlencodedবাapplication/jsonফর্ম্যাটে বিজ্ঞাপন টার্গেটিং প্যারামিটার পাস করুন। এই অনুরোধ Google DAI-এর সাথে একটি স্ট্রিম সেশন রেজিস্টার করে।নিম্নলিখিত উদাহরণটি একটি স্ট্রিম অনুরোধ করে:
ফর্ম এনকোডিং
const url = `https://dai.google.com/ssai/pods/api/v1/` + `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`; const params = new URLSearchParams({ cust_params: 'section=sports&page=golf,tennis' }).toString(); const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: params }); console.log(await response.json());JSON এনকোডিং
const url = `https://dai.google.com/ssai/pods/api/v1/` + `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`; const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ cust_params: { section: 'sports', page: 'golf,tennis' } }) }); console.log(await response.json());সফল হলে, আপনি নিম্নলিখিত আউটপুটের মতো আউটপুট দেখতে পাবেন:
{ "stream_id": "c4a5dad5-aaa8-4550-8acb-7cda3cdb21bb:DLS", "media_verification_url": "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/", "metadata_url": "https://dai.google.com/linear/pods/hls/.../metadata", "session_update_url": "https://dai.google.com/linear/.../session", "polling_frequency": 10 }JSON উত্তরে, স্ট্রিম সেশন আইডি খুঁজে নিন এবং পরবর্তী ধাপের জন্য অন্যান্য ডেটা স্টোর করুন।
পোল বিজ্ঞাপনের মেটাডেটা
বিজ্ঞাপনের মেটাডেটা পোল করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
স্ট্রিম রেজিস্ট্রেশন রেসপন্স থেকে
metadata_urlভ্যালু পড়ুন।metadata_urlএন্ডপয়েন্টে প্রাথমিকGETঅনুরোধ করুন।delta_tokenকোয়েরি প্যারামিটার বাদ দিন। এই প্রসেসের মাধ্যমে সার্ভার স্ট্রিমের ডিজিটাল ভিডিও রেকর্ডার (DVR) উইন্ডোর জন্য সম্পূর্ণ মেটাডেটা ফেরত পাঠাতে পারে। DVR উইন্ডোতে ব্রডকাস্টের টাইমফ্রেম থাকে যা দর্শক রিওয়াইন্ড করে দেখতে পারেন। উত্তরে একটিnext_delta_tokenফিল্ড রয়েছে।
ব্যান্ডউইথ অপ্টিমাইজ করতে, সবচেয়ে সাম্প্রতিক রেসপন্স থেকে
next_delta_tokenভ্যালু স্টোর করুন।আপনার পরবর্তী অনুরোধে, সেই ভ্যালু
delta_tokenকোয়েরি প্যারামিটার হিসেবে পাঠান। সার্ভার শুধুমাত্র সেই মেটাডেটা ফেরত দেয় যা টোকেন জেনারেট হওয়ার পর থেকে পরিবর্তিত হয়েছে। আপনি যে লেটেস্ট টোকেন পেয়েছেন সেটি সবসময় পাঠান। টোকেন পার্স, পরিবর্তন বা তৈরি করার চেষ্টা করবেন না। আরও বিস্তারিত জানতে, পদ্ধতি: মেটাডেটা দেখুন।নিম্নলিখিত উদাহরণটি বিজ্ঞাপনের মেটাডেটা ফেচ করে:
// Initial request (returns full metadata and next_delta_token) let response = await fetch(metadata_url); let metadata = await response.json(); let deltaToken = metadata.next_delta_token; // Subsequent request (returns only changes since deltaToken) if (deltaToken) { const url = new URL(metadata_url); url.searchParams.append('delta_token', deltaToken); response = await fetch(url.toString()); const deltaMetadata = await response.json(); // Merge deltaMetadata into your local cache mergeMetadata(metadata, deltaMetadata); deltaToken = deltaMetadata.next_delta_token; }এটি সম্পূর্ণ হলে, আপনি PodMetadata উত্তর পাবেন। আপনি
delta_tokenপ্যারামিটার প্রদান করলে, উত্তরে শুধুমাত্র সেইসব বিজ্ঞাপন, বিজ্ঞাপন বিরতি এবং ট্যাগ থাকে যা সার্ভার টোকেন জেনারেট করার পর থেকে সার্ভার যোগ বা আপডেট করেছে। উত্তরে নতুনnext_delta_tokenমানও রয়েছে। কোনও বিজ্ঞাপন বিরতি পুরনো হয়ে গেলে, আপনার ক্যাশে থেকে সরিয়ে দেওয়ার জন্যobsolete_ad_break_idsবিজ্ঞাপন বিরতির তালিকাও উত্তরে অন্তর্ভুক্ত থাকে।{ "next_delta_token": "eyJyYW5nZXMiOlt7InMiOjEsImUiOjN9XX0", "obsolete_ad_break_ids": ["0003069407"], "tags":{ "google_1022389921":{ "ad":"0003069408_ad1", "ad_break_id":"0003069408", "type":"start" }, ... }, "ads":{ "0003069408_ad1":{ "ad_break_id":"0003069408", "position":1, "duration":10.01, "title":"External - Pod Midroll 1", "clickthrough_url":"https://.../", ... }, ... }, "ad_breaks":{ "0003069408":{ "type":"mid", "duration":30, "ads":3 }, ... } }tagsঅবজেক্ট সেভ করুন এবং আপনার লোকাল ক্যাশেতে আপডেট মার্জ করুন।obsolete_ad_break_idsপ্যারামিটার থাকলে, সেইসব বিজ্ঞাপন বিরতি এবং সংশ্লিষ্ট বিজ্ঞাপন ও ট্যাগ আপনার ক্যাশে থেকে সরিয়ে দিন।নিয়মিত মেটাডেটার অনুরোধ করতে
polling_frequencyভ্যালু ব্যবহার করে টাইমার সেট করুন। প্রতিটি পোলে,delta_tokenকোয়েরি প্যারামিটার হিসেবে সবচেয়ে সাম্প্রতিক মেটাডেটা উত্তরে ফেরত আসাnext_delta_tokenভ্যালু পাঠান।
আপনার ভিডিও প্লেয়ারে স্ট্রিম লোড করুন
রেজিস্ট্রেশন রেসপন্স থেকে সেশন আইডি পাওয়ার পরে, আপনার ম্যানিফেস্ট ম্যানিপুলেটরে আইডি পাস করুন অথবা ভিডিও প্লেয়ারে স্ট্রিম লোড করার জন্য ম্যানিফেস্ট URL তৈরি করুন।
সেশন আইডি পাস করতে, আপনার ম্যানিফেস্ট ম্যানিপুলেটর ডকুমেন্টেশন দেখুন। আপনি যদি ম্যানিফেস্ট ম্যানিপুলেটর ডেভেলপ করেন, তাহলে লাইভ স্ট্রিমের জন্য ম্যানিফেস্ট ম্যানিপুলেটর দেখুন।
নিম্নলিখিত উদাহরণটি একটি ম্যানিফেস্ট URL অ্যাসেম্বল করে:
https://<your_manifest_manipulator_url>/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY"
আপনার প্লেয়ার রেডি হয়ে গেলে, প্লেব্যাক শুরু করুন।
বিজ্ঞাপন ইভেন্টের জন্য শুনুন
টাইমড মেটাডেটার জন্য আপনার স্ট্রিমের কন্টেনার ফর্ম্যাট চেক করুন:
ট্রান্সপোর্ট স্ট্রিম (TS) কন্টেনার সহ HLS স্ট্রিম, টাইমড মেটাডেটা বহন করার জন্য টাইমড ID3 ট্যাগ ব্যবহার করে। বিস্তারিত জানতে, HTTP লাইভ স্ট্রিমিং (HLS) সহ কমন মিডিয়া অ্যাপ্লিকেশন ফর্ম্যাট সম্পর্কে দেখুন।
DASH স্ট্রিমে ম্যানিফেস্টে ইভেন্ট নির্দিষ্ট করতে
EventStreamএলিমেন্ট ব্যবহার করা হয়।DASH স্ট্রিমে
InbandEventStreamএলিমেন্ট ব্যবহার করা হয় যখন সেগমেন্টে ID3 ট্যাগ সহ পেলোড ডেটার জন্য ইভেন্ট মেসেজ (emsg) বক্স থাকে। বিস্তারিত জানতে, InbandEventStream দেখুন।DASH ও HLS সহ CMAF স্ট্রিমে ID3 ট্যাগ সহ
emsgবক্স ব্যবহার করা হয়।
আপনার স্ট্রিম থেকে ID3 ট্যাগ ফিরিয়ে আনতে, ভিডিও প্লেয়ারের নির্দেশিকা দেখুন। আরও জানতে, টাইমড মেটাডেটা গাইড দেখুন
ID3 ট্যাগ থেকে বিজ্ঞাপন ইভেন্ট আইডি ফিরিয়ে আনতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
urn:google:dai:2018বাhttps://aomedia.org/emsg/ID3-এর সাথেscheme_id_uri-এর মাধ্যমে ইভেন্ট ফিল্টার করুন।message_dataফিল্ড থেকে বাইট অ্যারে এক্সট্র্যাক্ট করুন।নিম্নলিখিত উদাহরণ
emsgডেটাকে JSON-এ ডিকোড করে:{ "scheme_id_uri": "https://developer.apple.com/streaming/emsg-id3", "presentation_time": 27554, "timescale": 1000, "message_data": "ID3TXXXgoogle_1022389921", ... }TXXXgoogle_{ad_event_ID}ফর্ম্যাট সহ ID3 ট্যাগ ফিল্টার করুন:TXXXgoogle_1022389921
বিজ্ঞাপন ইভেন্ট ডেটা দেখান
TagSegment
অবজেক্টটি খুঁজতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
বিজ্ঞাপন মেটাডেটা পোল করুন থেকে বিজ্ঞাপন মেটাডেটা
tagsঅবজেক্ট ফিরিয়ে আনুন।tagsঅবজেক্ট হলTagSegmentঅবজেক্টের একটি অ্যারে।progressধরনেরTagSegmentঅবজেক্ট খুঁজতে সম্পূর্ণ বিজ্ঞাপন ইভেন্ট আইডি ব্যবহার করুন।অন্য ধরনের
TagSegmentঅবজেক্ট খুঁজতে বিজ্ঞাপন ইভেন্ট আইডির প্রথম ১৭টি অক্ষর ব্যবহার করুন।আপনার ক্লায়েন্ট অ্যাপ নির্দিষ্ট সময় অন্তর বিজ্ঞাপনের মেটাডেটা পোল করে বলে, আপনার ভিডিও প্লেয়ার স্ট্রিমে ID3 ট্যাগ শনাক্ত করা এবং সংশ্লিষ্ট মেটাডেটা উপলভ্য হওয়ার মধ্যে সময়ের ব্যবধান থাকতে পারে। আপনার ক্লায়েন্ট অ্যাপ সেভ করা ট্যাগের মধ্যে ID3 ট্যাগ খুঁজে না পেলে, ট্যাগটি সারিতে রাখুন এবং পরবর্তী মেটাডেটা পোলিংয়ের পরে ট্যাগটি আবার প্রসেস করুন। প্রসেসিং শেষ না হওয়া পর্যন্ত ট্যাগটি সারিতে রাখুন।
TagSegmentপাওয়ার পরে, বিজ্ঞাপন মেটাডেটাad_breaksঅবজেক্টেAdBreakঅবজেক্ট খুঁজতেad_break_idপ্রপার্টিকে কী হিসেবে ব্যবহার করুন।নিচের উদাহরণটি একটি
AdBreakঅবজেক্ট খুঁজে পায়:{ "type":"mid", "duration":15, "ads":1 }বিজ্ঞাপন বিরতিতে বিজ্ঞাপনের পজিশন সম্পর্কে তথ্য দেখাতে
TagSegmentএবংAdBreakডেটা ব্যবহার করুন। যেমন,Ad 1 of 3।
মিডিয়া যাচাইকরণ পিং পাঠান
progress ধরন ছাড়া প্রতিটি বিজ্ঞাপন ইভেন্টের জন্য, একটি মিডিয়া যাচাইকরণ পিং পাঠান।
Google DAI progress ইভেন্ট বাতিল করে দেয় এবং এইসব ইভেন্ট ঘনঘন পাঠালে আপনার অ্যাপের পারফর্ম্যান্সের উপর প্রভাব পড়তে পারে।
কোনও বিজ্ঞাপন ইভেন্টের সম্পূর্ণ মিডিয়া যাচাইকরণ URL তৈরি করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
স্ট্রিম রেসপন্স থেকে, সম্পূর্ণ বিজ্ঞাপন ইভেন্ট আইডি
media_verification_urlভ্যালুতে যোগ করুন।সম্পূর্ণ URL সহ
GETঅনুরোধ করুন:// media_verification_url: "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/" const completeUrl = `${media_verification_url}google_1022389921`; const response = await fetch(completeUrl);সফল হলে, আপনি কোড স্ট্যাটাস
202রেসপন্স পাবেন। অন্যথায়, আপনি404ত্রুটি কোড পাবেন।
আপনি স্ট্রিম অ্যাক্টিভিটি মনিটর (SAM) ব্যবহার করে সব বিজ্ঞাপন ইভেন্টের ঐতিহাসিক লগ পরীক্ষা করতে পারেন। আরও বিবরণের জন্য, লাইভস্ট্রিম মনিটর করা ও সমস্যার সমাধান করা দেখুন