মেডিয়েশনের সাথে myTarget ইন্টিগ্রেট করা

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

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

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

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

  • লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Flutter Plugin সেট-আপ করুন দেখুন।
  • AdMob মেডিয়েশন সেট-আপ করুন।

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

    আপনার myTarget অ্যাকাউন্টে লগ-ইন করুন। হেডারে অ্যাপ বিকল্পে ক্লিক করে অ্যাপ পৃষ্ঠায় নেভিগেট করুন। অ্যাপ যোগ করুন বিকল্পে ক্লিক করে আপনার অ্যাপ যোগ করুন।

    আপনার অ্যাপ Android এবং iOS প্ল্যাটফর্মে কাজ করলে, আপনাকে প্রতিটি প্ল্যাটফর্মের জন্য আলাদাভাবে সেট-আপ করতে হবে।

    Android

    এরপর, আপনার অ্যাপের জন্য Google Play URL প্রদান করুন।

    iOS

    এরপর, আপনার অ্যাপের জন্য iTunes URL** প্রদান করুন।

    অ্যাপ যোগ করার সময়, প্রক্রিয়া সম্পূর্ণ করার আগে myTarget আপনাকে একটি বিজ্ঞাপন ইউনিট তৈরি করতে বলে।

    বিকল্পে ক্লিক করুন।

    উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে ব্যানার বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

    স্থান

    উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে ইন্টারস্টিশিয়াল বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

    পুরস্কার জিতেছেন

    উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে পুরস্কার প্রদানকারী ভিডিও বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

    নেটিভ

    উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে নেটিভ বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

    আপনার বিজ্ঞাপন ইউনিটের বিবরণ পৃষ্ঠায়, স্লট আইডি নোট করুন যা বিজ্ঞাপন ইউনিট সেটিংসের অধীনে slot_id হিসেবে দেখতে পাবেন। পরবর্তী বিভাগে আপনার AdMob বিজ্ঞাপন ইউনিট সেট-আপ করতে এই স্লট আইডি ব্যবহার করা হবে।

    slot_id ছাড়াও, AdMob বিজ্ঞাপন ইউনিট আইডি সেট-আপ করতে আপনার myTarget স্থায়ী অ্যাক্সেস টোকেন প্রয়োজন হবে। প্রোফাইল ট্যাবে নেভিগেট করুন এবং অ্যাক্সেস টোকেন বেছে নিন। আপনার myTarget স্থায়ী অ্যাক্সেস টোকেন দেখতে টোকেন তৈরি করুন বা টোকেন দেখুন বিকল্পে ক্লিক করুন।

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

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

    myTarget-এর জন্য app-ads.txt প্রয়োগ করতে, কীভাবে ফাইল তৈরি ও প্রকাশ করতে হয় তা দেখুন।

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

    myTarget UI-তে টেস্ট ডিভাইস যোগ ও কনফিগার করতে myTarget-এর ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

    Android

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

    iOS

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

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

    AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Mail.ru যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস ধাপগুলি অনুসরণ করুন।

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

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

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

    dependencies:
  gma_mediation_mytarget: ^1.15.0

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

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

    dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

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

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

    myTarget Flutter অ্যাডাপ্টার ভার্সন 1.13.0 এবং পরবর্তী ভার্সন UMP SDK থেকে GDPR সম্মতি সিগন্যাল পাস করা এবং সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন myTarget SDK-তে ইন্টিগ্রেট করে।

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

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

    Android এবং iOS ডেভেলপার গাইডে মার্কিন যুক্তরাষ্ট্রের রাজ্য গোপনীয়তা আইন বিভাগ দেখুন।

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

    Android

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

    iOS

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

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

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

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

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

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

    আপনি myTarget থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, myTarget (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    ত্রুটি কোড

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

    Android

    com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

    iOS

    GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

    কোনও বিজ্ঞাপন লোড না হলে, myTarget অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:

    Android

    সমস্যার কোড কারণ
    100 myTarget SDK-তে কোনও সমস্যা হয়েছে।
    ১০১ AdMob UI-তে কনফিগার করা myTarget সার্ভার প্যারামিটার নেই/ভুল।
    102 অনুরোধ করা বিজ্ঞাপনের সাইজ, myTarget-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    103 বিজ্ঞাপনের অনুরোধটি ইউনিফায়েড নেটিভ বিজ্ঞাপনের অনুরোধ নয়।
    104 myTarget থেকে লোড করা নেটিভ বিজ্ঞাপন অনুরোধ করা নেটিভ বিজ্ঞাপনের থেকে আলাদা।
    ১০৫ myTarget থেকে লোড করা নেটিভ বিজ্ঞাপনে কিছু প্রয়োজনীয় অ্যাসেট (যেমন, ছবি বা আইকন) নেই।
    106 myTarget SDK বিজ্ঞাপন দেখাতে পারেনি।

    iOS

    সমস্যার কোড কারণ
    100 myTarget SDK-তে এখনও কোনও বিজ্ঞাপন উপলভ্য নেই।
    ১০১ AdMob UI-তে কনফিগার করা myTarget সার্ভার প্যারামিটার নেই/ভুল।
    102 অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট myTarget অ্যাডাপ্টারে কাজ করে না।
    103 একটি myTarget বিজ্ঞাপন দেখানোর চেষ্টা করা হয়েছে যা লোড করা হয়নি।
    104 অনুরোধ করা বিজ্ঞাপনের সাইজ, myTarget-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    ১০৫ প্রয়োজনীয় নেটিভ বিজ্ঞাপন অ্যাসেট নেই।

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

    ভার্সন 1.16.0 (কাজ চলছে)

    ভার্সন 1.15.0

    ভার্সন 1.14.1

    ভার্সন 1.14.0

    ভার্সন 1.13.0

    ভার্সন 1.12.0

    ভার্সন 1.11.0

    ভার্সন 1.10.0

    ভার্সন 1.9.0

    ভার্সন 1.8.0

    ভার্সন ১.৭.১

    • Flutter-এর ন্যূনতম ভার্সন 3.35.1-এ আপডেট করা হয়েছে
    • Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৭.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে

    ভার্সন 1.7.0

    ভার্সন 1.6.0

    ভার্সন ১.৫.০

    ভার্সন 1.4.0

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0