মধ্যস্থতা সঙ্গে Pangle একীভূত

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)নতুন অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

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

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খুলুন
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল
স্থানীয়

প্রয়োজনীয়তা

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, Pangle 2.4.0 বা তার উচ্চতর সংস্করণের জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
  • মধ্যস্থতার ব্যবস্থা করুন ।

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

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

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

অ্যাপ্লিকেশন ট্যাবে যান এবং অ্যাড অ্যাপ বোতামে ক্লিক করুন।

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

অ্যান্ড্রয়েড

আইওএস

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

অ্যান্ড্রয়েড

আইওএস

একটি বিজ্ঞাপন স্থান তৈরি করুন

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

অ্যান্ড্রয়েড

আইওএস

নিলাম

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

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

অ্যান্ড্রয়েড

আইওএস

জলপ্রপাত

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

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

অ্যান্ড্রয়েড

আইওএস

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

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

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

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

Pangle টেস্ট অ্যাড কীভাবে চালু করবেন, তা জানতে Pangle-এর ' How to add a Test Ad' গাইডের নির্দেশনাগুলো অনুসরণ করুন।

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

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় Pangle DSP-কে যুক্ত করুন

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা অ্যাড পার্টনার তালিকায় Pangle DSP-কে যুক্ত করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস- এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: Pangle SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

(শুধুমাত্র অ্যান্ড্রয়েডের জন্য) আপনার প্রোজেক্টের android ডিরেক্টরির ভেতরের build.gradle ফাইলে নিম্নলিখিত রিপোজিটরিগুলো যোগ করুন:

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

আপনার প্যাকেজের pubspec.yaml ফাইলে Pangle SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies:
  gma_mediation_pangle: ^3.5.3

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

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

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

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

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

Pangle-এর গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইন সংস্করণ 5.9.0 থেকে শুরু করে, Pangle স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে নেয়, যেগুলো গুগলের অতিরিক্ত সম্মতি স্পেসিফিকেশন (Additional Consent specification) সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত।

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

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

Pangle-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটিতে Pangle.SetPAConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Pangle SDK-তে সম্মতির তথ্য পাঠাতে হয়। Google Mobile Ads Flutter Plugin ইনিশিয়ালাইজ করার আগে সম্মতির তথ্য সেট করুন, যাতে সেগুলি Pangle SDK-তে সঠিকভাবে ফরোয়ার্ড করা হয়।

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

Pangle.SetPAConsent(0);

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

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

অ্যান্ড্রয়েড

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

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারে রেজিস্টার করুন এবং প্যাঙ্গল ইউআই-তে টেস্ট মোড চালু করুন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি Pangle থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে Pangle (Bidding) এবং Pangle (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি Pangle থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড 

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

আইওএস 

GADMediationAdapterPangle

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন Pangle অ্যাডাপ্টার দ্বারা প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:

অ্যান্ড্রয়েড

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.ads.mediation.pangle অবৈধ সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি অনুপস্থিত)।
১০২ com.google.ads.mediation.pangle অনুরোধ করা বিজ্ঞাপনের আকারটি Pangle সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩ com.google.ads.mediation.pangle বিড প্রতিক্রিয়া অনুপস্থিত বা অবৈধ।
-১-৬০০০০ com.pangle.ads Pangle SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে Pangle-এর ডকুমেন্টেশন দেখুন।

আইওএস

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.ads.mediation.pangle অবৈধ সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি অনুপস্থিত)।
১০২ com.google.ads.mediation.pangle অনুরোধ করা বিজ্ঞাপনের আকারটি Pangle সমর্থিত ব্যানার আকারের সাথে মেলে না।
-১-৬০০০০ Pangle SDK দ্বারা প্রেরিত Pangle SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে Pangle-এর ডকুমেন্টেশন দেখুন।

প্যাঙ্গল ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ৩.৬.০ (নির্মাণাধীন)

সংস্করণ ৩.৫.৪ (নির্মাণাধীন)

সংস্করণ ৩.৫.৩

সংস্করণ ৩.৫.২

সংস্করণ ৩.৫.১

সংস্করণ ৩.৫.০

সংস্করণ ৩.৪.০

সংস্করণ ৩.৩.০

সংস্করণ ৩.২.১

সংস্করণ ৩.২.০

সংস্করণ ৩.১.১

সংস্করণ ৩.১.০

সংস্করণ ৩.০.০

সংস্করণ ২.২.০

সংস্করণ ২.১.০

সংস্করণ ২.০.০

সংস্করণ ১.১.০

সংস্করণ ১.০.০