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

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

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

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

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

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

পূর্বশর্ত

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

  • লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
  • React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
    • gma-sdk-react-native ফোল্ডার থেকে adapters ফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
  • AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

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

Android

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

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

iOS

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

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

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

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

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

app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

প্রকাশক আইডি

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

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

Android

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

iOS

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

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

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

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

আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, PubMatic OpenWrap SDK-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি gma-sdk-react-native/adapters/pubmatic/ ডিরেক্টরি থেকে আপনার প্রোজেক্টের local_packages/ ডিরেক্টরিতে কপি করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/pubmatic/gma-mediation-pubmatic-0.1.0.tgz local_packages/

    EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।

  2. আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:

    npm

    npm install ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

    তন্তু

    yarn add ./local_packages/gma-mediation-pubmatic-0.1.0.tgz

  3. আপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের android ডিরেক্টরিতে build.gradle ফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
}

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

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

PubMatic OpenWrap SDK React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে PubMatic OpenWrap SDK SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) ও জিডিপিআর (GDPR) সম্মতি পাস করা দেখুন।

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

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

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

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

Android

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

iOS

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

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

ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

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

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-এর ডকুমেন্টেশন দেখুন।

ভার্সন 0.1.0

  • প্রাথমিক রিলিজ।