মেডিয়েশনের সাথে PubMatic ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Unity Plugin ব্যবহার করে মিডিয়েশন-এর মাধ্যমে PubMatic থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, এতে বিডিং ইন্টিগ্রেশনও কভার করা হয়। বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে কীভাবে PubMatic যোগ করতে হয় এবং Unity অ্যাপে কীভাবে PubMatic SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা এতে বলা আছে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

PubMatic-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারে নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ ওপেন
ব্যানার
স্থান  ১
পুরস্কার জিতেছেন  ১
পুরস্কৃত ইন্টারস্টিশিয়াল

১ এই ফর্ম্যাট বিটা ভার্সনে আছে। অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:

  • Google Mobile Ads Unity Plugin-এর লেটেস্ট ভার্সন।
  • Unity Editor ভার্সন 2019.4 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Unity প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Unity Plugin দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

    অ্যাপ ট্যাবে নেভিগেট করে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

    অ্যাপ ড্যাশবোর্ড

    আপনার অ্যাপের জন্য প্ল্যাটফর্ম, App Store URL এবং অ্যাপের নাম বেছে নিন।

    Android

    ইন্টিগ্রেশন পাথ-এর অধীনে, Unity বেছে নিন এবং সাব-ইন্টিগ্রেশন পাথ হিসেবে AdMob - SDK বিডিং বেছে নিন। তারপর, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

    নতুন অ্যাপ ফর্ম

    iOS

    ইন্টিগ্রেশন পাথ-এর অধীনে, Unity বেছে নিন এবং সাব-ইন্টিগ্রেশন পাথ হিসেবে AdMob - SDK বিডিং বেছে নিন। তারপরে, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

    নতুন অ্যাপ ফর্ম

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

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

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

    app-aps.txt

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

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

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

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

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

    বিজ্ঞাপন ইউনিট ট্যাবের মধ্যে, আগের বিভাগে আপনার তৈরি করা অ্যাপটি বেছে নিন এবং বিজ্ঞাপন ইউনিট তৈরি করুন বোতামে ক্লিক করুন।

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

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

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

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

    অ্যাপ বিজ্ঞাপন ইউনিট আইডি

    আপনার প্রকাশক আইডি পাওয়া

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

    প্রকাশক আইডি

    ধাপ ২: Ad Manager UI-তে PubMatic OpenWrap SDK ডিমান্ড সেট-আপ করা

    আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করা

    Android

    নির্দেশাবলীর জন্য, Android-এর জন্য গাইডের ২ নম্বর ধাপ দেখুন।

    iOS

    নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

    জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারদের তালিকায় PubMatic যোগ করুন

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

    ধাপ ৩: PubMatic OpenWrap SDK SDK এবং অ্যাডাপ্টার ইমপোর্ট করুন

    OpenUPM-CLI

    আপনার OpenUPM-CLI ইনস্টল করা থাকলে, আপনার প্রজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড রান করিয়ে, আপনার প্রজেক্টের জন্য Unity-তে Google Mobile Ads PubMatic OpenWrap SDK মিডিয়েশন প্লাগ-ইন ইনস্টল করতে পারবেন:

    openupm add com.google.ads.mobile.mediation.pubmatic

    OpenUPM

    আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিন যাতে Unity প্যাকেজ ম্যানেজার সেটিংস খোলা যায়।

    স্কোপড রেজিস্ট্রি ট্যাবের মধ্যে, নিম্নলিখিত বিবরণ সহ স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:

    • নাম: OpenUPM
    • URL: https://package.openupm.com
    • স্কোপ: com.google

    OpenUPM-এর বিবরণ

    তারপর, Unity Package Manager খুলতে Window > Package Manager বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity Registries

    Google Mobile Ads PubMatic Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।

    OpenUPM থেকে ইনস্টল করুন

    Unity প্যাকেজ

    PubMatic OpenWrap SDK-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন। এটি পরিবর্তনের লগ থেকে ডাউনলোড করা যাবে। তারপরে zip ফাইল থেকে GoogleMobileAdsPubMaticMediation.unitypackage এক্সট্র্যাক্ট করুন।

    আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বেছে নিন এবং আপনার ডাউনলোড করা GoogleMobileAdsPubMaticMediation.unitypackage ফাইলটি খুঁজুন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন এবং ইমপোর্ট করুন বিকল্পে ক্লিক করুন।

    Unity থেকে ইমপোর্ট করা

    তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android Resolver > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি, শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।

    ফোর্স রিজলভ

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

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

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

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

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

    PubMatic অটোমেটিক CCPA সম্মতি পড়ে যা সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা হয়। এটি Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন, এবং UMP SDK-কে সাপোর্ট করে। আরও তথ্যের জন্য, CCPA স্ট্রিং সেট করুন দেখুন।

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

    Android

    PubMatic ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোড প্রয়োজন নেই।

    iOS

    SKAdNetwork ইন্টিগ্রেশন

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

    ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

    টেস্ট বিজ্ঞাপন চালু করা

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা ভালোভাবে দেখে নিন।

    টেস্ট বিজ্ঞাপন যাচাই করা

    আপনি PubMatic OpenWrap SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে PubMatic OpenWrap বিজ্ঞাপন সোর্স ব্যবহার করে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    সমস্যার কোড

    অ্যাডাপ্টার PubMatic থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি চেক করতে পারেন:

    Android

    com.pubmatic.sdk
