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

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

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

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

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

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

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

  • সর্বশেষ Google Mobile Ads Unity Plugin
  • ইউনিটি ৫.৬ বা উচ্চতর
  • [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, Pangle 2.4.0 বা তার উচ্চতর সংস্করণের জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Unity Plugin দিয়ে কনফিগার করা একটি কার্যকরী ইউনিটি প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Unity 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 এবং অ্যাডাপ্টার ইম্পোর্ট করুন

ওপেনইউপিএম-সিএলআই

আপনার যদি OpenUPM-CLI ইনস্টল করা থাকে, তাহলে আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার প্রোজেক্টে ইউনিটির জন্য গুগল মোবাইল অ্যাডস প্যাঙ্গল মিডিয়েশন প্লাগইনটি ইনস্টল করতে পারেন:

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

ওপেনইউপিএম

আপনার ইউনিটি প্রজেক্ট এডিটরে, ইউনিটি প্যাকেজ ম্যানেজার সেটিংস খুলতে এডিট > প্রজেক্ট সেটিংস > প্যাকেজ ম্যানেজার নির্বাচন করুন।

Scoped Registrys ট্যাবের অধীনে, নিম্নলিখিত বিবরণ সহ OpenUPM-কে একটি স্কোপড রেজিস্ট্রি হিসাবে যুক্ত করুন:

  • নাম: OpenUPM
  • URL: https://package.openupm.com
  • স্কোপ(গুলি): com.google

ওপেনইউপিএম বিবরণ

এরপর, ইউনিটি প্যাকেজ ম্যানেজার খুলতে Window > Package Manager- এ যান এবং ড্রপ-ডাউন মেনু থেকে My Registries নির্বাচন করুন।

ইউনিটি রেজিস্ট্রি

Google Mobile Ads Pangle Mediation প্যাকেজটি নির্বাচন করুন এবং Install-এ ক্লিক করুন।

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

ইউনিটি প্যাকেজ

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

আপনার ইউনিটি প্রজেক্ট এডিটরে, Assets > Import Package > Custom Package নির্বাচন করুন এবং আপনার ডাউনলোড করা GoogleMobileAdsPangleMediation.unitypackage ফাইলটি খুঁজুন। নিশ্চিত করুন যে সমস্ত ফাইল নির্বাচিত আছে এবং Import-এ ক্লিক করুন।

ইউনিটি থেকে আমদানি করুন

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

ফোর্স রিজলভ

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

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

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

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

Pangle.SetGDPRConsent(0);

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

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

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

Pangle-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটিতে Pangle.SetPAConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Pangle SDK-তে সম্মতির তথ্য পাঠাতে হয়। Google Mobile Ads Unity 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-এর ডকুমেন্টেশন দেখুন।

প্যাঙ্গল ইউনিটি মেডিয়েশন প্লাগইনের পরিবর্তন তালিকা

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

  • Pangle ক্লাস থেকে SetGDPRConsent() মেথডটি অপ্রচলিত ঘোষণা করা হয়েছে। Pangle SDK এখন স্বয়ংক্রিয়ভাবে সম্মতির বিষয়টি পরিচালনা করে।
    • এই পদ্ধতিটি এখন নিষ্ক্রিয় এবং ভবিষ্যতের কোনো সংস্করণে এটি সরিয়ে দেওয়া হবে।
  • Pangle অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.9.1.1.0 সমর্থন করে।
  • Pangle iOS অ্যাডাপ্টার সংস্করণ 7.9.0.6.0 সমর্থন করে।
  • গুগল মোবাইল অ্যাডস ইউনিটি প্লাগইন সংস্করণ 11.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

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

সংস্করণ ৫.৮.৪

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

সংস্করণ 5.0.0

সংস্করণ ৪.৬.২

সংস্করণ ৪.৬.১

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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