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 বা তার পরে
- CocoaPods (পছন্দের), সুইফ্ট প্যাকেজ ম্যানেজার, অথবা iOS এর জন্য IMA DAI SDK এর ডাউনলোড করা কপি
আপনার IMA SDK থেকে আপনার স্ট্রিমের অনুরোধ করার জন্য ব্যবহৃত প্যারামিটারগুলিরও প্রয়োজন৷
লাইভস্ট্রিম প্যারামিটার | |
---|---|
নেটওয়ার্ক কোড | আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড। উদাহরণ: 51636543 |
কাস্টম সম্পদ কী | অ্যাড ম্যানেজার 360-এ আপনার পড সার্ভিং ইভেন্টকে শনাক্ত করে এমন কাস্টম অ্যাসেট কী। এটি আপনার ম্যানিফেস্ট ম্যানিপুলেটর বা থার্ড পার্টি পড সার্ভিং পার্টনার দ্বারা তৈরি করা যেতে পারে। উদাহরণ: google-sample |
VOD স্ট্রিম প্যারামিটার | |
নেটওয়ার্ক কোড | আপনার Ad Manager 360 অ্যাকাউন্টের নেটওয়ার্ক কোড। উদাহরণ: 51636543 |
একটি নতুন Xcode প্রকল্প তৈরি করুন
Xcode-এ, "PodServingExample" নামে উদ্দেশ্য-সি ব্যবহার করে একটি নতুন iOS প্রকল্প তৈরি করুন।
Xcode প্রকল্পে IMA DAI SDK যোগ করুন
IMA DAI SDK ইনস্টল করতে এই তিনটি পদ্ধতির একটি ব্যবহার করুন।
CocoaPods ব্যবহার করে SDK ইনস্টল করুন (পছন্দের)
CocoaPods হল Xcode প্রকল্পগুলির জন্য একটি নির্ভরতা পরিচালক এবং IMA DAI SDK ইনস্টল করার জন্য প্রস্তাবিত পদ্ধতি৷ CocoaPods ইনস্টল বা ব্যবহার সম্পর্কে আরও তথ্যের জন্য, CocoaPods ডকুমেন্টেশন দেখুন। আপনি CocoaPods ইনস্টল করার পরে, IMA DAI SDK ইনস্টল করতে নিম্নলিখিত নির্দেশাবলী ব্যবহার করুন:
আপনার PodServingExample.xcodeproj ফাইলের মতো একই ডিরেক্টরিতে, Podfile নামে একটি পাঠ্য ফাইল তৈরি করুন এবং নিম্নলিখিত কনফিগারেশন যোগ করুন:
Podfile ধারণকারী ডিরেক্টরি থেকে, চালান:
pod install --repo-update
সুইফট প্যাকেজ ম্যানেজার ব্যবহার করে SDK ইনস্টল করুন
ইন্টারেক্টিভ মিডিয়া বিজ্ঞাপন SDK সংস্করণ 3.18.4 থেকে শুরু করে সুইফট প্যাকেজ ম্যানেজার সমর্থন করে। সুইফট প্যাকেজ আমদানি করতে নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন৷
Xcode-এ, File > Add Packages- এ নেভিগেট করে IMA DAI SDK সুইফট প্যাকেজ ইনস্টল করুন।
প্রদর্শিত প্রম্পটে, IMA DAI SDK সুইফট প্যাকেজ GitHub সংগ্রহস্থল অনুসন্ধান করুন:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios
আপনি যে IMA DAI SDK সুইফট প্যাকেজটি ব্যবহার করতে চান তার সংস্করণ নির্বাচন করুন৷ নতুন প্রকল্পের জন্য, আমরা আপ টু নেক্সট মেজর সংস্করণ ব্যবহার করার পরামর্শ দিই।
আপনার হয়ে গেলে, Xcode আপনার প্যাকেজ নির্ভরতা সমাধান করে এবং সেগুলিকে পটভূমিতে ডাউনলোড করে। কীভাবে প্যাকেজ নির্ভরতা যুক্ত করবেন সে সম্পর্কে আরও বিশদ বিবরণের জন্য, অ্যাপলের নিবন্ধটি দেখুন।
ম্যানুয়ালি SDK ডাউনলোড এবং ইনস্টল করুন
আপনি যদি সুইফট প্যাকেজ ম্যানেজার বা CocoaPods ব্যবহার করতে না চান, তাহলে আপনি IMA DAI SDK ডাউনলোড করতে পারেন এবং ম্যানুয়ালি আপনার প্রোজেক্টে যোগ করতে পারেন।
একটি সাধারণ ভিডিও প্লেয়ার তৈরি করুন
একটি UI ভিউতে মোড়ানো একটি AV প্লেয়ার ব্যবহার করে আপনার প্রধান ভিউ কন্ট্রোলারে একটি ভিডিও প্লেয়ার প্রয়োগ করুন৷ IMA SDK বিজ্ঞাপন UI উপাদানগুলি প্রদর্শন করতে UI ভিউ ব্যবহার করে।
বিজ্ঞাপন লোডার শুরু করুন
আপনার ভিউ কন্ট্রোলারে IMA SDK আমদানি করুন এবং বিজ্ঞাপন লোডার এবং স্ট্রিম ম্যানেজার ইভেন্টগুলি পরিচালনা করতে IMAAdsLoaderDelegate
এবং IMAStreamManagerDelegate
প্রোটোকলগুলি গ্রহণ করুন৷
মূল IMA SDK উপাদানগুলি সংরক্ষণ করতে এই ব্যক্তিগত বৈশিষ্ট্যগুলি যোগ করুন:
-
IMAAdsLoader
- আপনার অ্যাপের জীবনকাল জুড়ে স্ট্রিম অনুরোধগুলি পরিচালনা করে। -
IMAAdDisplayContainer
- বিজ্ঞাপন ব্যবহারকারী ইন্টারফেস উপাদান সন্নিবেশ এবং পরিচালনা পরিচালনা করে। -
IMAAVPlayerVideoDisplay
- IMA SDK এবং আপনার মিডিয়া প্লেয়ারের মধ্যে যোগাযোগ করে এবং সময়মতো মেটাডেটা পরিচালনা করে। -
IMAStreamManager
- স্ট্রিম প্লেব্যাক পরিচালনা করে এবং বিজ্ঞাপন-সম্পর্কিত ইভেন্টগুলি চালায়।
ভিউ লোড হওয়ার পরে বিজ্ঞাপন লোডার, বিজ্ঞাপন প্রদর্শন কন্টেইনার এবং ভিডিও প্রদর্শন শুরু করুন।
একটি স্ট্রিম অনুরোধ করুন
যখন একজন ব্যবহারকারী প্লে বোতাম টিপে, তখন একটি নতুন স্ট্রিম অনুরোধ করুন। লাইভ স্ট্রিমগুলির জন্য IMAPodStreamRequest
ক্লাস ব্যবহার করুন। VOD স্ট্রীমগুলির জন্য, IMAPodVODStreamRequest
ক্লাসটি ব্যবহার করুন৷
স্ট্রিম অনুরোধের জন্য আপনার স্ট্রিম প্যারামিটারের পাশাপাশি আপনার বিজ্ঞাপন প্রদর্শন কন্টেনার এবং ভিডিও প্রদর্শনের একটি রেফারেন্স প্রয়োজন।
স্ট্রিম লোড ইভেন্ট শুনুন
IMAAdsLoader
ক্লাস IMAAdsLoaderDelegate
পদ্ধতিগুলিকে স্ট্রিম অনুরোধের সফল শুরু বা ব্যর্থতার জন্য কল করে।
adsLoadedWithData
প্রতিনিধি পদ্ধতিতে, আপনার IMAStreamManagerDelegate
সেট করুন। আপনার কাস্টম VTP হ্যান্ডলারের কাছে স্ট্রিম আইডি পাস করুন এবং স্ট্রিম ম্যানিফেস্ট URL পুনরুদ্ধার করুন। লাইভস্ট্রিমগুলির জন্য, আপনার ভিডিও প্রদর্শনে ম্যানিফেস্ট URL লোড করুন এবং প্লেব্যাক শুরু করুন৷ VOD স্ট্রিমগুলির জন্য, স্ট্রীম ম্যানেজারের loadThirdPartyStream
পদ্ধতিতে ম্যানিফেস্ট URL পাস করুন৷ এই পদ্ধতিটি Ad Manager 360 থেকে বিজ্ঞাপন ইভেন্ট ডেটার অনুরোধ করে, তারপর ম্যানিফেস্ট URL লোড করে এবং প্লেব্যাক শুরু করে।
failedWithErrorData
প্রতিনিধি পদ্ধতিতে, ত্রুটিটি লগ করুন। ঐচ্ছিকভাবে, ব্যাকআপ স্ট্রীম খেলুন। DAI সেরা অনুশীলন দেখুন।
আপনার কাস্টম VTP হ্যান্ডলার প্রয়োগ করুন
কাস্টম VTP হ্যান্ডলার দর্শকের স্ট্রীম আইডি আপনার ভিডিও টেকনিক্যাল পার্টনার (VTP)-এর কাছে পাঠায় এবং অন্য যেকোন তথ্যের সাথে আপনার VTP-এর জন্য কন্টেন্ট এবং সেলাই করা বিজ্ঞাপন উভয়ই সমন্বিত একটি স্ট্রিম ম্যানিফেস্ট ফেরত দিতে হবে। আপনার VTP আপনার কাস্টম VTP হ্যান্ডলার কিভাবে বাস্তবায়ন করতে হয় সে সম্পর্কে নির্দিষ্ট নির্দেশনা প্রদান করবে।
উদাহরণস্বরূপ, একটি VTP ম্যাক্রো [[STREAMID]]
ধারণকারী একটি ম্যানিফেস্ট টেমপ্লেট URL অন্তর্ভুক্ত করতে পারে। এই উদাহরণে, হ্যান্ডলার ম্যাক্রোর জায়গায় স্ট্রিম আইডি সন্নিবেশ করান এবং ফলস্বরূপ ম্যানিফেস্ট ইউআরএল ফেরত দেন।
বিজ্ঞাপন ঘটনা শুনুন
IMAStreamManager
IMAStreamManagerDelegate
পদ্ধতিগুলিকে স্ট্রিম ইভেন্টগুলি এবং আপনার অ্যাপ্লিকেশনে ত্রুটিগুলি পাস করার জন্য কল করে৷
এই উদাহরণের জন্য, প্রাথমিক বিজ্ঞাপন ইভেন্টগুলি কনসোলে লগ করুন:
IMA DAI সম্পদ পরিষ্কার করুন
স্ট্রিম প্লেব্যাক বন্ধ করতে, সমস্ত বিজ্ঞাপন ট্র্যাকিং বন্ধ করুন এবং লোড হওয়া সমস্ত স্ট্রিম সম্পদ ছেড়ে দিন, IMAStreamManager.destroy()
এ কল করুন৷
আপনার অ্যাপটি চালান, এবং সফল হলে, আপনি IMA SDK-এর সাথে Google DAI স্ট্রীমগুলির জন্য অনুরোধ করতে এবং চালাতে পারেন৷ আরও উন্নত SDK বৈশিষ্ট্যগুলি সম্পর্কে জানতে, বাম দিকের সাইডবারে তালিকাভুক্ত অন্যান্য গাইড বা GitHub-এ নমুনাগুলি দেখুন।