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

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

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

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

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

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

  • সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
  • ফ্লটার 3.7.0 বা উচ্চতর
  • [বিডিংয়ের জন্য]: বিডিং-এ সমস্ত সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলিকে একীভূত করতে, 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

Pangle রিপোর্টিং API কী সনাক্ত করুন

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।

জলপ্রপাত

পৃষ্ঠার নীচে বাম কোণে ব্যবহারকারী আইডিটি নোট করুন।

ইন্টিগ্রেশন > SDK & API > Pangle Reporting API 2.0-এ ক্লিক করুন। ভূমিকা আইডি এবং নিরাপত্তা কী নোট নিন।

আপনার 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: AdMob UI-তে Pangle চাহিদা সেট-আপ করুন

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

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

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

iOS

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

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

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

ধাপ 3: প্যাঙ্গেল 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: ^

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

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

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

ধাপ 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: আপনার বাস্তবায়ন পরীক্ষা করুন

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

নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং 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 এর ডকুমেন্টেশন দেখুন.

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

সংস্করণ 2.2.0

সংস্করণ 2.1.0

সংস্করণ 2.0.0

সংস্করণ 1.1.0

সংস্করণ 1.0.0