বিডিংয়ের সাথে Meta Audience Network ইন্টিগ্রেট করা

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

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

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

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

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

১ Meta Audience Network ২০২১ সালে শুধু বিডিং হয়ে গেছে।

পূর্বশর্ত

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

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

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

    Business Manager-এর শুরু করার পৃষ্ঠাতে সাইন-আপ ও লগ-ইন করুন।

    শুরু করুন তারপর নতুন অ্যাকাউন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

    আপনার ব্যবসার বিবরণ দিয়ে প্রয়োজনীয় ফিল্ড পূরণ করুন এবং পরবর্তী বিকল্পে ক্লিক করুন।

    প্রপার্টি তৈরি করা

    প্রয়োজনীয় তথ্য পূরণ করার পরে, আপনাকে অ্যাপের জন্য একটি প্রপার্টি তৈরি করতে বলা হবে। অ্যাপের জন্য প্রপার্টির নাম লিখুন এবং পরবর্তী বিকল্পে ক্লিক করুন।

    এরপর, মনিটাইজ করার জন্য আপনার প্ল্যাটফর্ম বেছে নিন।

    আপনার অ্যাপের বিবরণ যোগ করে পরবর্তী বিকল্পে ক্লিক করুন।

    Android

    iOS

    নতুন পেমেন্ট অ্যাকাউন্ট যোগ করুন বিকল্পে ক্লিক করে আপনার পেমেন্ট অ্যাকাউন্ট সেট-আপ করুন। পেমেন্ট সংক্রান্ত তথ্য লিখতে আপনাকে একটি নতুন পৃষ্ঠায় রিডাইরেক্ট করা হবে। প্রয়োজনীয় বিবরণ পূরণ করে পরবর্তী বিকল্পে ক্লিক করুন।

    মিডিয়েশন প্ল্যাটফর্ম হিসেবে Google Ad Manager বেছে নিন, তারপর প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

    ফর্ম্যাট বেছে নিন, ফর্ম পূরণ করুন এবং তৈরি করুন বিকল্পে ক্লিক করুন।

    প্লেসমেন্ট আইডি নোট করে রাখুন।

    হয়ে গেছে বিকল্পে ক্লিক করুন।

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

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

    Meta Audience Network-এর জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt-এর মাধ্যমে অনুমোদিত বিক্রেতা শনাক্ত করা দেখুন।

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

    Meta Audience Network-এর টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন সেই সম্পর্কে বিস্তারিত নির্দেশাবলীর জন্য Testing Audience Network Implementation guide দেখুন।

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

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

    Android

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

    iOS

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

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

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

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

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

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

    dependencies:
  gma_mediation_meta: ^1.7.1

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

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

    dependencies:
  gma_mediation_meta:
    path: path/to/local/package

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

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

    জিডিপিআর (GDPR) এবং Meta বিজ্ঞাপন সম্পর্কে তথ্যের জন্য Meta-এর নির্দেশিকা পর্যালোচনা করুন।

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

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

    ক্যালিফোর্নিয়ার ব্যবহারকারীদের জন্য, Meta-এর ডেটা প্রসেসিং বিকল্প পর্যালোচনা করুন।

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

    Android

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

    iOS

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

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

    বিজ্ঞাপন ট্র্যাকিং চালু করা আছে

    আপনি iOS 14 বা তার পরবর্তী ভার্সনের জন্য তৈরি করলে, Meta Audience Network-এর বিজ্ঞাপন ট্র্যাকিং ফ্ল্যাগ কীভাবে সেট করতে হয় সেই সংক্রান্ত নির্দেশাবলী চেক করুন।

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

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

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

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

    আপনি Meta Audience Network থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Meta Audience Network (বিডিং) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    ঐচ্ছিক ধাপ

    Android 9-এ ক্যাশিং

    Android

    Android 9 (API লেভেল ২৮) থেকে শুরু করে, ডিফল্ট হিসেবে ক্লিয়ারটেক্সট সাপোর্ট বন্ধ করা থাকে, যা Meta Audience Network SDK-এর মিডিয়া ক্যাশিংয়ের কার্যকারিতাকে প্রভাবিত করবে এবং ব্যবহারকারীর অভিজ্ঞতা ও বিজ্ঞাপন থেকে উপার্জনের উপর প্রভাব ফেলতে পারে। আপনার অ্যাপে নেটওয়ার্ক সুরক্ষা কনফিগারেশন আপডেট করতে, Meta-র ডকুমেন্টেশন অনুসরণ করুন।

    iOS

    iOS ইন্টিগ্রেশনের ক্ষেত্রে প্রযোজ্য নয়।

    ত্রুটি কোড

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

    Android

    com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

    iOS

    GADMAdapterFacebook
GADMediationAdapterFacebook

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

    Android

    সমস্যার কোড কারণ
    ১০১ সার্ভার প্যারামিটার ভুল (যেমন, প্লেসমেন্ট আইডি নেই)।
    102 অনুরোধ করা বিজ্ঞাপনের সাইজ Meta Audience Network-এর সাথে কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
    103 প্রকাশককে অবশ্যই Activity কনটেক্সট সহ বিজ্ঞাপনের অনুরোধ করতে হবে।
    104 Meta Audience Network SDK শুরু করা যায়নি।
    ১০৫ প্রকাশক ইউনিফায়েড নেটিভ বিজ্ঞাপনের জন্য অনুরোধ করেননি।
    106 লোড করা নেটিভ বিজ্ঞাপনটি প্রত্যাশিত অবজেক্টের থেকে আলাদা।
    107 ব্যবহার করা Context অবজেক্টটি সঠিক নয়।
    108 লোড করা বিজ্ঞাপনে প্রয়োজনীয় নেটিভ বিজ্ঞাপন অ্যাসেট নেই।
    ১০৯ বিড পেলোড থেকে নেটিভ বিজ্ঞাপন তৈরি করা যায়নি।
    110 Meta Audience Network SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি।
    111 Meta Audience Network AdView অবজেক্ট তৈরি করার সময় ব্যতিক্রম ঘটেছে।
    1000-9999 Meta Audience Network থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও জানতে Meta Audience Network-এর ডকুমেন্টেশন দেখুন।

    iOS

    সমস্যার কোড কারণ
    ১০১ সার্ভার প্যারামিটার ভুল (যেমন, প্লেসমেন্ট আইডি নেই)।
    102 অনুরোধ করা বিজ্ঞাপনের সাইজ Meta Audience Network-এর সাথে কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
    103 Meta Audience Network বিজ্ঞাপন অবজেক্ট শুরু করা যায়নি।
    104 Meta Audience Network SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি।
    ১০৫ ব্যানার বিজ্ঞাপনের রুট ভিউ কন্ট্রোলার হল nil।
    106 Meta Audience Network SDK শুরু করা যায়নি।
    1000-9999 Meta Audience Network থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও জানতে Meta Audience Network-এর ডকুমেন্টেশন দেখুন।

    Meta Audience Network Flutter Mediation Adapter Changelog

    ভার্সন ১.৭.১

    ভার্সন ১.৭.০

    ভার্সন ১.৬.০

    ভার্সন ১.৫.৪

    ভার্সন ১.৫.৩

    ভার্সন ১.৫.২

    ভার্সন ১.৫.১

    ভার্সন ১.৫.০

    ভার্সন ১.৪.৩

    ভার্সন ১.৪.২

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন ১.০.১

    ভার্সন 1.0.0