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

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

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

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

আবশ্যকতা

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

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

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

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

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

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

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

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

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

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

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

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

পরীক্ষা মোড চালু করুন

Pangle-এর "How to a Test Ad" নির্দেশিকায় Pangle-এর পরীক্ষামূলক বিজ্ঞাপন কীভাবে সক্ষম করবেন সে সম্পর্কে নির্দেশাবলী অনুসরণ করুন।

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

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

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

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

ধাপ ৩: প্যাঙ্গেল 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.3.0

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

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

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

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

ইইউ সম্মতি এবং জিডিপিআর

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

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

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

Pangle.SetGDPRConsent(0);

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

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

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

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

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

Pangle.SetPAConsent(0);

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

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

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

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

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

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

আপনি Pangle থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Pangle (বিডিং) এবং Pangle (ওয়াটারফল) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।

ত্রুটি কোড

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

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

GADMediationAdapterPangle

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

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

সংস্করণ 3.3.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.6.0.4.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.6.0.5.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 3.2.1

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.3.0.5.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.4.1.0.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 3.2.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.3.0.4.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.4.0.9.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 3.1.1

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.2.0.6.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.2.0.5.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 3.1.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.2.0.4.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.2.0.4.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 3.0.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.1.0.8.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 7.1.1.1.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.2.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.5.0.8.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 6.5.0.9.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.1.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.5.0.4.1 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 6.5.0.8.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.0.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.4.0.6.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 6.4.1.1.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.3.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.1.0

• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 5.9.0.4.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 5.9.0.7.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.0.0

• প্রাথমিক প্রকাশ।
• প্যাঙ্গেল অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 5.8.0.9.0 সমর্থন করে।
• প্যাঙ্গেল iOS অ্যাডাপ্টার সংস্করণ 5.8.0.8.0 সমর্থন করে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.0.1 দিয়ে তৈরি এবং পরীক্ষিত।