বিডিংয়ের সাথে পাবম্যাটিককে একীভূত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে মিডিয়েশন ব্যবহার করে Google Mobile Ads SDK দিয়ে পাবম্যাটিক (PubMatic) থেকে বিজ্ঞাপন লোড ও প্রদর্শন করতে হয়, যেখানে ওয়াটারফল (waterfall) এবং বিডিং (biding) উভয় ইন্টিগ্রেশনই অন্তর্ভুক্ত। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে পাবম্যাটিক ওপেনর‍্যাপ এসডিকে (PubMatic OpenWrap SDK) যোগ করতে হয় এবং কিভাবে পাবম্যাটিক ওপেনর‍্যাপ এসডিকে ও অ্যাডাপ্টারকে একটি আইওএস (iOS) অ্যাপে ইন্টিগ্রেট করতে হয়।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

PubMatic-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

^১. ওয়াটারফল ইন্টিগ্রেশন আলফা পর্যায়ে রয়েছে।

^২ ব্যানার ব্যতীত অন্য সকল সমর্থিত বিজ্ঞাপন ফরম্যাট আলফা পর্যায়ে রয়েছে।

প্রয়োজনীয়তা

• iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি

• সর্বশেষ Google Mobile Ads SDK ।

• মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

ধাপ ১: PubMatic UI-তে কনফিগারেশন সেট আপ করুন।

আপনার PubMatic অ্যাকাউন্টে সাইন আপ করুন বা লগ ইন করুন এবং OpenWrap SDK কার্ডটি নির্বাচন করুন।

একটি নতুন অ্যাপ্লিকেশন যোগ করুন

অ্যাপস ট্যাবে যান এবং অ্যাড অ্যাপ বোতামে ক্লিক করুন।

আপনার অ্যাপের জন্য প্ল্যাটফর্ম , অ্যাপ স্টোর ইউআরএল এবং অ্যাপের নাম নির্বাচন করুন।

ইন্টিগ্রেশন পাথ-এর অধীনে, iOS (Objective-C / Swift) নির্বাচন করুন এবং সাব-ইন্টিগ্রেশন পাথ হিসেবে AdMob - SDK Bidding নির্বাচন করুন। তারপর, অ্যাড অ্যাপ বোতামে ক্লিক করুন।

আপনার app-ads.txt আপডেট করুন।

Apps-এর জন্য অনুমোদিত বিক্রেতা app-ads.txt হলো IAB টেক ল্যাবের একটি উদ্যোগ, যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপের বিজ্ঞাপন ইনভেন্টরি শুধুমাত্র আপনার দ্বারা অনুমোদিত হিসেবে চিহ্নিত চ্যানেলগুলোর মাধ্যমেই বিক্রি হয়। বিজ্ঞাপনের আয়ে বড় ধরনের ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে Ad Manager-এর জন্য একটি app-ads.txt ফাইল তৈরি করুন ।

আপনার অ্যাপটি চূড়ান্ত করার আগে, আপনার app-ads.txt ফাইলে যোগ করার জন্য উপযুক্ত এন্ট্রিগুলো আপনাকে দেখানো হবে।

PubMatic-এর জন্য app-ads.txt কীভাবে প্রয়োগ করতে হয় সে সম্পর্কে অতিরিক্ত তথ্যের জন্য, “How to Implement app-ads.txt” দেখুন।

প্রোফাইল আইডি

আপনার অ্যাপটি তৈরি হয়ে গেলে, অ্যাপস ট্যাবে যান এবং আপনার সদ্য তৈরি অ্যাপ্লিকেশনটির প্রোফাইল আইডিটি লিখে রাখুন।

একটি বিজ্ঞাপন ইউনিট তৈরি করুন

অ্যাড ইউনিটস ট্যাবের অধীনে, পূর্ববর্তী বিভাগে আপনার তৈরি করা অ্যাপটি নির্বাচন করুন এবং ক্রিয়েট অ্যাড ইউনিট বোতামে ক্লিক করুন।

আপনার বিজ্ঞাপন ইউনিটের বিবরণ দিয়ে ফর্মটি পূরণ করুন এবং সেভ-এ ক্লিক করুন।

আপনার নতুন তৈরি করা OpenWrap বিজ্ঞাপন ইউনিট আইডিটি লিখে রাখুন।

আপনার প্রকাশক আইডি সংগ্রহ করুন

অ্যানালিটিক্স ড্যাশবোর্ডে যান। প্রোফাইল আইকনের উপর মাউস রাখুন এবং আপনার আইডিটি লিখে নিন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে পাবম্যাটিক ডিমান্ড সেট আপ করুন।

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

কোম্পানিগুলিতে পাবম্যাটিক ওপেনর‍্যাপ এসডিকে যোগ করুন

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

SDK বিডিং-এর জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন

পাবম্যাটিক ওপেনর‍্যাপ এসডিকে বিডিং কনফিগার করুন

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic-কে যুক্ত করুন

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic-কে যুক্ত করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস- এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: পাবম্যাটিক ওপেনর‍্যাপ এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন

চালিয়ে যাওয়ার আগে, আপনার কাছে সর্বনিম্ন সমর্থিত অ্যাডাপ্টার সংস্করণ ৪.১০.০.০ থাকতে হবে।

আপনার প্রজেক্টে প্যাকেজ ডিপেন্ডেন্সি যোগ করতে, এই ধাপগুলো অনুসরণ করুন:

1. Xcode-এ, File > Add Package Dependencies... -এ যান।

2. প্রদর্শিত প্রম্পটে, নিম্নলিখিত প্যাকেজ URL-টি অনুসন্ধান করুন:

   https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
   

3. ডিপেন্ডেন্সি রুল- এ, ব্রাঞ্চ নির্বাচন করুন।

