IMA SDKগুলি আপনার ওয়েবসাইট এবং অ্যাপগুলিতে মাল্টিমিডিয়া বিজ্ঞাপনগুলিকে একীভূত করা সহজ করে তোলে৷ IMA SDK যেকোন VAST-সঙ্গী বিজ্ঞাপন সার্ভার থেকে বিজ্ঞাপনের অনুরোধ করতে পারে এবং আপনার অ্যাপে বিজ্ঞাপন প্লেব্যাক পরিচালনা করতে পারে। IMA ক্লায়েন্ট-সাইড SDK-এর সাথে, আপনি সামগ্রী ভিডিও প্লেব্যাকের নিয়ন্ত্রণ বজায় রাখেন, যখন SDK বিজ্ঞাপন প্লেব্যাক পরিচালনা করে। বিজ্ঞাপনগুলি অ্যাপের বিষয়বস্তু ভিডিও প্লেয়ারের উপরে অবস্থান করা একটি পৃথক ভিডিও প্লেয়ারে চলে৷
এই নির্দেশিকাটি দেখায় কিভাবে একটি সাধারণ ভিডিও প্লেয়ার অ্যাপে IMA SDK সংহত করা যায়। আপনি যদি একটি সম্পূর্ণ নমুনা ইন্টিগ্রেশন সহ দেখতে বা অনুসরণ করতে চান, GitHub থেকে সাধারণ উদাহরণটি ডাউনলোড করুন। আপনি যদি SDK প্রি-ইন্টিগ্রেটেড একটি HTML5 প্লেয়ারে আগ্রহী হন, তাহলে Video.js-এর জন্য IMA SDK প্লাগইনটি দেখুন।
IMA ক্লায়েন্ট-সাইড ওভারভিউ
IMA ক্লায়েন্ট-সাইড বাস্তবায়নে চারটি প্রধান SDK উপাদান জড়িত, যা এই নির্দেশিকায় প্রদর্শিত হয়েছে:
-
AdDisplayContainer
: একটি কন্টেইনার অবজেক্ট যা IMA বিজ্ঞাপন UI উপাদানগুলিকে কোথায় রেন্ডার করে এবং সক্রিয় ভিউ এবং ওপেন মেজারমেন্ট সহ দর্শনযোগ্যতা পরিমাপ করে তা নির্দিষ্ট করে৷ -
AdsLoader
: একটি বস্তু যা বিজ্ঞাপনের অনুরোধ করে এবং বিজ্ঞাপনের অনুরোধের প্রতিক্রিয়া থেকে ইভেন্ট পরিচালনা করে। আপনার শুধুমাত্র একটি বিজ্ঞাপন লোডার ইনস্ট্যান্টিয়েট করা উচিত, যা অ্যাপ্লিকেশনের সারাজীবন জুড়ে পুনরায় ব্যবহার করা যেতে পারে। -
AdsRequest
: একটি বস্তু যা একটি বিজ্ঞাপন অনুরোধ সংজ্ঞায়িত করে। বিজ্ঞাপনের অনুরোধগুলি VAST বিজ্ঞাপন ট্যাগের জন্য URL উল্লেখ করে, সেইসাথে অতিরিক্ত প্যারামিটার, যেমন বিজ্ঞাপনের মাত্রা। -
AdsManager
: একটি বস্তু যা বিজ্ঞাপনের অনুরোধের প্রতিক্রিয়া ধারণ করে, বিজ্ঞাপন প্লেব্যাক নিয়ন্ত্রণ করে এবং SDK দ্বারা চালিত বিজ্ঞাপন ইভেন্টগুলি শোনে।
পূর্বশর্ত
আপনি শুরু করার আগে, আপনার নিম্নলিখিতগুলির প্রয়োজন হবে:
- তিনটি খালি ফাইল:
- index.html
- style.css
- ads.js
- আপনার কম্পিউটারে পাইথন ইনস্টল করা, বা পরীক্ষার জন্য ব্যবহার করার জন্য একটি ওয়েব সার্ভার
1. একটি ডেভেলপমেন্ট সার্ভার শুরু করুন
যেহেতু IMA SDK যে পৃষ্ঠা থেকে এটি লোড করা হয়েছে সেই একই প্রোটোকল ব্যবহার করে নির্ভরতা লোড করে, তাই আপনার অ্যাপটি পরীক্ষা করার জন্য আপনাকে একটি ওয়েব সার্ভার ব্যবহার করতে হবে৷ একটি স্থানীয় উন্নয়ন সার্ভার শুরু করার সবচেয়ে সহজ উপায় হল পাইথনের অন্তর্নির্মিত সার্ভার ব্যবহার করা।
- একটি কমান্ড লাইন ব্যবহার করে, যে ডিরেক্টরিতে আপনার index.html ফাইল রয়েছে তা থেকে রান করুন:
python -m http.server 8000
- একটি ওয়েব ব্রাউজারে,
http://localhost:8000/
এ যান
আপনি অন্য কোনো ওয়েব সার্ভারও ব্যবহার করতে পারেন, যেমন Apache HTTP সার্ভার ।
2. একটি সাধারণ ভিডিও প্লেয়ার তৈরি করুন৷
প্রথমে, একটি সাধারণ HTML5 ভিডিও উপাদান তৈরি করতে index.html সংশোধন করুন, একটি মোড়ানো উপাদানে রয়েছে, এবং প্লেব্যাক ট্রিগার করার জন্য একটি বোতাম৷ নিম্নলিখিত উদাহরণটি IMA SDK আমদানি করে এবং AdDisplayContainer
কন্টেইনার উপাদান সেট আপ করে। আরও বিশদ বিবরণের জন্য, যথাক্রমে IMA SDK আমদানি করুন এবং বিজ্ঞাপন ধারক তৈরি করুন ধাপগুলি দেখুন৷
style.css এবং ads.js ফাইল লোড করতে প্রয়োজনীয় ট্যাগ যোগ করুন। তারপর, ভিডিও প্লেয়ারটিকে মোবাইল ডিভাইসের জন্য প্রতিক্রিয়াশীল করতে styles.css পরিবর্তন করুন৷ অবশেষে, ads.js- এ, আপনার ভেরিয়েবল ঘোষণা করুন এবং আপনি প্লে বোতামে ক্লিক করলে ভিডিও প্লেব্যাক ট্রিগার করুন।
মনে রাখবেন যে ads.js কোড স্নিপেটে setUpIMA()
তে একটি কল রয়েছে, যেটি বিজ্ঞাপন লোডার শুরু করুন এবং একটি বিজ্ঞাপন অনুরোধ করুন বিভাগে সংজ্ঞায়িত করা হয়েছে।
3. IMA SDK আমদানি করুন৷
এরপর, ads.js
এর ট্যাগের আগে, index.html- এ একটি স্ক্রিপ্ট ট্যাগ ব্যবহার করে IMA ফ্রেমওয়ার্ক যোগ করুন।
4. বিজ্ঞাপন ধারক তৈরি করুন
বেশিরভাগ ব্রাউজারে, IMA SDK বিজ্ঞাপন এবং বিজ্ঞাপন-সম্পর্কিত UI উপাদান উভয়ই প্রদর্শনের জন্য একটি ডেডিকেটেড বিজ্ঞাপন কন্টেইনার উপাদান ব্যবহার করে। উপরের-বাম কোণ থেকে ভিডিও উপাদানটি ওভারলে করার জন্য এই ধারকটিকে অবশ্যই আকার দিতে হবে। এই কন্টেইনারে রাখা বিজ্ঞাপনের উচ্চতা এবং প্রস্থ adsManager
অবজেক্ট দ্বারা সেট করা হয়, তাই আপনাকে ম্যানুয়ালি এই মানগুলি সেট করতে হবে না।
এই বিজ্ঞাপন কন্টেইনার উপাদান বাস্তবায়ন করতে, প্রথমে video-container
উপাদানের মধ্যে একটি নতুন div
তৈরি করুন। তারপরে, video-element
উপরের-বাম কোণে উপাদানটিকে অবস্থান করতে CSS আপডেট করুন। সবশেষে, নতুন অ্যাড কন্টেইনার div
ব্যবহার করে AdDisplayContainer
অবজেক্ট তৈরি করতে createAdDisplayContainer()
ফাংশন যোগ করুন।
5. অ্যাডসলোডার শুরু করুন এবং একটি বিজ্ঞাপনের অনুরোধ করুন৷
বিজ্ঞাপনের অনুরোধ করার জন্য, একটি AdsLoader
উদাহরণ তৈরি করুন। AdsLoader
কনস্ট্রাক্টর একটি AdDisplayContainer
অবজেক্টকে একটি ইনপুট হিসাবে নেয় এবং একটি নির্দিষ্ট বিজ্ঞাপন ট্যাগ URL এর সাথে যুক্ত AdsRequest
অবজেক্ট প্রক্রিয়া করতে ব্যবহার করা যেতে পারে। এই উদাহরণে ব্যবহৃত বিজ্ঞাপন ট্যাগে একটি 10-সেকেন্ডের প্রি-রোল বিজ্ঞাপন রয়েছে৷ আপনি IMA ভিডিও স্যুট ইন্সপেক্টর ব্যবহার করে এটি বা যেকোনো বিজ্ঞাপন ট্যাগ URL পরীক্ষা করতে পারেন।
একটি সর্বোত্তম অনুশীলন হিসাবে, একটি পৃষ্ঠার সমগ্র জীবনচক্রের জন্য AdsLoader
এর শুধুমাত্র একটি উদাহরণ বজায় রাখুন। অতিরিক্ত বিজ্ঞাপনের অনুরোধ করতে, একটি নতুন AdsRequest
অবজেক্ট তৈরি করুন, কিন্তু একই AdsLoader
পুনরায় ব্যবহার করুন। আরও তথ্যের জন্য, IMA SDK FAQ দেখুন।
AdsLoader.addEventListener
ব্যবহার করে বিজ্ঞাপন লোড হওয়া এবং ত্রুটির ইভেন্টগুলি শুনুন এবং প্রতিক্রিয়া জানান। নিম্নলিখিত ঘটনাগুলি শুনুন:
-
ADS_MANAGER_LOADED
-
AD_ERROR
onAdsManagerLoaded()
এবং onAdError()
শ্রোতা তৈরি করতে, নিম্নলিখিত উদাহরণটি দেখুন:
6. AdsLoader ইভেন্টে সাড়া দিন
যখন AdsLoader
সফলভাবে বিজ্ঞাপন লোড করে, তখন এটি একটি ADS_MANAGER_LOADED
ইভেন্ট নির্গত করে। AdsManager
অবজেক্ট শুরু করতে কলব্যাকে পাস করা ইভেন্ট পার্স করুন। AdsManager
বিজ্ঞাপন ট্যাগ URL-এর প্রতিক্রিয়া দ্বারা সংজ্ঞায়িত পৃথক বিজ্ঞাপনগুলিকে লোড করে।
নিশ্চিত করুন যে আপনি লোডিং প্রক্রিয়া চলাকালীন যে কোনও ত্রুটি পরিচালনা করেছেন। বিজ্ঞাপনগুলি লোড না হলে, ব্যবহারকারীর বিষয়বস্তু দেখার সাথে হস্তক্ষেপ এড়াতে বিজ্ঞাপন ছাড়াই মিডিয়া প্লেব্যাক চলতে থাকে তা নিশ্চিত করুন৷
onAdsManagerLoaded()
ফাংশনে সেট করা শ্রোতাদের সম্পর্কে আরও বিশদ বিবরণের জন্য, নিম্নলিখিত উপ-বিভাগগুলি দেখুন:
AdsManager
ত্রুটিগুলি পরিচালনা করুন৷
AdsLoader
জন্য তৈরি করা ত্রুটির হ্যান্ডলারটি AdsManager
এর ত্রুটি হ্যান্ডলার হিসেবেও কাজ করতে পারে। onAdError()
ফাংশন পুনরায় ব্যবহার করে ইভেন্ট হ্যান্ডলার দেখুন।
খেলা পরিচালনা এবং ইভেন্ট বিরতি
যখন AdsManager
প্রদর্শনের জন্য একটি বিজ্ঞাপন সন্নিবেশ করার জন্য প্রস্তুত হয়, তখন এটি CONTENT_PAUSE_REQUESTED
ইভেন্টটি চালু করে। অন্তর্নিহিত ভিডিও প্লেয়ারে একটি বিরতি ট্রিগার করে এই ইভেন্টটি পরিচালনা করুন৷ একইভাবে, যখন একটি বিজ্ঞাপন সম্পূর্ণ হয়, AdsManager
CONTENT_RESUME_REQUESTED
ইভেন্টটি বরখাস্ত করে। অন্তর্নিহিত বিষয়বস্তু ভিডিওতে প্লেব্যাক পুনরায় চালু করে এই ইভেন্টটি পরিচালনা করুন।
onContentPauseRequested()
এবং onContentResumeRequested()
ফাংশনের সংজ্ঞার জন্য, নিম্নলিখিত উদাহরণটি দেখুন:
নন-লিনিয়ার বিজ্ঞাপনের সময় কন্টেন্ট প্লেব্যাক পরিচালনা করুন
যখন একটি বিজ্ঞাপন চালানোর জন্য প্রস্তুত থাকে তখন AdsManager
কন্টেন্ট ভিডিওকে বিরতি দেয়, কিন্তু এই আচরণটি নন-লিনিয়ার বিজ্ঞাপনের জন্য দায়ী নয়, যেখানে বিজ্ঞাপনটি প্রদর্শিত হওয়ার সময় বিষয়বস্তু চলতে থাকে।
নন-লিনিয়ার বিজ্ঞাপনগুলিকে সমর্থন করতে, LOADED
ইভেন্ট নির্গত করার জন্য AdsManager
কথা শুনুন। বিজ্ঞাপনটি রৈখিক কিনা তা পরীক্ষা করুন এবং যদি না হয়, ভিডিও উপাদানটিতে প্লেব্যাক পুনরায় শুরু করুন৷
onAdLoaded()
ফাংশনের সংজ্ঞার জন্য, নিম্নলিখিত উদাহরণটি দেখুন।
7. মোবাইল ডিভাইসে ক্লিক-টু-পজ ট্রিগার করুন
যেহেতু AdContainer
ভিডিও উপাদানকে ওভারলে করে, ব্যবহারকারীরা অন্তর্নিহিত প্লেয়ারের সাথে সরাসরি যোগাযোগ করতে পারে না। এটি মোবাইল ডিভাইসে ব্যবহারকারীদের বিভ্রান্ত করতে পারে, যারা প্লেব্যাক বিরাম দিতে একটি ভিডিও প্লেয়ারে ট্যাপ করতে সক্ষম হবে বলে আশা করে৷ এই সমস্যাটির সমাধান করার জন্য, IMA SDK বিজ্ঞাপন ওভারলে থেকে IMA দ্বারা পরিচালিত নয় এমন যেকোন ক্লিকগুলিকে AdContainer
উপাদানে পাস করে, যেখানে সেগুলি পরিচালনা করা যেতে পারে। এটি নন-মোবাইল ব্রাউজারে রৈখিক বিজ্ঞাপনের ক্ষেত্রে প্রযোজ্য নয়, কারণ বিজ্ঞাপনটিতে ক্লিক করলে ক্লিকথ্রু লিঙ্কটি খোলে।
ক্লিক-টু-পজ বাস্তবায়ন করতে, adContainerClick()
ক্লিক হ্যান্ডলার ফাংশন যোগ করুন যা অন উইন্ডো লোড লিসেনারে বলা হয়।
8. অ্যাডস ম্যানেজার শুরু করুন
বিজ্ঞাপন প্লেব্যাক শুরু করতে, শুরু করুন এবং শুরু করুন AdsManager
। মোবাইল ব্রাউজারগুলিকে সম্পূর্ণরূপে সমর্থন করতে, যেখানে আপনি স্বয়ংক্রিয়ভাবে বিজ্ঞাপনগুলি চালাতে পারবেন না, পৃষ্ঠার সাথে ব্যবহারকারীর ইন্টারঅ্যাকশন থেকে বিজ্ঞাপন প্লেব্যাক ট্রিগার করুন, যেমন প্লে বোতামে ক্লিক করা।
9. প্লেয়ার রিসাইজিং সমর্থন করে
বিজ্ঞাপনগুলি গতিশীলভাবে আকার পরিবর্তন করতে এবং একটি ভিডিও প্লেয়ারের আকারের সাথে মেলে, বা স্ক্রীনের অভিযোজনে পরিবর্তনগুলিকে মেলানোর জন্য, উইন্ডোর আকার পরিবর্তনের ইভেন্টগুলির প্রতিক্রিয়া হিসাবে adsManager.resize()
এ কল করুন৷
তাই তো! আপনি এখন অনুরোধ করছেন এবং IMA SDK-এর সাথে বিজ্ঞাপন প্রদর্শন করছেন৷ আরও উন্নত SDK বৈশিষ্ট্য সম্পর্কে জানতে, GitHub-এ অন্যান্য গাইড বা নমুনাগুলি দেখুন।