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

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

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

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

মধ্যস্থতা প্ল্যাটফর্ম হিসেবে Google AdMob বেছে নিন, তারপর প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

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

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

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

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

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

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

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

Meta Audience Network টেস্ট বিজ্ঞাপন কীভাবে চালু করতে হয় সেই সম্পর্কে বিস্তারিত নির্দেশাবলী পেতে, Audience Network প্রয়োগ করা সংক্রান্ত নির্দেশিকা দেখুন।

ধাপ ২: AdMob UI-তে Meta Audience Network-এর চাহিদা সেট-আপ করা

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_meta: ^1.7.1

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন এবং 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 মেডিয়েশন অ্যাডাপ্টার পরিবর্তন লগ

ভার্সন 1.7.1

ভার্সন 1.7.0

ভার্সন 1.6.0

ভার্সন 1.5.4

ভার্সন 1.5.3

ভার্সন 1.5.2

ভার্সন 1.5.1

ভার্সন 1.5.0

ভার্সন ১.৪.৩

ভার্সন 1.4.2

ভার্সন 1.4.1

ভার্সন 1.4.0

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.1

ভার্সন 1.0.0