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

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

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

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

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
বিন্যাস
অ্যাপ খুলুন
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল

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

  • সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
  • ইউনিটি 5.6 বা তার বেশি
  • [বিডিংয়ের জন্য]: বিডিং-এ সমস্ত সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলিকে একীভূত করতে, Pangle 2.4.0 বা উচ্চতরের জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন ব্যবহার করুন ( সর্বশেষ সংস্করণ প্রস্তাবিত )
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • Android API স্তর 23 বা উচ্চতর
  • iOS এ স্থাপন করতে
    • 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
  • Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি ওয়ার্কিং ইউনিটি প্রজেক্ট। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
  • মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড

ধাপ 1: Pangle UI এ কনফিগারেশন সেট আপ করুন

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

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

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

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

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

iOS

আপনার আবেদনের অ্যাপ আইডি নোট করুন।

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

iOS

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

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

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

iOS

বিডিং

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

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

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

iOS

জলপ্রপাত

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

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

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

iOS

আপনার 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-এর নির্দেশাবলী অনুসরণ করুন কিভাবে প্যাঙ্গেল পরীক্ষার বিজ্ঞাপনগুলি সক্ষম করতে হয় সে সম্পর্কে একটি পরীক্ষা বিজ্ঞাপন নির্দেশিকা যুক্ত করুন

ধাপ 2: Ad Manager UI-তে Pangle চাহিদা সেট আপ করুন

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

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

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

iOS

নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।

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

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

ধাপ 3: প্যাঙ্গেল SDK এবং অ্যাডাপ্টার আমদানি করুন

OpenUPM-CLI

আপনার যদি OpenUPM-CLI ইনস্টল করা থাকে, তাহলে আপনি আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার প্রোজেক্টে ইউনিটির জন্য Google Mobile Ads Pangle Mediation Plugin ইনস্টল করতে পারেন:

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

OpenUPM

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

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

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

OpenUPM বিবরণ

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

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

Google মোবাইল বিজ্ঞাপন প্যাঙ্গেল মধ্যস্থতা প্যাকেজ নির্বাচন করুন এবং ইনস্টল করুন ক্লিক করুন।

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

ঐক্য প্যাকেজ

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

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

ঐক্য থেকে আমদানি

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

জোর করে সমাধান করুন

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

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

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

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

Pangle.SetGDPRConsent(0);

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

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

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

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

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

Pangle.SetPAConsent(0);

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

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

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

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

iOS

SKAdNetwork ইন্টিগ্রেশন

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

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

পরীক্ষা বিজ্ঞাপন সক্ষম করুন

নিশ্চিত করুন যে আপনি অ্যাড ম্যানেজারের জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং Pangle UI-তে পরীক্ষা মোড সক্ষম করেছেন

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

আপনি Pangle থেকে পরীক্ষার বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, Pangle (Bidding) এবং Pangle (Waterfall) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।

ত্রুটি কোড

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

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

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

iOS

GADMediationAdapterPangle

প্যাঙ্গেল অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে যখন একটি বিজ্ঞাপন লোড হতে ব্যর্থ হয়:

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

ত্রুটি কোড ডোমেইন কারণ
101 com.google.ads.mediation.pangle অবৈধ সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)।
102 com.google.ads.mediation.pangle অনুরোধ করা বিজ্ঞাপনের আকার একটি Pangle সমর্থিত ব্যানার আকারের সাথে মেলে না।
103 com.google.ads.mediation.pangle অনুপস্থিত বা অবৈধ বিড প্রতিক্রিয়া.
-1-60000 com.pangle.ads Pangle SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য Pangle এর ডকুমেন্টেশন দেখুন.

iOS

ত্রুটি কোড ডোমেইন কারণ
101 com.google.ads.mediation.pangle অবৈধ সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)।
102 com.google.ads.mediation.pangle অনুরোধ করা বিজ্ঞাপনের আকার একটি Pangle সমর্থিত ব্যানার আকারের সাথে মেলে না।
-1-60000 প্যাঙ্গেল এসডিকে পাঠিয়েছে Pangle SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য Pangle এর ডকুমেন্টেশন দেখুন.

প্যাঙ্গেল ইউনিটি মধ্যস্থতা প্লাগইন চেঞ্জলগ

সংস্করণ 5.3.0

সংস্করণ 5.2.2

সংস্করণ 5.2.1

সংস্করণ 5.2.0

সংস্করণ 5.1.1

সংস্করণ 5.1.0

সংস্করণ 5.0.0

সংস্করণ 4.6.2

সংস্করণ 4.6.1

সংস্করণ 4.6.0

সংস্করণ 4.5.4

সংস্করণ 4.5.3

সংস্করণ 4.5.2

সংস্করণ 4.5.1

সংস্করণ 4.5.0

সংস্করণ 4.4.2

সংস্করণ 4.4.1

সংস্করণ 4.4.0

সংস্করণ 4.3.3

সংস্করণ 4.3.2

সংস্করণ 4.3.1

সংস্করণ 4.3.0

সংস্করণ 4.2.1

সংস্করণ 4.2.0

সংস্করণ 4.1.0

সংস্করণ 4.0.1

সংস্করণ 4.0.0

সংস্করণ 3.0.0

সংস্করণ 2.8.1

সংস্করণ 2.8.0

সংস্করণ 2.7.0

সংস্করণ 2.6.0

সংস্করণ 2.5.0

সংস্করণ 2.4.0

সংস্করণ 2.3.0

সংস্করণ 2.2.0

সংস্করণ 2.1.0

সংস্করণ 2.0.0

সংস্করণ 1.5.1

সংস্করণ 1.5.0

সংস্করণ 1.4.0

সংস্করণ 1.3.1

সংস্করণ 1.3.0

সংস্করণ 1.2.0

সংস্করণ 1.1.0

সংস্করণ 1.0.0