com.google.ads.mediation.pubmatic

    iOS

    GADMediationAdapterPubMatic

    কোনও বিজ্ঞাপন লোড না হলে PubMatic অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:

    Android

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.ads.mediation.pubmatic সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই।
    102 com.google.ads.mediation.pubmatic বিজ্ঞাপনের ফর্ম্যাট PubMatic-এ কাজ করে না অথবা RTB সিগন্যাল ডেটাতে নেই।
    103 com.google.ads.mediation.pubmatic বিজ্ঞাপনটি রেডি না থাকার কারণে সেটি দেখানো যায়নি।
    104 com.google.ads.mediation.pubmatic প্রোফাইল আইডি নেই বা ভুল আছে।
    ১০৫ com.google.ads.mediation.pubmatic বিজ্ঞাপন ইউনিট আইডি নেই বা ফাঁকা আছে।
    106 com.google.ads.mediation.pubmatic ফেরত আসা পুরস্কার প্রদানকারী বিজ্ঞাপনটি নাল।
    107 com.google.ads.mediation.pubmatic ব্যানার বিজ্ঞাপনের সাইজ সঠিক নয়।
    1001-5002 PubMatic SDK-এর মাধ্যমে পাঠানো হয়েছে PubMatic SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য PubMatic-এর ডকুমেন্টেশন দেখুন।

    iOS

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.ads.mediation.pubmatic সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই।
    102 com.google.ads.mediation.pubmatic বিডিং সিগন্যাল সংগ্রহ করার অনুরোধটি ব্যর্থ হয়েছে কারণ অনুরোধের প্যারামিটারে একাধিক ফর্ম্যাট, কোনও ফর্ম্যাট বা কাজ করে না এমন ফর্ম্যাট নির্দিষ্ট করা হয়েছে।
    103 com.google.ads.mediation.pubmatic বিজ্ঞাপন লোড করার জন্য ভুল বিজ্ঞাপন কনফিগারেশন।
    104 com.google.ads.mediation.pubmatic বিজ্ঞাপন রেডি না থাকার কারণে ইন্টারস্টিশিয়াল বিজ্ঞাপন দেখানো যায়নি।
    ১০৫ com.google.ads.mediation.pubmatic পুরস্কার প্রদানকারী বিজ্ঞাপনটি রেডি না থাকার কারণে সেটি দেখানো যায়নি।
    106 com.google.ads.mediation.pubmatic নেটিভ বিজ্ঞাপন ছবির সোর্সগুলির মধ্যে একটি লোড করা যায়নি।
    107 com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে প্রকাশক আইডি নেই।
    108 com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে প্রোফাইল আইডি নেই।
    ১০৯ com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে সংখ্যা নয় এমন প্রোফাইল আইডি আছে।
    110 com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে বিজ্ঞাপন ইউনিট আইডি নেই।
    111 com.google.ads.mediation.pubmatic PubMatic OpenWrap SDK বিজ্ঞাপন সাইজ ইনস্ট্যান্স ইনস্ট্যানশিয়েট করতে পারেনি।
    1001-5002 PubMatic SDK-এর মাধ্যমে পাঠানো হয়েছে PubMatic SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য PubMatic-এর ডকুমেন্টেশন দেখুন।

    PubMatic Unity মিডিয়েশন প্লাগ-ইন চেঞ্জলগ

    ভার্সন ২.৪.১

    ভার্সন ২.৪.০

    ভার্সন 2.3.0

    ভার্সন ২.২.০

    ভার্সন ২.১.৩

    ভার্সন ২.১.২

    ভার্সন ২.১.১

    ভার্সন ২.১.০

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন 1.5.0

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0