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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Unity Plugin ব্যবহার করে মিডিয়েশন-এর মাধ্যমে Pangle থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়। এতে ওয়াটারফল ও বিডিং ইন্টিগ্রেশন, দুটিই কভার করা হয়। এতে বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে 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-এর কীভাবে টেস্ট বিজ্ঞাপন যোগ করবেন নির্দেশিকা থেকে 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 রেজিস্ট্রি

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

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

    Unity প্যাকেজ

    চেঞ্জলগ-এ দেওয়া ডাউনলোড লিঙ্ক থেকে 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 এবং পরবর্তী ভার্সন UMP SDK থেকে GDPR সম্মতি সিগন্যাল পাস করা এবং সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন Pangle 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 (ওয়াটারফল), 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 প্লাগ-ইন চেঞ্জলগ

    পরবর্তী ভার্সন

    • Pangle Unity অ্যাডাপ্টারের জন্য Swift Package Manager (SPM) সহায়তা যোগ করুন।
    • Unity প্লাগ-ইনের ন্যূনতম প্রয়োজনীয় ভার্সন 11.7.0-এ আপডেট করুন।

    ভার্সন 7.3.0

    ভার্সন ৭.২.২

    ভার্সন ৭.২.১

    ভার্সন 7.2.0

    ভার্সন 7.1.1

    ভার্সন 7.1.0

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

    ভার্সন 6.0.1

    ভার্সন 6.0.0

    ভার্সন ৫.৯.২

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

    ভার্সন ৫.৮.২

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

    ভার্সন 4.6.0

    ভার্সন 4.5.4

    ভার্সন ৪.৫.৩

    ভার্সন 4.5.2

    ভার্সন 4.5.1

    ভার্সন 4.5.0

    ভার্সন 4.4.2

    ভার্সন 4.4.1

    ভার্সন 4.4.0

    ভার্সন ৪.৩.৩

    ভার্সন 4.3.2

    ভার্সন ৪.৩.১

    ভার্সন 4.3.0

    ভার্সন 4.2.1

    ভার্সন 4.2.0

    ভার্সন 4.1.0

    ভার্সন 4.0.1

    ভার্সন 4.0.0

    ভার্সন 3.0.0

    ভার্সন ২.৮.১

    ভার্সন 2.8.0

    ভার্সন ২.৭.০

    ভার্সন ২.৬.০

    ভার্সন 2.5.0

    ভার্সন ২.৪.০

    ভার্সন ২.৩.০

    ভার্সন ২.২.০

    ভার্সন ২.১.০

    ভার্সন 2.0.0

    ভার্সন 1.5.1

    ভার্সন 1.5.0

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0