এই নির্দেশিকায় ভিডিও প্লেয়ার অ্যাপে IMA DAI SDK ইন্টিগ্রেট করার ব্যাপারে আলোচনা করা হয়েছে। আপনি যদি সম্পূর্ণ স্যাম্পেল ইন্টিগ্রেশন দেখতে বা অনুসরণ করতে চান, তাহলে GitHub থেকে PodServingExample ডাউনলোড করুন।
IMA DAI ওভারভিউ
IMA DAI প্রয়োগ করার ক্ষেত্রে চারটি প্রধান SDK কম্পোনেন্ট থাকে, যেমন এই গাইডে দেখানো হয়েছে:
IMAAdDisplayContainer– একটি কন্টেনার অবজেক্ট যা ভিডিও প্লেব্যাক এলিমেন্টের উপরে থাকে এবং বিজ্ঞাপনের UI এলিমেন্টগুলি ধারণ করে।IMAAdsLoader– একটি অবজেক্ট যা স্ট্রিমের অনুরোধ করে এবং স্ট্রিমের অনুরোধের রেসপন্স অবজেক্টের মাধ্যমে ট্রিগার করা ইভেন্টগুলি পরিচালনা করে। আপনাকে শুধুমাত্র একটি বিজ্ঞাপন লোডার ইনস্ট্যান্টিয়েট করতে হবে, যা অ্যাপ্লিকেশনের লাইফ সাইকেল জুড়ে আবার ব্যবহার করা যেতে পারে।IMAStreamRequest– হয়IMAPodVODStreamRequestঅথবাIMAPodStreamRequest।IMAStreamManager– একটি অবজেক্ট যা ডায়নামিক বিজ্ঞাপন ইনসার্শন স্ট্রিম এবং DAI ব্যাকএন্ডের সাথে ইন্টার্যাকশন ম্যানেজ করে। এছাড়াও, স্ট্রিম ম্যানেজার ট্র্যাকিং পিং ম্যানেজ করে এবং স্ট্রিম ও বিজ্ঞাপন ইভেন্ট প্রকাশকের কাছে ফরওয়ার্ড করে।
এছাড়াও, পড সার্ভিং স্ট্রিম চালাতে, একটি কাস্টম VTP হ্যান্ডলার প্রয়োগ করুন। এই কাস্টম VTP হ্যান্ডলার আপনার ভিডিও টেকনিক্যাল পার্টনারকে (VTP) স্ট্রিম আইডি পাঠায় এবং এর সাথে এমন অন্যান্য তথ্যও পাঠায় যা কন্টেন্ট ও স্টিচ করা বিজ্ঞাপন সহ স্ট্রিম ম্যানিফেস্ট ফেরত পাঠানোর জন্য প্রয়োজন হয়। আপনার কাস্টম VTP হ্যান্ডলার কীভাবে প্রয়োগ করবেন সেই বিষয়ে আপনার VTP নির্দেশাবলী প্রদান করে।
পূর্বশর্ত
শুরু করার আগে, আপনার নিম্নলিখিতগুলি প্রয়োজন:
- Xcode 13 বা তার পরবর্তী ভার্সন
- IMA SDK ইনস্টল করার পদ্ধতি:
- Swift প্যাকেজ ম্যানেজার (preferred)
- iOS-এর জন্য IMA SDK-এর ডাউনলোড করা কপি
এছাড়াও, IMA SDK থেকে আপনার স্ট্রিমের অনুরোধ করার জন্য প্যারামিটার প্রয়োজন।
| লাইভ স্ট্রিম প্যারামিটার | |
|---|---|
| নেটওয়ার্ক কোড |
আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড। |
| কাস্টম অ্যাসেট কী |
কাস্টম অ্যাসেট কী যা Ad Manager 360-এ আপনার পড পরিষেবা ইভেন্ট শনাক্ত করে। আপনার ম্যানিফেস্ট ম্যানিপুলেটর বা থার্ড-পার্টি
পড সার্ভিং পার্টনার এটি তৈরি করে। |
| VOD স্ট্রিম প্যারামিটার | |
| নেটওয়ার্ক কোড |
আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড। |
নতুন Xcode প্রোজেক্ট তৈরি করুন
Xcode-এ, Objective-C ব্যবহার করে "PodServingExample" নামে একটি নতুন 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
স্ট্রিম করার অনুরোধ করা
ব্যবহারকারী প্লে বোতামে প্রেস করলে, নতুন স্ট্রিমের অনুরোধ করুন।
লাইভ স্ট্রিমের জন্য
IMAPodStreamRequest
ক্লাস ব্যবহার করুন। VOD স্ট্রিমের জন্য, IMAPodVODStreamRequest
ক্লাস ব্যবহার করুন।
স্ট্রিম অনুরোধের জন্য আপনার স্ট্রিম প্যারামিটার এবং আপনার বিজ্ঞাপন ডিসপ্লে কন্টেনার ও ভিডিও ডিসপ্লের রেফারেন্স প্রয়োজন।
Objective-C
Swift
স্ট্রিম লোড ইভেন্ট শুনুন
IMAAdsLoader
ক্লাসটি স্ট্রিম অনুরোধের সফল ইনিশিয়ালাইজেশন বা ব্যর্থতার উপর
IMAAdsLoaderDelegate
মেথড কল করে।
adsLoadedWithData
ডেলিগেট পদ্ধতিতে, আপনার
IMAStreamManagerDelegate সেট করুন।
আপনার কাস্টম VTP হ্যান্ডলারে স্ট্রিম আইডি পাস করুন এবং স্ট্রিম ম্যানিফেস্ট URL
রিট্রিভ করুন। লাইভ স্ট্রিমের জন্য, আপনার ভিডিও ডিসপ্লেতে ম্যানিফেস্ট URL লোড করুন,
এবং প্লেব্যাক শুরু করুন। VOD স্ট্রিমের জন্য, স্ট্রিম ম্যানেজারের
loadThirdPartyStream
পদ্ধতিতে
ম্যানিফেস্ট URL পাস করুন। এই পদ্ধতি Ad Manager 360 থেকে বিজ্ঞাপন ইভেন্ট ডেটার অনুরোধ করে, তারপর
ম্যানিফেস্ট URL লোড করে এবং প্লেব্যাক শুরু করে।
failedWithErrorData
ডেলিগেট পদ্ধতিতে, সমস্যাটি লগ করুন। বিকল্প হিসেবে, ব্যাক-আপ স্ট্রিম চালান। DAI পেশাদার পদ্ধতি
দেখুন।
Objective-C
Swift
আপনার কাস্টম VTP হ্যান্ডলার প্রয়োগ করুন
কাস্টম VTP হ্যান্ডলার আপনার ভিডিও টেকনিক্যাল পার্টনারকে (VTP) দর্শকের স্ট্রিম আইডি পাঠায়। এর সাথে VTP-এর প্রয়োজনীয় অন্যান্য তথ্যও পাঠানো হয় যাতে কন্টেন্ট ও স্টিচ করা বিজ্ঞাপন সহ স্ট্রিম ম্যানিফেস্ট ফেরত পাঠানো যায়। আপনার VTP কাস্টম VTP হ্যান্ডলার কীভাবে প্রয়োগ করতে হবে সেই বিষয়ে নির্দিষ্ট নির্দেশাবলী প্রদান করে।
যেমন, VTP-তে ম্যানিফেস্ট টেমপ্লেট URL থাকতে পারে যাতে ম্যাক্রো
[[STREAMID]] থাকে। এই উদাহরণে, হ্যান্ডলার ম্যাক্রোর জায়গায় স্ট্রিম আইডি যোগ করে এবং
ফলাফল হিসেবে ম্যানিফেস্ট URL দেখায়।
Objective-C
Swift
বিজ্ঞাপন ইভেন্ট শুনুন
IMAStreamManager
আপনার অ্যাপ্লিকেশনে স্ট্রিম ইভেন্ট এবং ত্রুটিগুলি পাস করার জন্য
IMAStreamManagerDelegate
পদ্ধতিগুলিকে কল করে।
এই উদাহরণের জন্য, কনসোলে প্রাথমিক বিজ্ঞাপন ইভেন্ট লগ করুন:
Objective-C
Swift
IMA DAI অ্যাসেট ক্লিন-আপ করা
স্ট্রিম প্লেব্যাক বন্ধ করতে, সব বিজ্ঞাপন ট্র্যাকিং বন্ধ করতে এবং লোড করা সব
স্ট্রিম অ্যাসেট রিলিজ করতে, IMAStreamManager.destroy() কল করুন।
আপনার অ্যাপ চালান। সফল হলে, IMA SDK-এর মাধ্যমে Google DAI স্ট্রিম অনুরোধ করুন ও চালান। আরও উন্নত SDK ফিচার সম্পর্কে জানতে, বাঁদিকের সাইডবারে তালিকাভুক্ত অন্যান্য গাইড বা GitHub-এ স্যাম্পেল দেখুন।