এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে AdMob মধ্যস্থতা ব্যবহার করে PubMatic থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং ইন্টিগ্রেশন কভার করে৷ এটি কভার করে কিভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে PubMatic যোগ করতে হয় এবং কিভাবে একটি iOS অ্যাপে PubMatic এবং অ্যাডাপ্টারকে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
PubMatic-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| অ্যাপ খোলা | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
প্রয়োজনীয়তা
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK.
মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড ।
ধাপ 1: PubMatic UI এ কনফিগারেশন সেট আপ করুন
আপনার পাবম্যাটিক অ্যাকাউন্টে লগ ইন করুন এবং OpenWrap SDK কার্ড নির্বাচন করুন৷
একটি নতুন অ্যাপ্লিকেশন যোগ করুন
অ্যাপস ট্যাবে নেভিগেট করুন এবং অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
প্ল্যাটফর্ম নির্বাচন করুন, সেইসাথে আপনার অ্যাপের জন্য অ্যাপ স্টোর URL এবং অ্যাপ নাম ।
ইন্টিগ্রেশন পাথের অধীনে, 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 চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
আপনার বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে আপনাকে PubMatic OpenWrap SDK যোগ করতে হবে।
প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপরে, মধ্যস্থতা ট্যাবে নেভিগেট করুন। আপনার যদি একটি বিদ্যমান মধ্যস্থতা গোষ্ঠী থাকে যা আপনি সংশোধন করতে চান, তাহলে সেটি সম্পাদনা করতে সেই মধ্যস্থতা গোষ্ঠীর নামে ক্লিক করুন এবং বিজ্ঞাপন উত্স হিসাবে PubMatic OpenWrap SDK যোগ করতে এড়িয়ে যান৷
একটি নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, মধ্যস্থতা গোষ্ঠী তৈরি করুন নির্বাচন করুন।
আপনার বিজ্ঞাপন বিন্যাস এবং প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান ক্লিক করুন।
আপনার মধ্যস্থতা গোষ্ঠীকে একটি নাম দিন এবং লক্ষ্য করার জন্য অবস্থানগুলি নির্বাচন করুন৷ এরপরে, মধ্যস্থতা গোষ্ঠীর স্থিতিকে সক্ষম করে সেট করুন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন ক্লিক করুন।
আপনার বিদ্যমান AdMob বিজ্ঞাপন ইউনিটগুলির এক বা একাধিক সাথে এই মধ্যস্থতা গোষ্ঠীটিকে সংযুক্ত করুন৷ তারপর Done এ ক্লিক করুন।
আপনি এখন আপনার নির্বাচিত বিজ্ঞাপন ইউনিটগুলির সাথে বিজ্ঞাপন ইউনিট কার্ডটি দেখতে পাবেন:
একটি বিজ্ঞাপন উত্স হিসাবে PubMatic OpenWrap SDK যোগ করুন
বিজ্ঞাপন উত্স বিভাগে বিডিং কার্ডের অধীনে, বিজ্ঞাপন উত্স যোগ করুন নির্বাচন করুন। তারপর PubMatic OpenWrap SDK নির্বাচন করুন।কীভাবে একটি অংশীদারিত্ব চুক্তিতে স্বাক্ষর করবেন এবং PubMatic OpenWrap SDK-এর সাথে একটি বিডিং অংশীদারিত্ব সেট আপ করবেন তা ক্লিক করুন৷
স্বীকার করুন এবং সম্মত ক্লিক করুন, তারপর চালিয়ে যান ক্লিক করুন।
যদি আপনার কাছে ইতিমধ্যেই PubMatic OpenWrap SDK এর জন্য একটি ম্যাপিং থাকে তবে আপনি এটি নির্বাচন করতে পারেন৷ অন্যথায়, ম্যাপিং যোগ করুন ক্লিক করুন।
এর পরে, পূর্ববর্তী বিভাগে প্রাপ্ত OpenWrap Ad Unit ID লিখুন। তারপর Done এ ক্লিক করুন।
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic যোগ করুন
AdMob UI-তে ইউরোপীয় ও মার্কিন রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: PubMatic SDK এবং অ্যাডাপ্টার আমদানি করুন
কোকোপডস (প্রস্তাবিত)
আপনার প্রকল্পের Podfile নিম্নলিখিত লাইন যোগ করুন:
pod 'GoogleMobileAdsMediationPubMatic'কমান্ড লাইন থেকে রান করুন:
pod install --repo-update
ম্যানুয়াল ইন্টিগ্রেশন
iOS এর জন্য PubMatic OpenWrap SDK এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রকল্পের সমস্ত
.xcframeworkফাইল এবং বান্ডেল লিঙ্ক করুন৷চেঞ্জলগের ডাউনলোড লিঙ্ক থেকে PubMatic অ্যাডাপ্টারের সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রকল্পে
PubMaticAdapter.xcframeworkলিঙ্ক করুন৷
ধাপ 4: PubMatic SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে অবশ্যই ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে আপনার ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু প্রকাশ করতে হবে এবং কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ যেখানে আইনত প্রয়োজন সেখানে এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করা এবং ব্যবহারের জন্য তাদের সম্মতি পেতে হবে৷ এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন উত্সে প্রচারিত সম্মতি যাচাই করার জন্য আপনি দায়ী।
PubMatic স্বয়ংক্রিয়ভাবে সম্মতি ব্যবস্থাপনা প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে যা UMP SDK সহ Google-এর অতিরিক্ত সম্মতির স্পেসিফিকেশন সমর্থন করে। আরও তথ্যের জন্য, GDPR পাস এবং GDPR সম্মতি দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইনে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দিতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" পক্ষের হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে৷ মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
PubMatic স্বয়ংক্রিয়ভাবে সম্মতি ব্যবস্থাপনা প্ল্যাটফর্ম দ্বারা সেট করা GPP সম্মতি পড়ে যা UMP SDK সহ Google-এর অতিরিক্ত সম্মতির স্পেসিফিকেশন সমর্থন করে। আরও তথ্যের জন্য, GPP সম্মতি পাস দেখুন।
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে PubMatic-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করা নিশ্চিত করুন।
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি PubMatic OpenWrap SDK থেকে পরীক্ষার বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, PubMatic (বিডিং) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন৷
ঐচ্ছিক পদক্ষেপ
নেটিভ বিজ্ঞাপন
বিজ্ঞাপন রেন্ডারিং
পাবম্যাটিক অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলিকে GADNativeAd অবজেক্ট হিসাবে ফেরত দেয়। এটি একটি GADNativeAd জন্য নিম্নলিখিত ক্ষেত্রগুলি পূরণ করে।
| মাঠ | সম্পদ সবসময় PubMatic অ্যাডাপ্টার দ্বারা অন্তর্ভুক্ত |
|---|---|
| শিরোনাম | |
| ছবি | |
| শরীর | |
| আইকন | |
| অ্যাকশনে কল করুন | |
| স্টার রেটিং | |
| দোকান | |
| দাম | |
| বিজ্ঞাপনদাতা |
ত্রুটি কোড
অ্যাডাপ্টার PubMatic থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হলে, আপনি নিম্নলিখিত ক্লাসের অধীনে GADResponseInfo.adNetworkInfoArray ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
GADMediationAdapterPubMatic
একটি বিজ্ঞাপন লোড হতে ব্যর্থ হলে পাবম্যাটিক অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
| ত্রুটি কোড | ডোমেইন | কারণ |
|---|---|---|
| 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 এর ডকুমেন্টেশন দেখুন। |
পাবম্যাটিক iOS মধ্যস্থতা অ্যাডাপ্টার চেঞ্জলগ
সংস্করণ 4.8.1.1 (প্রগতিতে)
- জলপ্রপাত ইন্টারস্টিশিয়াল বিজ্ঞাপন বিন্যাস সমর্থন করে।
- জলপ্রপাত পুরস্কৃত বিজ্ঞাপন বিন্যাস সমর্থন করে।
- জলপ্রপাত ব্যানার বিজ্ঞাপন বিন্যাস সমর্থন করে.
- জলপ্রপাত নেটিভ বিজ্ঞাপন বিন্যাস সমর্থন করে।
- নেটিভ বিজ্ঞাপন প্রতিনিধি সঠিকভাবে সেট করা হয়নি এমন একটি বাগ সংশোধন করে।
- ফ্রেমওয়ার্কের মধ্যে Info.plist অন্তর্ভুক্ত।
সংস্করণ 4.8.1.0
- PubMatic OpenWrap SDK সংস্করণ 4.8.1 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 12.9.0।
- PubMatic OpenWrap SDK সংস্করণ 4.8.1.
সংস্করণ 4.8.0.0
- PubMatic OpenWrap SDK সংস্করণ 4.8.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 12.8.0।
- PubMatic OpenWrap SDK সংস্করণ 4.8.0।
সংস্করণ 4.7.0.0
- প্রাথমিক মুক্তি।
- ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কৃত এবং নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য বিডিং সমর্থন করে।
- PubMatic OpenWrap SDK সংস্করণ 4.7.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 12.6.0।
- PubMatic OpenWrap SDK সংস্করণ 4.7.0।