মধ্যস্থতার সাথে Pangle ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (পুরনো)

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

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

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

ইন্টিগ্রেশন
বিডিং  ১
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলার সাথে সাথে দেখা যায়  ২
ব্যানার  ২
স্থান
পুরস্কার জিতেছেন
পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল
নেটিভ  ২

১ উপলভ্য Pangle বিডিং বিজ্ঞাপন সোর্সের মধ্যে Pangle US, Pangle KR এবং Pangle ROW অন্তর্ভুক্ত।

২ এই ফর্ম্যাটটি নিম্নলিখিত Pangle বিডিং বিজ্ঞাপন সোর্সের জন্য কাজ করে না: Pangle US.

পূর্বশর্ত

  • Google Mobile Ads Flutter Plugin-এর লেটেস্ট ভার্সন।
  • [For Pangle US bidding]: Use Pangle adapter version 3.1.0 or higher.
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ করুন Google Mobile Ads Flutter Plugin দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

    বিডিং

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

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

    Android

    iOS

    জলপ্রপাত

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

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

    Android

    iOS

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

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

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

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

    Pangle-এর টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন তা জানতে কীভাবে টেস্ট বিজ্ঞাপন যোগ করবেন গাইডে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

    Android

    নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

    iOS

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

    জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় Pangle DSP যোগ করুন

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

    ধাপ ৩: Pangle SDK ও অ্যাডাপ্টার ইমপোর্ট করা

    pub.dev-এর মাধ্যমে ইন্টিগ্রেশন

    (শুধুমাত্র Android-এর জন্য) আপনার প্রজেক্টের android ডিরেক্টরির মধ্যে থাকা build.gradle ফাইলে নিচের রেপোজিটরি যোগ করুন:

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

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

    dependencies:
  gma_mediation_pangle: ^4.2.1

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

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

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

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

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

    Pangle Flutter অ্যাডাপ্টার ভার্সন 3.6.0 এবং তার পরবর্তী ভার্সনে, Pangle অটোমেটিক GDPR সম্মতি পড়ে যা সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা হয় এবং যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন এবং UMP SDK-কে সাপোর্ট করে।

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

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

    Pangle SDK-তে কীভাবে সম্মতি সংক্রান্ত তথ্য পাস করতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে জানতে পারবেন। শুরু করার Google Mobile Ads Flutter Plugin আগে সম্মতি সংক্রান্ত তথ্য সেট করুন যাতে সেগুলি সঠিকভাবে Pangle SDK-তে ফরওয়ার্ড করা হয়।

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

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

    Android

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

    iOS

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

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

    ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা

    টেস্ট বিজ্ঞাপন চালু করুন

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং Pangle UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।

    টেস্ট বিজ্ঞাপন যাচাই করা

    আপনি যে Pangle-এর থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন। এটি করতে, Pangle (ওয়াটারফল), Pangle US SDK (বিডিং), Pangle KR SDK (বিডিং) এবং Pangle ROW SDK (বিডিং) বিজ্ঞাপন সোর্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শকের মধ্যে যান।

    সমস্যার কোড

    অ্যাডাপ্টার Pangle-এর থেকে বিজ্ঞাপন না পেলে, প্রকাশকরা নিম্নলিখিত ক্লাস থেকে ResponseInfo ব্যবহার করে বিজ্ঞাপন উত্তরের আসল সমস্যা চেক করতে পারবেন:

    Android

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

    iOS

    GADMediationAdapterPangle

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

    Android

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

    iOS

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.mediation.pangle ভুল সার্ভার প্যারামিটার (যেমন, অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)।
    102 com.google.mediation.pangle অনুরোধ করা বিজ্ঞাপনের সাইজ Pangle-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    104 com.google.mediation.pangle Pangle SDK-তে ব্যবহারকারী প্রাপ্তবয়স্ক না হলে কাজ করে না।
    -1-60000 Pangle SDK-এর মাধ্যমে পাঠানো হয়েছে Pangle SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য Pangle-এর ডকুমেন্টেশন দেখুন।

    Pangle Flutter মধ্যস্থতা অ্যাডাপ্টারের পরিবর্তনের লগ

    ভার্সন ৪.২.১

    ভার্সন 4.2.0

    ভার্সন 4.1.2

    ভার্সন 4.1.1

    ভার্সন 4.1.0

    ভার্সন 4.0.0

    ভার্সন 3.6.0

    ভার্সন ৩.৫.৩

    ভার্সন 3.5.2

    ভার্সন ৩.৫.১

    ভার্সন 3.5.0

    ভার্সন 3.4.0

    ভার্সন 3.3.0

    ভার্সন ৩.২.১

    ভার্সন 3.2.0

    ভার্সন ৩.১.১

    ভার্সন 3.1.0

    ভার্সন 3.0.0

    ভার্সন 2.2.0

    ভার্সন 2.1.0

    ভার্সন 2.0.0

    ভার্সন 1.1.0

    ভার্সন 1.0.0