মধ্যস্থতার সাথে Pangle ইন্টিগ্রেট করা

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

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

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

Pangle-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

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

১ উপলভ্য Pangle বিডিং বিজ্ঞাপন সোর্সের মধ্যে Pangle US, Pangle KR এবং Pangle ROW অন্তর্ভুক্ত।

২ এই ফর্ম্যাট নিম্নলিখিত Pangle বিডিং বিজ্ঞাপন সোর্সের জন্য কাজ করে না: Pangle মার্কিন যুক্তরাষ্ট্র।

পূর্বশর্ত

  • Google Mobile Ads Unity Plugin-এর লেটেস্ট ভার্সন।
  • [For Pangle US bidding]: Use Pangle adapter version 5.1.0 or higher.
  • Unity Editor ভার্সন 5.6 বা তার পরবর্তী যেকোনও ভার্সন।
  • [Pangle KR বিডিং ও Pangle ROW বিডিংয়ের জন্য]: বিডিংয়ে কাজ করে এমন সব বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, Pangle 2.4.0 বা তার পরের যেকোনও ভার্সনের জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন ব্যবহার করুন (লেটেস্ট ভার্সন ব্যবহার করার সাজেশন দেওয়া হয়)।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি চালু Unity প্রোজেক্ট। বিবরণের জন্য সেট-আপ করুন Google Mobile Ads Unity Plugin দেখুন।
  • AdMob মধ্যস্থতা সেট-আপ করুন।

ধাপ ১: Pangle UI-তে কনফিগারেশন সেট-আপ করুন

আপনার Pangle অ্যাকাউন্টে সাইন-আপ করুন অথবা লগ-ইন করুন।

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

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

আপনি যে অপারেটিং সিস্টেমের জন্য অ্যাপ্লিকেশন তৈরি করতে চান সেটি বেছে নিন এবং বাকি ফর্মটি পূরণ করুন। তারপর, জমা দিন বিকল্পে ক্লিক করুন।

Android

iOS

আপনার অ্যাপ্লিকেশনের অ্যাপ আইডি মনে রাখুন।

Android

iOS

বিজ্ঞাপন প্লেসমেন্ট তৈরি করা

আপনার অ্যাপ্লিকেশন তৈরি হয়ে গেলে, বিজ্ঞাপন প্লেসমেন্ট তৈরি করতে যোগ করুন বোতামে ক্লিক করুন।

Android

iOS

বিডিং

আপনার বিজ্ঞাপনের ফর্ম্যাট ও বিজ্ঞাপনের প্লেসমেন্টের নাম বেছে নিন এবং মূল্যের ধরন হিসেবে ইন-অ্যাপ বিডিং বেছে নিন। বাকি ফর্ম পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।

আপনার বিজ্ঞাপন প্লেসমেন্ট তৈরি হয়ে গেলে, বিজ্ঞাপন প্লেসমেন্ট আইডি মনে রাখবেন।

Android

iOS

জলপ্রপাত

আপনার বিজ্ঞাপনের ফর্ম্যাট ও বিজ্ঞাপন প্লেসমেন্টের নাম বেছে নিন এবং মূল্যের ধরন হিসেবে গ্লোবাল CPM বেছে নিন। বাকি ফর্ম পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।

আপনার বিজ্ঞাপন প্লেসমেন্ট তৈরি হয়ে গেলে, বিজ্ঞাপন প্লেসমেন্ট আইডি মনে রাখবেন।

Android

iOS

Pangle Reporting API key খুঁজে পাওয়া

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন হয় না।

জলপ্রপাত

পৃষ্ঠার নিচে বাঁদিকের কোণে ব্যবহারকারীর আইডি নোট করে রাখুন।

ইন্টিগ্রেশন > SDK ও API > Pangle রিপোর্টিং API 2.0 বিকল্পে ক্লিক করুন। ভূমিকা আইডি ও নিরাপত্তা কী নোট করে রাখুন।

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

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

বিল্ড সংক্রান্ত সমস্যা হতে পারে।

OpenUPM-CLI

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

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

OpenUPM

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

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

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

OpenUPM-এর বিবরণ

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

Unity রেজিস্ট্রি

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

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

Unity প্যাকেজ

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

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

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

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

জোর করে সমাধান করা

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

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

Pangle Unity অ্যাডাপ্টারের ভার্সন ৫.৯.০ ও তার পরবর্তী যেকোনও ভার্সনে, Pangle অটোমেটিক GDPR সম্মতি পড়ে। এটি সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা হয় যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন, UMP SDK সহ সাপোর্ট করে।

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

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

নিচের নমুনা কোড থেকে কীভাবে Pangle SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করতে হয় তা জানতে পারবেন। Pangle SDK-তে যাতে সম্মতি সংক্রান্ত তথ্য সঠিকভাবে ফরোয়ার্ড করা হয় তা নিশ্চিত করতে, ইনিশিয়ালাইজ Google Mobile Ads Unity Plugin করার আগে সম্মতি সংক্রান্ত তথ্য সেট করুন।

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

আরও বিবরণ ও প্রতিটি পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালু সম্পর্কে জানতে, 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-এর ডকুমেন্টেশন দেখুন।

Pangle Unity মধ্যস্থতা প্লাগ-ইন পরিবর্তনের লগ

ভার্সন ৭.২.১

ভার্সন ৭.২.০

ভার্সন 7.1.1

ভার্সন 7.1.0

ভার্সন 7.0.0 (রোল ব্যাক করা হয়েছে)

ভার্সন 6.0.1

ভার্সন 6.0.0

ভার্সন ৫.৯.২

ভার্সন 5.9.1

ভার্সন 5.9.0

ভার্সন 5.8.5

ভার্সন 5.8.4

ভার্সন 5.8.3

ভার্সন 5.8.2

ভার্সন 5.8.1

ভার্সন 5.8.0

ভার্সন 5.7.1

ভার্সন 5.7.0

ভার্সন 5.6.0

ভার্সন 5.5.3

ভার্সন ৫.৫.২

ভার্সন 5.5.1

ভার্সন 5.5.0

ভার্সন 5.4.0

ভার্সন 5.3.0

ভার্সন ৫.২.২

ভার্সন 5.2.1

ভার্সন 5.2.0

ভার্সন 5.1.1

ভার্সন 5.1.0

ভার্সন 5.0.0

ভার্সন ৪.৬.২

ভার্সন 4.6.1

ভার্সন 4.6.0

ভার্সন 4.5.4

ভার্সন 4.5.3

ভার্সন ৪.৫.২

ভার্সন 4.5.1

ভার্সন 4.5.0

ভার্সন ৪.৪.২

ভার্সন 4.4.1

ভার্সন 4.4.0

ভার্সন ৪.৩.৩

ভার্সন 4.3.2

ভার্সন ৪.৩.১

ভার্সন 4.3.0

ভার্সন ৪.২.১

ভার্সন 4.2.0

ভার্সন 4.1.0

ভার্সন 4.0.1

ভার্সন 4.0.0

ভার্সন 3.0.0

ভার্সন ২.৮.১

ভার্সন 2.8.0

ভার্সন 2.7.0

ভার্সন ২.৬.০

ভার্সন 2.5.0

ভার্সন ২.৪.০

ভার্সন 2.3.0

ভার্সন ২.২.০

ভার্সন ২.১.০

ভার্সন 2.0.0

ভার্সন ১.৫.১

ভার্সন 1.5.0

ভার্সন 1.4.0

ভার্সন ১.৩.১

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0