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

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

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

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

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

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

১ উপলভ্য 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 দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

    বিডিং

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

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

    Android

    iOS

    জলপ্রপাত

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

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

    Android

    iOS

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

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

    Pangle-এর জন্য app-ads.txt প্রয়োগ করতে, দেখুন আপনার app-ads.txt ফাইলে কীভাবে Pangle যোগ করবেন।

    টেস্ট মোড চালু করুন

    Pangle-এর টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন তা জানতে কীভাবে টেস্ট বিজ্ঞাপন যোগ করবেন গাইডে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

    Android

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

    iOS

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

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

    Ad Manager 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 খুলতে Window > Package Manager বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity Registries

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

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

    Unity প্যাকেজ

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

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

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

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

    ফোর্স রিজলভ

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

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

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

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

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

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

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

Pangle.SetPAConsent(0);

    আরও বিবরণ এবং প্রতিটি পদ্ধতিতে যে মান প্রদান করা যেতে পারে তার জন্য Pangle-এর ইন্টিগ্রেশন গাইড দেখুন।

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

    Android

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

    iOS

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

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

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

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং 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 Mediation প্লাগ-ইন চেঞ্জলগ

    ভার্সন ৭.২.২ (কাজ চলছে)

    ভার্সন 7.2.1

    ভার্সন 7.2.0

    ভার্সন 7.1.1

    ভার্সন 7.1.0

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

    ভার্সন 6.0.1

    ভার্সন 6.0.0

    ভার্সন 5.9.2

    ভার্সন 5.9.1

    ভার্সন 5.9.0

    ভার্সন 5.8.5

    ভার্সন 5.8.4

    ভার্সন ৫.৮.৩

    ভার্সন ৫.৮.২

    ভার্সন 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.1.1

    ভার্সন 5.1.0

    ভার্সন 5.0.0

    ভার্সন 4.6.2

    ভার্সন ৪.৬.১

    ভার্সন 4.6.0

    ভার্সন 4.5.4

    ভার্সন 4.5.3

    ভার্সন ৪.৫.২

    ভার্সন ৪.৫.১

    ভার্সন 4.5.0

    ভার্সন ৪.৪.২

    ভার্সন 4.4.1

    ভার্সন 4.4.0

    ভার্সন ৪.৩.৩

    ভার্সন 4.3.2

    ভার্সন 4.3.1

    ভার্সন 4.3.0

    ভার্সন 4.2.1

    ভার্সন 4.2.0

    ভার্সন 4.1.0

    ভার্সন 4.0.1

    ভার্সন 4.0.0

    ভার্সন 3.0.0

    ভার্সন ২.৮.১

    ভার্সন ২.৮.০

    ভার্সন 2.7.0

    ভার্সন ২.৬.০

    ভার্সন 2.5.0

    ভার্সন ২.৪.০

    ভার্সন ২.৩.০

    ভার্সন ২.২.০

    ভার্সন ২.১.০

    ভার্সন 2.0.0

    ভার্সন ১.৫.১

    ভার্সন 1.5.0

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0