বিডিং ইন্টিগ্রেশন কভার করে মধ্যস্থতা ব্যবহার করে মেটা অডিয়েন্স নেটওয়ার্ক থেকে বিজ্ঞাপন লোড ও প্রদর্শন করতে কীভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করবেন এই নির্দেশিকা আপনাকে দেখায়। এটি কভার করে কিভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে মেটা অডিয়েন্স নেটওয়ার্ক যোগ করতে হয় এবং কীভাবে মেটা অডিয়েন্স নেটওয়ার্ক এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপ
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
দ AdMob মেটা অডিয়েন্স নেটওয়ার্কের জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত ঘ | |
| বিন্যাস | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
1 মেটা অডিয়েন্স নেটওয়ার্ক শুধুমাত্র 2021 সালে বিডিং হয়েছে।
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 10.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- সাম্প্রতিক মেটা অডিয়েন্স নেটওয়ার্ক SDK-এর জন্য সাধারণত Xcode-এর সর্বশেষ সংস্করণ প্রয়োজন।
- একটি কাজ Flutter প্রোজেক্টটি Google Mobile Ads SDK-এর সাথে কনফিগার করা হয়েছে। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: মেটা অডিয়েন্স নেটওয়ার্ক UI-তে কনফিগারেশন সেট আপ করুন
সাইন আপ করুন এবং বিজনেস ম্যানেজার স্টার্ট পেজে লগ ইন করুন।
শুরু করুন ক্লিক করুন তারপর নতুন অ্যাকাউন্ট তৈরি করুন ।
আপনার ব্যবসার বিবরণ সহ প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন এবং পরবর্তী ক্লিক করুন।
একটি সম্পত্তি তৈরি করুন
আপনি প্রয়োজনীয় তথ্য পূরণ করার পরে, আপনাকে আপনার অ্যাপের জন্য একটি সম্পত্তি তৈরি করতে বলা হবে। আপনার অ্যাপের জন্য প্রপার্টির পছন্দসই নাম লিখুন এবং Next এ ক্লিক করুন।
এরপরে, নগদীকরণ করতে আপনার প্ল্যাটফর্ম নির্বাচন করুন।
আপনার অ্যাপের বিবরণ যোগ করুন এবং পরবর্তী ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
একটি নতুন পেমেন্ট অ্যাকাউন্ট যোগ করুন ক্লিক করে আপনার পেমেন্ট অ্যাকাউন্ট সেট আপ করুন। আপনার অর্থপ্রদানের তথ্য লিখতে আপনাকে একটি নতুন পৃষ্ঠায় পুনঃনির্দেশিত করা হবে। প্রয়োজনীয় বিবরণ পূরণ করুন, তারপর Next এ ক্লিক করুন।
মধ্যস্থতা প্ল্যাটফর্ম হিসাবে Google AdMob নির্বাচন করুন, তারপরে প্লেসমেন্ট তৈরি করুন ক্লিক করুন।
একটি বিন্যাস নির্বাচন করুন, ফর্মটি পূরণ করুন এবং তৈরি করুন ক্লিক করুন।
প্লেসমেন্ট আইডি নোট করুন।
সম্পন্ন ক্লিক করুন.
পরীক্ষা মোড চালু করুন
কিভাবে মেটা অডিয়েন্স নেটওয়ার্ক পরীক্ষা বিজ্ঞাপন সক্ষম করতে হয় তার বিস্তারিত নির্দেশাবলীর জন্য টেস্টিং অডিয়েন্স নেটওয়ার্ক বাস্তবায়ন নির্দেশিকা দেখুন।
ধাপ 2: মেটা অডিয়েন্স নেটওয়ার্ক চাহিদা সেট আপ করুন AdMob UI
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, নির্দেশিকাতে ধাপ 2 দেখুনঅ্যান্ড্রয়েড
iOS
নির্দেশাবলীর জন্য, নির্দেশিকাতে ধাপ 2 দেখুনiOS
যোগ করুন Facebook জিডিপিআর এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায়
AdMob UI-তে GDPR এবং US রাজ্যের বিধিবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় Meta যোগ করতে GDPR সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: মেটা অডিয়েন্স নেটওয়ার্ক SDK এবং অ্যাডাপ্টার আমদানি করুন
Pub.dev এর মাধ্যমে সংহতকরণ
এর সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুনMeta Audience Network আপনার প্যাকেজের pubspec.yaml ফাইলটিতে এসডিকে এবং অ্যাডাপ্টার:
dependencies:
gma_mediation_meta: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
গুগল মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন এর সর্বশেষ সংস্করণটি ডাউনলোড করুনMeta Audience Network , ডাউনলোড করা ফাইলটি বের করুন এবং আপনার ঝাঁকুনির প্রকল্পে নিষ্কাশিত প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) যুক্ত করুন। তারপরে, নিম্নলিখিত নির্ভরতা যুক্ত করে আপনার pubspec.yaml ফাইলটিতে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_meta:
path: path/to/local/package
Pub.dev এর মাধ্যমে সংহতকরণ
এর সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুনMeta Audience Network আপনার প্যাকেজের pubspec.yaml ফাইলটিতে এসডিকে এবং অ্যাডাপ্টার:
dependencies:
gma_mediation_meta: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
গুগল মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন এর সর্বশেষ সংস্করণটি ডাউনলোড করুনMeta Audience Network , ডাউনলোড করা ফাইলটি বের করুন এবং আপনার ঝাঁকুনির প্রকল্পে নিষ্কাশিত প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) যুক্ত করুন। তারপরে, নিম্নলিখিত নির্ভরতা যুক্ত করে আপনার pubspec.yaml ফাইলটিতে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_meta:
path: path/to/local/package
ধাপ 4: মেটা অডিয়েন্স নেটওয়ার্ক SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
জিডিপিআর এবং মেটা বিজ্ঞাপন সম্পর্কে তথ্যের জন্য মেটার নির্দেশিকা পর্যালোচনা করুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার প্রদান করতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" এ একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে "পার্টির হোমপেজ। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
ক্যালিফোর্নিয়ার ব্যবহারকারীদের জন্য, মেটার ডেটা প্রক্রিয়াকরণ বিকল্পগুলি পর্যালোচনা করুন৷
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
মেটা অডিয়েন্স নেটওয়ার্ক ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে মেটা অডিয়েন্স নেটওয়ার্কের ডকুমেন্টেশন অনুসরণ করুন।
বিজ্ঞাপন ট্র্যাকিং সক্ষম
আপনি যদি iOS 14 বা উচ্চতর সংস্করণের জন্য তৈরি করেন, তাহলে তাদের বিজ্ঞাপন ট্র্যাকিং ফ্ল্যাগ কীভাবে সেট করবেন সে সম্পর্কে মেটা অডিয়েন্স নেটওয়ার্কের নির্দেশাবলী দেখুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং মেটা অডিয়েন্স নেটওয়ার্ক UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি মেটা অডিয়েন্স নেটওয়ার্ক থেকে পরীক্ষামূলক বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, মেটা অডিয়েন্স নেটওয়ার্ক (বিডিং) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন৷
ঐচ্ছিক পদক্ষেপ
Android 9-এ ক্যাশিং
অ্যান্ড্রয়েড
Android 9 (API স্তর 28) দিয়ে শুরু করে, ক্লিয়ারটেক্সট সমর্থন ডিফল্টরূপে অক্ষম করা হয় , যা মেটা অডিয়েন্স নেটওয়ার্ক SDK-এর মিডিয়া ক্যাশিংয়ের কার্যকারিতাকে প্রভাবিত করবে এবং ব্যবহারকারীর অভিজ্ঞতা এবং বিজ্ঞাপনের আয়কে প্রভাবিত করতে পারে। আপনার অ্যাপে নেটওয়ার্ক নিরাপত্তা কনফিগারেশন আপডেট করতে Meta এর ডকুমেন্টেশন অনুসরণ করুন।
iOS
iOS ইন্টিগ্রেশনের জন্য প্রযোজ্য নয়।
ত্রুটি কোড
যদি অ্যাডাপ্টার অডিয়েন্স নেটওয়ার্ক থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
একটি বিজ্ঞাপন লোড হতে ব্যর্থ হলে মেটা অডিয়েন্স নেটওয়ার্ক অ্যাডাপ্টার দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
| ত্রুটি কোড | কারণ |
|---|---|
| 101 | অবৈধ সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)। |
| 102 | অনুরোধ করা বিজ্ঞাপনের আকার মেটা অডিয়েন্স নেটওয়ার্ক সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 103 | প্রকাশককে অবশ্যই একটি Activity প্রসঙ্গ সহ বিজ্ঞাপনগুলির জন্য অনুরোধ করতে হবে৷ |
| 104 | মেটা অডিয়েন্স নেটওয়ার্ক SDK আরম্ভ করতে ব্যর্থ হয়েছে৷ |
| 105 | প্রকাশক ইউনিফাইড নেটিভ বিজ্ঞাপনের জন্য অনুরোধ করেননি। |
| 106 | নেটিভ বিজ্ঞাপন লোড করা প্রত্যাশিত একটি থেকে ভিন্ন বস্তু। |
| 107 | ব্যবহৃত Context বস্তুটি অবৈধ। |
| 108 | লোড করা বিজ্ঞাপনে প্রয়োজনীয় নেটিভ বিজ্ঞাপন সম্পদ নেই। |
| 109 | বিড পেলোড থেকে একটি নেটিভ বিজ্ঞাপন তৈরি করতে ব্যর্থ হয়েছে৷ |
| 110 | মেটা অডিয়েন্স নেটওয়ার্ক SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কারপ্রাপ্ত বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে। |
| 111 | একটি মেটা অডিয়েন্স নেটওয়ার্ক AdView অবজেক্ট তৈরি করার সময় ব্যতিক্রম। |
| 1000-9999 | মেটা অডিয়েন্স নেটওয়ার্ক একটি SDK-নির্দিষ্ট ত্রুটি ফিরিয়ে দিয়েছে। আরও বিস্তারিত জানার জন্য মেটা অডিয়েন্স নেটওয়ার্কের ডকুমেন্টেশন দেখুন। |
iOS
| ত্রুটি কোড | কারণ |
|---|---|
| 101 | অবৈধ সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)। |
| 102 | অনুরোধ করা বিজ্ঞাপনের আকার মেটা অডিয়েন্স নেটওয়ার্ক সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 103 | মেটা অডিয়েন্স নেটওয়ার্ক বিজ্ঞাপন বস্তুটি আরম্ভ করতে ব্যর্থ হয়েছে৷ |
| 104 | মেটা অডিয়েন্স নেটওয়ার্ক SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কারপ্রাপ্ত বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে। |
| 105 | ব্যানার বিজ্ঞাপনের রুট ভিউ কন্ট্রোলার nil । |
| 106 | মেটা অডিয়েন্স নেটওয়ার্ক SDK আরম্ভ করতে ব্যর্থ হয়েছে৷ |
| 1000-9999 | মেটা অডিয়েন্স নেটওয়ার্ক একটি SDK-নির্দিষ্ট ত্রুটি ফিরিয়ে দিয়েছে। আরও বিস্তারিত জানার জন্য মেটা অডিয়েন্স নেটওয়ার্কের ডকুমেন্টেশন দেখুন। |
মেটা অডিয়েন্স নেটওয়ার্ক ফ্লটার মেডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
পরবর্তী সংস্করণ
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.1.0
- মেটা অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.17.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- মেটা iOS অ্যাডাপ্টার সংস্করণ 6.15.2.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.0.1
- হোস্ট প্ল্যাটফর্মের সাথে সঠিক সামঞ্জস্য বিশ্লেষণের অনুমতি দিতে ডার্ট ক্লাস যোগ করা হয়েছে
- মেটা অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.17.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- মেটা iOS অ্যাডাপ্টারের সংস্করণ 6.15.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.0.0
- প্রাথমিক মুক্তি।
- মেটা অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 6.17.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- মেটা iOS অ্যাডাপ্টারের সংস্করণ 6.15.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি এবং পরীক্ষিত।