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

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

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

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

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

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

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

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

পূর্বশর্ত

  • Google Mobile Ads Flutter Plugin-এর লেটেস্ট ভার্সন।
  • [For Pangle US bidding]: Use Pangle adapter version 3.1.0 or higher.
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি চালু Flutter প্রোজেক্ট। বিবরণের জন্য সেট-আপ করুন Google Mobile Ads Flutter Plugin দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

বিডিং

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

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

Android

iOS

জলপ্রপাত

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

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

Android

iOS

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

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

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

pub.dev-এর মাধ্যমে ইন্টিগ্রেশন

(শুধুমাত্র Android-এর জন্য) আপনার প্রজেক্টের android ডিরেক্টরির মধ্যে থাকা build.gradle ফাইলে নিচের রেপোজিটরি যোগ করুন:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

আপনার প্যাকেজের pubspec.yaml ফাইলে Pangle SDK ও অ্যাডাপ্টারের লেটেস্ট ভার্সনের সাথে নিচের নির্ভরতা যোগ করুন:

dependencies:
  gma_mediation_pangle: ^4.2.0

ম্যানুয়াল ইন্টিগ্রেশন

এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন: Pangle, ডাউনলোড করা ফাইল এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডার (এবং এর কন্টেন্ট) আপনার Flutter প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করে আপনার pubspec.yaml ফাইলে প্লাগ-ইনটি রেফারেন্স করুন:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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

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

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

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

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

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

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

ভার্সন 4.2.1 (কাজ চলছে)

ভার্সন 4.2.0

ভার্সন 4.1.2

ভার্সন 4.1.1

ভার্সন 4.1.0

ভার্সন 4.0.0

ভার্সন 3.6.0

ভার্সন 3.5.3

ভার্সন 3.5.2

ভার্সন 3.5.1

ভার্সন 3.5.0

ভার্সন 3.4.0

ভার্সন 3.3.0

ভার্সন ৩.২.১

ভার্সন 3.2.0

ভার্সন 3.1.1

ভার্সন 3.1.0

ভার্সন 3.0.0

ভার্সন 2.2.0

ভার্সন 2.1.0

ভার্সন 2.0.0

ভার্সন 1.1.0

ভার্সন 1.0.0