IMA SDK আপনার ওয়েবসাইট ও অ্যাপে মাল্টিমিডিয়া বিজ্ঞাপন ইন্টিগ্রেট করা সহজ করে তোলে। IMA SDK যেকোনও VAST-এর সাথে মানানসই বিজ্ঞাপন সার্ভার থেকে বিজ্ঞাপনের অনুরোধ করতে এবং আপনার অ্যাপে বিজ্ঞাপন প্লেব্যাক ম্যানেজ করতে পারে। IMA DAI SDK-এর মাধ্যমে, অ্যাপগুলি বিজ্ঞাপন ও কন্টেন্ট ভিডিওর জন্য—VOD বা লাইভ কন্টেন্ট— স্ট্রিম অনুরোধ করে। SDK তারপর একটি সম্মিলিত ভিডিও স্ট্রিম ফেরত পাঠায়, যাতে আপনাকে অ্যাপের মধ্যে বিজ্ঞাপন ও কন্টেন্ট ভিডিওর মধ্যে পরিবর্তন ম্যানেজ করতে না হয়।
আপনি যে DAI সমাধান ব্যবহার করতে চান সেটি বেছে নিন
পড সার্ভিং DAI
এই নির্দেশিকায় ভিডিও প্লেয়ার অ্যাপে 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-তে আপনার Pod Serving ইভেন্ট শনাক্তকারী কাস্টম অ্যাসেট কী। আপনার ম্যানিফেস্ট ম্যানিপুলেটর বা থার্ড
পার্টি পড পরিবেশনকারী পার্টনার এটি তৈরি করে। |
| VOD স্ট্রিম প্যারামিটার | |
| নেটওয়ার্ক কোড |
আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড। |
নতুন Xcode প্রোজেক্ট তৈরি করুন
Xcode-এ, Objective-C ব্যবহার করে "PodServingExample" নামের একটি নতুন iOS প্রোজেক্ট তৈরি করুন।
Xcode প্রোজেক্টে IMA DAI SDK যোগ করুন
IMA SDK ইনস্টল করতে, পছন্দের পদ্ধতি বেছে নিন।
সাজেস্ট করা: Swift প্যাকেজ ম্যানেজার ব্যবহার করে SDK ইনস্টল করুন
Interactive Media Ads SDK, 3.18.4 ভার্সন থেকে শুরু করে Swift Package Manager-এ কাজ করে। 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 Package Manager ব্যবহার করতে না চাইলে, আপনার প্রোজেক্টে 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-এ স্যাম্পেল দেখুন।