4. টেক্সট ফিল্ডে main লিখুন।

কোকোপড ব্যবহার করুন

• আপনার প্রোজেক্টের Podfile-এ নিম্নলিখিত লাইনটি যোগ করুন:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• কমান্ড লাইন থেকে চালান:

  pod install --repo-update

ম্যানুয়াল ইন্টিগ্রেশন

1. iOS-এর জন্য PubMatic OpenWrap SDK- এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রোজেক্টের সমস্ত .xcframework ফাইল ও বান্ডেল লিঙ্ক করুন।

2. চেঞ্জলগে দেওয়া ডাউনলোড লিঙ্ক থেকে পাবম্যাটিক অ্যাডাপ্টারের সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে PubMaticAdapter.xcframework লিঙ্ক করুন।

ধাপ ৪: PubMatic-এ গোপনীয়তা সেটিংস প্রয়োগ করুন।

Google EU ব্যবহারকারী সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার।

PubMatic স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন , যার মধ্যে UMP SDK অন্তর্ভুক্ত, সমর্থন করে। আরও তথ্যের জন্য, Pass GDPR এবং GDPR consent দেখুন।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন অনুযায়ী, ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (আইনে এই পদগুলির যে সংজ্ঞা দেওয়া হয়েছে) "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়া আবশ্যক। এই অপ্ট-আউটের সুযোগটি "বিক্রেতা" পক্ষের হোমপেজে একটি সুস্পষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন পরিপালন নির্দেশিকা গুগল বিজ্ঞাপন পরিবেশনের জন্য সীমিত ডেটা প্রক্রিয়াকরণ সক্ষম করার সুযোগ দেয়, কিন্তু গুগল আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে পারে না। অতএব, আপনাকে আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক শনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রয়ে অংশ নিতে পারে এবং পরিপালন নিশ্চিত করার জন্য সেই নেটওয়ার্কগুলির প্রত্যেকটির নির্দেশিকা অনুসরণ করতে হবে।

PubMatic স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা নির্ধারিত GPP কনসেন্ট পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, Pass GPP consent দেখুন।

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

SKAdNetwork বাস্তবায়ন করুন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork আইডেন্টিফায়ারগুলো যোগ করতে PubMatic-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি PubMatic OpenWrap SDK থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, PubMatic OpenWrap অ্যাড সোর্স(গুলি) ব্যবহার করে অ্যাড ইন্সপেক্টরে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ঐচ্ছিক পদক্ষেপ

স্থানীয় বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

পাবম্যাটিক অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলোকে GADNativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি একটি GADNativeAd জন্য নিম্নলিখিত ফিল্ডগুলো পূরণ করে।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি PubMatic থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে থাকা GADResponseInfo.adNetworkInfoArray ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

GADMediationAdapterPubMatic

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন পাবম্যাটিক অ্যাডাপ্টার যে কোড এবং তার সাথে বার্তাগুলো প্রদর্শন করে, তা নিচে দেওয়া হলো:

পাবম্যাটিক আইওএস মিডিয়েশন অ্যাডাপ্টার পরিবর্তন তালিকা

সংস্করণ 5.0.0.0

• PubMatic OpenWrap SDK সংস্করণ 5.0.0-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.১.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৫.০.০।

সংস্করণ ৪.১২.০.০

• PubMatic OpenWrap SDK সংস্করণ 4.12.0-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।
• Google Mobile Ads SDK ডিপেন্ডেন্সিটি ভার্সন 13.0.0-এ আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.০.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.১২.০।

সংস্করণ ৪.১১.০.২

• CocoaPods-এর সর্বনিম্ন iOS সংস্করণ 13.0 -এ আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.০.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.১১.০।

সংস্করণ ৪.১১.০.১

• PubMatic OpenWrap SDK-তে tagForChildDirectedTreatment এবং tagForUnderAgeOfConsent Google Mobile Ads SDK প্যারামিটারগুলো ফরোয়ার্ড করার সুবিধা যোগ করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.১৪.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.১১.০।

সংস্করণ ৪.১১.০.০

• PubMatic OpenWrap SDK সংস্করণ 4.11.0-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.১৪.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.১১.০।

সংস্করণ ৪.১০.০.০

• PubMatic OpenWrap SDK সংস্করণ 4.10.0-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.১২.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.১০.০।

সংস্করণ ৪.৯.০.০

• ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড এবং নেটিভ অ্যাড ফরম্যাটের জন্য ওয়াটারফল সাপোর্ট যোগ করা হয়েছে।
• একটি বাগ সংশোধন করা হয়েছে যেখানে নেটিভ অ্যাড ডেলিগেটগুলো সঠিকভাবে সেট করা হচ্ছিল না।
• GADMediationAdapterPubMaticExtras ক্লাসে একটি টেস্ট মোড প্রপার্টি যোগ করুন।
• PubMatic OpenWrap SDK সংস্করণ 4.9.0-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.১২.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.৯.০।

সংস্করণ ৪.৮.১.০

• PubMatic OpenWrap SDK সংস্করণ 4.8.1-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.৯.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.৮.১।

সংস্করণ ৪.৮.০.০

• PubMatic OpenWrap SDK সংস্করণ 4.8.0-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.৮.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.৮.০।

সংস্করণ ৪.৭.০.০

• প্রাথমিক প্রকাশ।
• ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড এবং নেটিভ বিজ্ঞাপন ফরম্যাটের জন্য বিডিং সমর্থন করে।
• PubMatic OpenWrap SDK সংস্করণ 4.7.0-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.৬.০।
• পাবম্যাটিক ওপেনর‍্যাপ এসডিকে সংস্করণ ৪.৭.০।