এই নির্দেশিকায় ভিডিও প্লেয়ার অ্যাপে IMA DAI SDK ইন্টিগ্রেট করার ব্যাপারে আলোচনা করা হয়েছে। আপনি যদি সম্পূর্ণ স্যাম্পেল ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে চান, তাহলে GitHub থেকে BasicExample ডাউনলোড করুন।
IMA DAI ওভারভিউ
IMA DAI প্রয়োগ করার ক্ষেত্রে চারটি প্রধান SDK কম্পোনেন্ট থাকে, যেমন এই গাইডে দেখানো হয়েছে:
IMAAdDisplayContainer– একটি কন্টেনার অবজেক্ট যা ভিডিও প্লেব্যাক এলিমেন্টের উপরে থাকে এবং বিজ্ঞাপনের UI এলিমেন্টগুলি ধারণ করে।IMAAdsLoader– একটি অবজেক্ট যা স্ট্রিমের অনুরোধ করে এবং স্ট্রিমের অনুরোধের রেসপন্স অবজেক্টের মাধ্যমে ট্রিগার করা ইভেন্টগুলি পরিচালনা করে। আপনাকে শুধুমাত্র একটি বিজ্ঞাপন লোডার ইনস্ট্যান্টিয়েট করতে হবে, যা অ্যাপ্লিকেশনের লাইফ সাইকেল জুড়ে আবার ব্যবহার করা যেতে পারে।IMAStreamRequest– হয়IMAVODStreamRequestঅথবাIMALiveStreamRequest। একটি অবজেক্ট যা স্ট্রিম অনুরোধকে সংজ্ঞায়িত করে। স্ট্রিম সংক্রান্ত অনুরোধ চাহিদা অনুসার ভিডিও বা লাইভ স্ট্রিমের জন্য হতে পারে। লাইভ স্ট্রিম অনুরোধে অ্যাসেট কী উল্লেখ করা থাকে, যেখানে VOD অনুরোধে CMS আইডি ও ভিডিও আইডি উল্লেখ করা থাকে। উভয় ধরনের অনুরোধে নির্দিষ্ট স্ট্রিম অ্যাক্সেস করার জন্য প্রয়োজনীয় API কী এবং Google Ad Manager সেটিংসে উল্লেখ করা বিজ্ঞাপন শনাক্তকারী ম্যানেজ করার জন্য IMA SDK-এর Google Ad Manager নেটওয়ার্ক কোড ঐচ্ছিকভাবে অন্তর্ভুক্ত থাকতে পারে।IMAStreamManager– একটি অবজেক্ট যা ডায়নামিক বিজ্ঞাপন ইনসার্শন স্ট্রিম এবং DAI ব্যাকএন্ডের সাথে ইন্টার্যাকশন ম্যানেজ করে। এছাড়াও, স্ট্রিম ম্যানেজার ট্র্যাকিং পিং ম্যানেজ করে এবং স্ট্রিম ও বিজ্ঞাপন ইভেন্ট প্রকাশকের কাছে ফরওয়ার্ড করে।
পূর্বশর্ত
শুরু করার আগে, আপনার নিম্নলিখিতগুলি প্রয়োজন:
- Xcode 13 বা তার পরবর্তী ভার্সন
- IMA SDK ইনস্টল করার পদ্ধতি:
- Swift প্যাকেজ ম্যানেজার (preferred)
- iOS-এর জন্য IMA SDK-এর ডাউনলোড করা কপি
এছাড়াও, IMA SDK থেকে আপনার স্ট্রিমের অনুরোধ করার জন্য প্যারামিটার প্রয়োজন। অনুরোধের প্যারামিটারের উদাহরণ দেখতে, স্যাম্পেল স্ট্রিম দেখুন।
| লাইভ স্ট্রিম প্যারামিটার | |
|---|---|
| অ্যাসেট কী |
অ্যাসেট কী
Google Ad Manager-এ আপনার লাইভ স্ট্রিম শনাক্ত করে। উদাহরণ: c-rArva4ShKVIAkNfy6HUQ
|
| VOD স্ট্রিম প্যারামিটার | |
| কন্টেন্ট সোর্স আইডি |
Google Ad Manager থেকে পাওয়া
কন্টেন্ট সোর্স
আইডি। উদাহরণ: 2548831
|
| ভিডিও আইডি |
Google Ad Manager থেকে পাওয়া ভিডিও আইডি। উদাহরণ: tears-of-steel
|
| সাধারণ (VOD এবং লাইভস্ট্রিম) প্যারামিটার | |
| নেটওয়ার্ক কোড |
আপনার Google Ad Manager নেটওয়ার্ক কোড। উদাহরণ: 21775744923
|
নতুন Xcode প্রোজেক্ট তৈরি করুন
Xcode-এ, Objective-C ব্যবহার করে "BasicExample" নামে একটি নতুন iOS প্রোজেক্ট তৈরি করুন।
Xcode প্রোজেক্টে IMA DAI SDK যোগ করুন
IMA SDK ইনস্টল করতে, পছন্দের পদ্ধতি বেছে নিন।
সাজেস্ট করা: Swift প্যাকেজ ম্যানেজার ব্যবহার করে SDK ইনস্টল করুন
ইন্টারঅ্যাকটিভ মিডিয়া বিজ্ঞাপন SDK, 3.18.4 ভার্সন থেকে Swift প্যাকেজ ম্যানেজার-এ কাজ করে। Swift প্যাকেজ ইমপোর্ট করতে এইসব ধাপ অনুসরণ করুন।
Xcode-এ, IMA DAI SDK Swift প্যাকেজ ইনস্টল করুন: ফাইল > প্যাকেজ যোগ করুন বিকল্পে নেভিগেট করুন।
যে প্রম্পটটি দেখানো হবে, সেখানে IMA DAI SDK Swift Package GitHub রিপোজিটরি খুঁজুন:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosআপনি IMA DAI SDK Swift প্যাকেজের যে ভার্সন ব্যবহার করতে চান সেটি বেছে নিন। নতুন প্রোজেক্টের জন্য, পরবর্তী মেজর ভার্সন পর্যন্ত বিকল্প ব্যবহার করুন।
আপনার কাজ হয়ে গেলে, Xcode আপনার প্যাকেজ ডিপেন্ডেন্সি সমাধান করে এবং ব্যাকগ্রাউন্ডে সেগুলি ডাউনলোড করে। প্যাকেজ ডিপেন্ডেন্সি কীভাবে যোগ করবেন সেই সম্পর্কে আরও বিস্তারিত জানতে, Apple-এর নিবন্ধ দেখুন।
ম্যানুয়ালি SDK ডাউনলোড ও ইনস্টল করুন
আপনি Swift প্যাকেজ ম্যানেজার ব্যবহার করতে না চাইলে, আপনার প্রোজেক্টে IMA SDK ডাউনলোড করে ম্যানুয়ালি যোগ করুন।
ভিডিও প্লেয়ার তৈরি করুন
আপনার প্রধান ভিউ কন্ট্রোলারে একটি ভিডিও প্লেয়ার প্রয়োগ করুন; UI ভিউতে একটি AV প্লেয়ার র্যাপ করুন। বিজ্ঞাপন UI এলিমেন্ট দেখাতে IMA SDK, UI ভিউ ব্যবহার করে।
Objective-C
Swift
বিজ্ঞাপন লোডার শুরু করুন
আপনার ভিউ কন্ট্রোলারে IMA SDK ইমপোর্ট করুন এবং বিজ্ঞাপন লোডার ও স্ট্রিম ম্যানেজার ইভেন্ট ম্যানেজ করতে
IMAAdsLoaderDelegate
এবং
IMAStreamManagerDelegate
প্রোটোকল গ্রহণ করুন।
IMA SDK-এর মূল কম্পোনেন্ট স্টোর করতে এইসব ব্যক্তিগত প্রপার্টি যোগ করুন:
IMAAdsLoader- আপনার অ্যাপের লাইফটাইম জুড়ে স্ট্রিম সংক্রান্ত অনুরোধ ম্যানেজ করে।
IMAAdDisplayContainer- বিজ্ঞাপনের ইউজার ইন্টারফেস এলিমেন্ট যোগ করা ও ম্যানেজ করার কাজ করে।
IMAAVPlayerVideoDisplay- IMA SDK এবং আপনার মিডিয়া প্লেয়ারের মধ্যে যোগাযোগ স্থাপন করে এবং টাইমড মেটাডেটা ম্যানেজ করে।IMAStreamManager- স্ট্রিম প্লেব্যাক ম্যানেজ করে এবং বিজ্ঞাপন-সম্পর্কিত ইভেন্ট ফায়ার করে।
ভিউ লোড হওয়ার পরে বিজ্ঞাপন লোডার, বিজ্ঞাপন ডিসপ্লে কন্টেনার এবং ভিডিও ডিসপ্লে শুরু করুন।
Objective-C
Swift
স্ট্রিম করার অনুরোধ করা
ব্যবহারকারী প্লে বোতামে প্রেস করলে, নতুন স্ট্রিমের অনুরোধ করুন।
লাইভ স্ট্রিমের জন্য
IMALiveStreamRequest
ক্লাস ব্যবহার করুন। VOD স্ট্রিমের জন্য, IMAVODStreamRequest
ক্লাস ব্যবহার করুন।
স্ট্রিম অনুরোধের জন্য আপনার স্ট্রিম প্যারামিটার এবং আপনার বিজ্ঞাপন ডিসপ্লে কন্টেনার ও ভিডিও ডিসপ্লের রেফারেন্স প্রয়োজন।
Objective-C
Swift
স্ট্রিম লোড ইভেন্ট শুনুন
IMAAdsLoader
ক্লাসটি স্ট্রিম অনুরোধের সফল ইনিশিয়ালাইজেশন বা ব্যর্থতার উপর
IMAAdsLoaderDelegate
মেথড কল করে।
adsLoadedWithData
ডেলিগেট পদ্ধতিতে, আপনার
IMAStreamManagerDelegate সেট করুন।
স্ট্রিম ম্যানেজার শুরু করুন। শুরু করার সময়, স্ট্রিম ম্যানেজার প্লেব্যাক
চালু করে।
failedWithErrorData
ডেলিগেট পদ্ধতিতে, সমস্যাটি লগ করুন। বিকল্প হিসেবে, ব্যাক-আপ স্ট্রিম চালান। DAI পেশাদার পদ্ধতি
দেখুন।
Objective-C
Swift
বিজ্ঞাপন ইভেন্ট শুনুন
IMAStreamManager
আপনার অ্যাপ্লিকেশনে স্ট্রিম ইভেন্ট এবং ত্রুটিগুলি পাস করার জন্য
IMAStreamManagerDelegate
পদ্ধতিগুলিকে কল করে।
এই উদাহরণের জন্য, কনসোলে প্রাথমিক বিজ্ঞাপন ইভেন্ট লগ করুন:
Objective-C
Swift
আপনার অ্যাপ চালান। সফল হলে, IMA SDK-এর মাধ্যমে Google DAI স্ট্রিম অনুরোধ করুন ও চালান। আরও উন্নত SDK ফিচার সম্পর্কে জানতে, বাঁদিকের সাইডবারে তালিকাভুক্ত অন্যান্য গাইড বা GitHub-এ স্যাম্পেল দেখুন।