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

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

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

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

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

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

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

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

পূর্বশর্ত

  • লেটেস্ট Google Mobile Ads Unity Plugin ভার্সন।
  • [Pangle US বিডিংয়ের জন্য]: Pangle অ্যাডাপ্টার ভার্সন 5.1.0 বা তার পরবর্তী যেকোনও ভার্সন ব্যবহার করুন।
  • Unity Editor ভার্সন 5.6 বা তার পরবর্তী যেকোনও ভার্সন।
  • [Pangle KR বিডিং এবং Pangle ROW বিডিংয়ের জন্য]: বিডিংয়ে সব কাজ করে এমন বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, Pangle 2.4.0 বা তার পরবর্তী ভার্সনের জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইন ব্যবহার করুন (লেটেস্ট ভার্সন সাজেস্ট করা হয়েছে)।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের ভার্সন।
  • 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 Mediation প্লাগ-ইন ইনস্টল করতে পারবেন:

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

    OpenUPM

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

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

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

    OpenUPM-এর বিবরণ

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

    Unity Registries

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

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

    Unity প্যাকেজ

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

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

    Unity থেকে ইমপোর্ট করুন

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

    ফোর্স রিজলভ

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

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

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

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

    মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে 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 (Waterfall), Pangle US SDK (Bidding), Pangle KR SDK (Bidding) এবং Pangle ROW SDK (Bidding) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    ত্রুটি কোড

    অ্যাডাপ্টার যদি 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.1.1

    ভার্সন 7.1.0

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

    ভার্সন 6.0.1

    ভার্সন 6.0.0

    ভার্সন 5.9.2

    ভার্সন 5.9.1

    ভার্সন 5.9.0

    • Pangle ক্লাস থেকে SetGDPRConsent() পদ্ধতি অবচিত করা হয়েছে। Pangle SDK এখন অটোমেটিক সম্মতি ম্যানেজ করে।
      • এই পদ্ধতিটি এখন আর কাজ করে না এবং ভবিষ্যতের রিলিজে এটি সরিয়ে দেওয়া হবে।
    • Pangle Android অ্যাডাপ্টার ভার্সন 7.9.1.1.0 কাজ করে।
    • Pangle iOS অ্যাডাপ্টার ভার্সন 7.9.0.6.0 কাজ করে।
    • Google Mobile Ads Unity প্লাগ-ইন ভার্সন ১১.০.০-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।

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

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

    ভার্সন 4.6.0

    ভার্সন 4.5.4

    ভার্সন ৪.৫.৩

    ভার্সন ৪.৫.২

    ভার্সন ৪.৫.১

    ভার্সন 4.5.0

    ভার্সন 4.4.2

    ভার্সন 4.4.1

    ভার্সন 4.4.0

    ভার্সন ৪.৩.৩

    ভার্সন ৪.৩.২

    ভার্সন 4.3.1

    ভার্সন 4.3.0

    ভার্সন 4.2.1

    ভার্সন ৪.২.০

    ভার্সন 4.1.0

    ভার্সন 4.0.1

    ভার্সন 4.0.0

    ভার্সন 3.0.0

    ভার্সন ২.৮.১

    ভার্সন 2.8.0

    ভার্সন 2.7.0

    ভার্সন ২.৬.০

    ভার্সন ২.৫.০

    ভার্সন ২.৪.০

    ভার্সন ২.৩.০

    ভার্সন ২.২.০

    ভার্সন ২.১.০

    ভার্সন 2.0.0

    ভার্সন 1.5.1

    ভার্সন 1.5.0

    ভার্সন ১.৪.০

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0