এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মিডিয়েশন-এর মাধ্যমে Pangle থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়। এতে ওয়াটারফল ও বিডিং ইন্টিগ্রেশন, দুটিই কভার করা হয়। এতে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে Pangle যোগ করার পদ্ধতি এবং React Native অ্যাপে Pangle SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতি কভার করা হয়েছে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
Pangle-এর জন্য AdMob মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | ১ |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ খোলা | ২ |
| ব্যানার | ২ |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | ২ |
১ উপলভ্য Pangle বিডিং বিজ্ঞাপন সোর্সের মধ্যে Pangle US, Pangle KR এবং Pangle ROW অন্তর্ভুক্ত।
২ এই ফর্ম্যাটটি নিম্নলিখিত Pangle বিডিং বিজ্ঞাপন সোর্সের জন্য কাজ করে না: Pangle US.
পূর্বশর্ত
- লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
- [Pangle US বিডিংয়ের জন্য]: Pangle অ্যাডাপ্টার ভার্সন N/A বা তার পরবর্তী ভার্সন ব্যবহার করুন।
- 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 মেডিয়েশন সেট-আপ করুন।
ধাপ ১: Pangle UI-তে কনফিগারেশন সেট-আপ করা
আপনার Pangle অ্যাকাউন্টে সাইন-আপ করুন অথবা লগ-ইন করুন।
নতুন অ্যাপ্লিকেশন যোগ করুন
অ্যাপ্লিকেশন ট্যাবে গিয়ে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
আপনি যে অপারেটিং সিস্টেমের জন্য অ্যাপ্লিকেশন তৈরি করতে চান সেটি বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। তারপর, জমা দিন বিকল্পে ক্লিক করুন।
Android
iOS
আপনার অ্যাপ্লিকেশনের অ্যাপ আইডি নোট করে রাখুন।
Android
iOS
বিজ্ঞাপনের প্লেসমেন্ট তৈরি করা
আপনার অ্যাপ্লিকেশন তৈরি হয়ে গেলে, বিজ্ঞাপনের প্লেসমেন্ট তৈরি করতে যোগ করুন বোতামে ক্লিক করুন।
Android
iOS
বিডিং
আপনার বিজ্ঞাপনের ফর্ম্যাট ও বিজ্ঞাপনের প্লেসমেন্টের নাম বেছে নিন এবং মূল্য নির্ধারণের ধরন হিসেবে ইন-অ্যাপ বিডিং বেছে নিন। ফর্মের বাকি অংশ পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।
আপনার বিজ্ঞাপনের প্লেসমেন্ট তৈরি করা হয়ে গেলে, বিজ্ঞাপনের প্লেসমেন্ট আইডি নোট করে নিন।
Android
iOS
জলপ্রপাত
আপনার বিজ্ঞাপনের ফর্ম্যাট ও বিজ্ঞাপন প্লেসমেন্টের নাম এবং প্রাইসিংয়ের ধরন হিসেবে গ্লোবাল CPM বেছে নিন। ফর্মের বাকি অংশ পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।
আপনার বিজ্ঞাপনের প্লেসমেন্ট তৈরি করা হয়ে গেলে, বিজ্ঞাপনের প্লেসমেন্ট আইডি নোট করে নিন।
Android
iOS
Pangle রিপোর্টিং API key খুঁজে বের করা
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজনীয় নয়।
জলপ্রপাত
পৃষ্ঠার নিচে বাঁদিকের কোণে ব্যবহারকারীর আইডি নোট করুন।
ইন্টিগ্রেশন > SDK ও API > Pangle Reporting API 2.0 বিকল্পে ক্লিক করুন। ভূমিকার আইডি এবং নিরাপত্তা কী নোট করুন।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।
Pangle-এর জন্য app-ads.txt প্রয়োগ করতে,
আপনার app-ads.txt ফাইলে কীভাবে Pangle যোগ করবেন তা দেখুন।
টেস্ট মোড চালু করুন
Pangle-এর কীভাবে টেস্ট বিজ্ঞাপন যোগ করবেন নির্দেশিকা থেকে Pangle টেস্ট বিজ্ঞাপন চালু করার পদ্ধতি জানুন।
ধাপ ২: AdMob UI-তে Pangle ডিমান্ড সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় Pangle DSP যোগ করুন
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Pangle DSP যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: Pangle SDK ও অ্যাডাপ্টার ইমপোর্ট করা
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, Pangle-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/pangle/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/pangle/gma-mediation-pangle-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-pangle-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-pangle-0.1.0.tgzআপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের
androidডিরেক্টরিতেbuild.gradleফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:repositories { google() mavenCentral() maven { url = uri("https://artifact.bytedance.com/repository/pangle/") } }
ধাপ ৪: Pangle SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
Pangle React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন UMP SDK এবং কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে জিডিপিআর (GDPR) সম্মতি সিগন্যাল পাস করার সুবিধা দেয় যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন থেকে Pangle SDK-তে ইন্টিগ্রেট করা হয়।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
Pangle SDK-তে কীভাবে সম্মতি সংক্রান্ত তথ্য পাস করতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে জানতে পারবেন। ইনিশিয়ালাইজ Google Mobile Ads SDK for React Native করার আগে সম্মতি সংক্রান্ত তথ্য সেট করুন যাতে সেগুলি সঠিকভাবে Pangle SDK-তে ফরওয়ার্ড করা হয়।
import {
PangleMediation,
PanglePAConsentType,
} from '@google/gma-mediation-pangle';
// ...
PangleMediation.setPAConsent(PanglePAConsentType.CONSENT);
আরও বিবরণ এবং প্রতিটি পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালুর জন্য Pangle-এর ইন্টিগ্রেশন গাইড দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
Pangle ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে,
Pangle-এর
ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং Pangle UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি Pangle থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Pangle (ওয়াটারফল), Pangle US SDK (বিডিং), Pangle KR SDK (বিডিং) এবং Pangle ROW SDK (বিডিং) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার যদি Pangle থেকে বিজ্ঞাপন না পায়, তাহলে প্রকাশক নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
কোনও বিজ্ঞাপন লোড হতে না পারলে, Pangle অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| ১০১ | com.google.ads.mediation.pangle | সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)। |
| 102 | com.google.ads.mediation.pangle | অনুরোধ করা বিজ্ঞাপনের সাইজ Pangle-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 103 | com.google.ads.mediation.pangle | Pangle SDK বাচ্চাদের জন্য কাজ করে না। |
| -1-60000 | com.pangle.ads | Pangle SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য Pangle-এর ডকুমেন্টেশন দেখুন। |
iOS
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| ১০১ | com.google.mediation.pangle | সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)। |
| 102 | com.google.mediation.pangle | অনুরোধ করা বিজ্ঞাপনের সাইজ Pangle-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 104 | com.google.mediation.pangle | Pangle SDK বাচ্চাদের জন্য কাজ করে না। |
| -1-60000 | Pangle SDK-এর মাধ্যমে পাঠানো হয়েছে | Pangle SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য Pangle-এর ডকুমেন্টেশন দেখুন। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- Pangle Android অ্যাডাপ্টার ভার্সন 8.3.0.3.0 কাজ করে।
- Pangle iOS অ্যাডাপ্টার ভার্সন 8.2.1.0.0 কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।