এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে AdMob মধ্যস্থতা ব্যবহার করে PubMatic থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং ইন্টিগ্রেশন কভার করে৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে পাবম্যাটিক যোগ করতে হয় এবং কীভাবে একটি ফ্লাটার অ্যাপে পাবম্যাটিক SDK এবং অ্যাডাপ্টারকে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
PubMatic-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
ইন্টিগ্রেশন | |
---|---|
বিডিং | |
জলপ্রপাত | |
বিন্যাস | |
অ্যাপ খুলুন | |
ব্যানার | |
ইন্টারস্টিশিয়াল | |
পুরস্কৃত | |
পুরস্কৃত ইন্টারস্টিশিয়াল | |
নেটিভ |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 23 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: PubMatic UI এ কনফিগারেশন সেট আপ করুন
আপনার পাবম্যাটিক অ্যাকাউন্টে লগ ইন করুন এবং OpenWrap SDK কার্ড নির্বাচন করুন৷
একটি নতুন অ্যাপ্লিকেশন যোগ করুন
অ্যাপস ট্যাবে নেভিগেট করুন এবং অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
প্ল্যাটফর্ম নির্বাচন করুন, সেইসাথে আপনার অ্যাপের জন্য অ্যাপ স্টোর URL এবং অ্যাপ নাম ।
অ্যান্ড্রয়েড
ইন্টিগ্রেশন পাথের অধীনে, ফ্লটার নির্বাচন করুন এবং সাব-ইন্টিগ্রেশন পাথ হিসাবে AdMob - SDK বিডিং নির্বাচন করুন। তারপরে, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
iOS
ইন্টিগ্রেশন পাথের অধীনে, ফ্লটার নির্বাচন করুন এবং সাব-ইন্টিগ্রেশন পাথ হিসাবে AdMob - SDK বিডিং নির্বাচন করুন। তারপরে, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
আপনার app-ads.txt আপডেট করুন
Apps app-ads.txt-এর জন্য অনুমোদিত বিক্রেতা হল একটি IAB টেক ল্যাব উদ্যোগ যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি শুধুমাত্র সেই চ্যানেলগুলির মাধ্যমে বিক্রি হয় যেগুলিকে আপনি অনুমোদিত হিসাবে চিহ্নিত করেছেন৷ বিজ্ঞাপনের আয়ের উল্লেখযোগ্য ক্ষতি রোধ করতে, আপনাকে একটি app-ads.txt
ফাইল প্রয়োগ করতে হবে। আপনি যদি এটি ইতিমধ্যে না করে থাকেন, তাহলে আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট আপ করুন ।
আপনার অ্যাপ চূড়ান্ত হওয়ার আগে, আপনাকে আপনার app-ads.txt
এ যোগ করার জন্য উপযুক্ত এন্ট্রি উপস্থাপন করা হবে।
PubMatic-এর জন্য app-ads.txt
কীভাবে প্রয়োগ করবেন সে সম্পর্কে অতিরিক্ত তথ্যের জন্য, দেখুন কিভাবে app-ads.txt প্রয়োগ করতে হয় ।
প্রোফাইল আইডি
একবার আপনার অ্যাপ তৈরি হয়ে গেলে, অ্যাপস ট্যাবে নেভিগেট করুন এবং আপনার সদ্য তৈরি অ্যাপ্লিকেশনটির প্রোফাইল আইডি নোট করুন।
একটি বিজ্ঞাপন ইউনিট তৈরি করুন
বিজ্ঞাপন ইউনিট ট্যাবের অধীনে, পূর্ববর্তী বিভাগে আপনার তৈরি করা অ্যাপটি নির্বাচন করুন এবং বিজ্ঞাপন ইউনিট তৈরি করুন বোতামে ক্লিক করুন।
আপনার বিজ্ঞাপন ইউনিটের বিশদ বিবরণ সহ ফর্মটি পূরণ করুন এবং সংরক্ষণ করুন ক্লিক করুন।
আপনার নতুন তৈরি OpenWrap বিজ্ঞাপন ইউনিট আইডি নোট করুন।
আপনার প্রকাশক আইডি পান
Analytics ড্যাশবোর্ডে নেভিগেট করুন। প্রোফাইল আইকনের উপর ঘোরান এবং আপনার আইডি নোট করুন।
ধাপ 2: AdMob UI-তে PubMatic চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic যোগ করুন
AdMob UI-তে ইউরোপীয় ও মার্কিন রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: PubMatic SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
(কেবল অ্যান্ড্রয়েড) আপনার প্রোজেক্টের android
ডিরেক্টরির ভিতরে build.gradle
ফাইলে নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
আপনার প্যাকেজের pubspec.yaml
ফাইলে PubMatic OpenWrap SDK SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_pubmatic: ^
ম্যানুয়াল ইন্টিগ্রেশন
PubMatic OpenWrap SDK- এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml
ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_pubmatic:
path: path/to/local/package
ধাপ 4: PubMatic SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে অবশ্যই ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে আপনার ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু প্রকাশ করতে হবে এবং কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ যেখানে আইনত প্রয়োজন সেখানে এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করা এবং ব্যবহারের জন্য তাদের সম্মতি পেতে হবে৷ এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন উত্সে প্রচারিত সম্মতি যাচাই করার জন্য আপনি দায়ী। Google স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
PubMatic স্বয়ংক্রিয়ভাবে সম্মতি ব্যবস্থাপনা প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে যা UMP SDK সহ Google-এর অতিরিক্ত সম্মতির স্পেসিফিকেশন সমর্থন করে। আরও তথ্যের জন্য, GDPR পাস এবং GDPR সম্মতি দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইনে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দিতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" পক্ষের হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে৷ মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
PubMatic স্বয়ংক্রিয়ভাবে সম্মতি ব্যবস্থাপনা প্ল্যাটফর্মের দ্বারা সেট করা CCPA সম্মতি পড়ে যা UMP SDK সহ Google-এর অতিরিক্ত সম্মতির স্পেসিফিকেশন সমর্থন করে। আরও তথ্যের জন্য, CCPA স্ট্রিং সেট করুন দেখুন।
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
পাবম্যাটিক ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist
ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে PubMatic-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করা নিশ্চিত করুন।
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি PubMatic OpenWrap SDK থেকে পরীক্ষার বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, PubMatic (বিডিং) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন৷
ত্রুটি কোড
অ্যাডাপ্টার PubMatic থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo
ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
iOS
GADMediationAdapterPubMatic
একটি বিজ্ঞাপন লোড হতে ব্যর্থ হলে পাবম্যাটিক অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
ত্রুটি কোড | ডোমেইন | কারণ |
---|---|---|
101 | com.google.ads.mediation.pubmatic | সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় প্রকাশক আইডি নেই। |
102 | com.google.ads.mediation.pubmatic | একটি বিজ্ঞাপন লোড করার জন্য অবৈধ বিজ্ঞাপন কনফিগারেশন। |
103 | com.google.ads.mediation.pubmatic | একটি বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপনটি প্রস্তুত ছিল না৷ |
1001-5002 | PubMatic SDK দ্বারা পাঠানো হয়েছে | PubMatic SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য PubMatic এর ডকুমেন্টেশন দেখুন। |
iOS
ত্রুটি কোড | ডোমেইন | কারণ |
---|---|---|
101 | com.google.ads.mediation.pubmatic | সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় প্রকাশক আইডি নেই। |
102 | com.google.ads.mediation.pubmatic | বিডিং সিগন্যাল সংগ্রহের অনুরোধ ব্যর্থ হয়েছে কারণ অনুরোধের পরামিতিতে একাধিক বিন্যাস, কোনো বিন্যাস বা একটি অসমর্থিত বিন্যাস উল্লেখ করা হয়েছে। |
103 | com.google.ads.mediation.pubmatic | একটি বিজ্ঞাপন লোড করার জন্য অবৈধ বিজ্ঞাপন কনফিগারেশন। |
104 | com.google.ads.mediation.pubmatic | একটি ইন্টারস্টিশিয়াল বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপনটি প্রস্তুত ছিল না৷ |
105 | com.google.ads.mediation.pubmatic | একটি পুরস্কৃত বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপনটি প্রস্তুত ছিল না৷ |
106 | com.google.ads.mediation.pubmatic | নেটিভ বিজ্ঞাপন চিত্র উত্সগুলির একটি লোড করতে ব্যর্থ৷ |
1001-5002 | PubMatic SDK দ্বারা পাঠানো হয়েছে | PubMatic SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য PubMatic এর ডকুমেন্টেশন দেখুন। |
পাবম্যাটিক ফ্লটার মেডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
সংস্করণ 1.1.0
- পাবম্যাটিক অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.8.0.0 সমর্থন করে।
- PubMatic iOS অ্যাডাপ্টারের সংস্করণ 4.8.0.0 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.0
- প্রাথমিক প্রকাশ।
- পাবম্যাটিক অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.7.1.1 সমর্থন করে।
- PubMatic iOS অ্যাডাপ্টারের সংস্করণ 4.7.0.0 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।