এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে AppLovin থেকে মধ্যস্থতা ব্যবহার করে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং এবং জলপ্রপাত উভয়ই একীভূতকরণকে কভার করে৷ এটি কভার করে কিভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে AppLovin যোগ করতে হয় এবং কিভাবে AppLovin SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে সংহত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
AppLovin-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| মিশ্রণ | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| ব্যানার | 1 |
| কৌশলে | |
| পুরস্কৃত | |
ব্যানার বিজ্ঞাপন (MREC ব্যানার ব্যতীত) শুধুমাত্র মধ্যস্থতায় সমর্থিত। বিডিং কোনো ধরনের ব্যানার বিজ্ঞাপন সমর্থন করে না।
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDKএর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: AppLovin UI এ কনফিগারেশন সেট আপ করুন
সাইন আপ করুন বা আপনার AppLovin অ্যাকাউন্টে লগ ইন করুন ।
আপনার AdMob বিজ্ঞাপন ইউনিট সেট আপ করতে, আপনার AppLovin SDK কী এবং রিপোর্ট কী প্রয়োজন। সেগুলি খুঁজে পেতে, উভয় মান দেখতে AppLovin UI > অ্যাকাউন্ট > কী- তে যান৷
আপনি যদি শুধু বিডিং একীভূত করার পরিকল্পনা করেন, আপনি আপনার মধ্যস্থতা সেটিংস কনফিগার করতে এগিয়ে যেতে পারেন।
মধ্যস্থতার জন্য অ্যাপ নির্বাচন করুন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
AppLovin UI-তে, আপনার নিবন্ধিত অ্যাপগুলি পেতে মনিটাইজেশন বিভাগের অধীনে অ্যাপ্লিকেশনগুলি নির্বাচন করুন৷ উপলব্ধ অ্যাপ্লিকেশানগুলির তালিকা থেকে আপনি মধ্যস্থতার সাথে যে অ্যাপটি ব্যবহার করতে চান সেটি নির্বাচন করুন৷
একটি জোন তৈরি করুন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
AppLovin UI-তে, আপনার নিবন্ধিত জোন আইডিগুলি পেতে মনিটাইজেশন বিভাগের অধীনে অঞ্চলগুলি নির্বাচন করুন৷ আপনি যদি ইতিমধ্যেই আপনার অ্যাপের জন্য প্রয়োজনীয় জোন তৈরি করে থাকেন, তাহলে ধাপ 2 এ যান। একটি নতুন জোন আইডি তৈরি করতে, জোন তৈরি করুন ক্লিক করুন।
জোন আইডির নাম লিখুন, প্ল্যাটফর্ম হিসাবে অ্যান্ড্রয়েড নির্বাচন করুন এবং বিজ্ঞাপনের ধরন নির্বাচন করুন।
ফ্ল্যাট CPM বা AppLovin দ্বারা অপ্টিমাইজ করা নির্বাচন করে জোনের জন্য মূল্য নির্ধারণ করুন। ফ্ল্যাট CPM বিকল্পের জন্য প্রতি দেশের ভিত্তিতে CPMগুলি কনফিগার করা যেতে পারে। তারপর, Save এ ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
জোন তৈরি হয়ে গেলে, জোন আইডি জোন আইডি কলামের অধীনে পাওয়া যাবে।
অ্যান্ড্রয়েড
iOS
পরীক্ষা মোড চালু করুন
AppLovin-এরMAX টেস্ট মোড অ্যাপলোভিন পরীক্ষার বিজ্ঞাপনগুলি কীভাবে সক্ষম করবেন তার নির্দেশিকা অনুসরণ করুন৷
ধাপ 2: AdMob UI এ AppLovin চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য,Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য,iOS- এর জন্য গাইডের ধাপ 2 দেখুন।
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় AppLovin Corp. যোগ করুন
GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংসএ ধাপগুলি অনুসরণ করুন AdMob UI এ।
ধাপ 3: AppLovin SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলেAppLovin SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_applovin: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
AppLovin এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
ধাপ 4: AppLovin SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
AppLovin শেয়ার করা পছন্দগুলি থেকে সম্মতি স্ট্রিং পড়তে এবং সেই অনুযায়ী সম্মতির স্থিতি সেট করতে সমর্থন করে৷ আপনি যদিএকটি CMP ব্যবহার না করেন যা শেয়ার করা পছন্দগুলিতে সম্মতি স্ট্রিং লেখে, আপনিGmaMediationApplovin.setHasUserConsent() এবং GmaMediationApplovin.setIsAgeRestrictedUser()পদ্ধতি। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে AppLovin SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে এই বিকল্পগুলি অবশ্যই সেট করতে হবে যাতে সেগুলি AppLovin SDK-এ সঠিকভাবে ফরওয়ার্ড করা হয়।
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
আরও তথ্যের জন্য AppLovin এর গোপনীয়তা সেটিংস দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়ার প্রয়োজন (যেমন আইন সেই শর্তাদি সংজ্ঞায়িত করে), অপ্ট-আউট সহ "বিক্রয়" পার্টির হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অফার করা হয়েছে। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
AppLovinএর জন্য Google মোবাইল বিজ্ঞাপনের মধ্যস্থতা প্লাগইনটিতেGmaMediationApplovin.setDoNotSell() নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে AppLovin SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে এই বিকল্পগুলি অবশ্যই সেট করতে হবে যাতে সেগুলি AppLovin SDK-এ সঠিকভাবে ফরওয়ার্ড করা হয়।
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
আরও তথ্যের জন্য AppLovin এর গোপনীয়তা ডকুমেন্টেশন দেখুন।
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
AppLovin ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist` ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে AppLovin এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনিAdMob এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং AppLovin UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনিAppLovinথেকে পরীক্ষামূলক বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, AppLovin (Bidding) and AppLovin (Waterfall) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ঐচ্ছিক পদক্ষেপ
নেটওয়ার্ক-নির্দিষ্ট পরামিতি
AppLovin অ্যাডাপ্টার নেটওয়ার্ক-নির্দিষ্ট পরামিতি সেট করার জন্য বিজ্ঞাপন অনুরোধে একটি AppLovinMediationExtras অবজেক্ট পাস করা সমর্থন করে। নিচের নমুনা কোডটি দেখায় কিভাবে isMuted প্যারামিটার ব্যবহার করে ভিডিও বিজ্ঞাপনে অডিও অক্ষম করতে হয়:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
অপ্টিমাইজেশন
আপনার লঞ্চ কার্যকলাপেGmaMediationApplovin.initializeSdk('sdkKey')এ একটি কল যুক্ত করা অ্যাপলোভিনকে অ্যাপের সাথে সাথে ইভেন্টগুলি ট্র্যাক করার ক্ষমতা প্রদান করে৷
ত্রুটি কোড
যদি অ্যাডাপ্টার AppLovin থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয় তখন অ্যাপলোভিন অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
| ভুল সংকেত | কারণ |
|---|---|
| -1009 থেকে -1, 204 | AppLovin SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য AppLovin এর ডকুমেন্টেশন দেখুন। |
| 101 | অনুরোধ করা বিজ্ঞাপনের আকার একটি AppLovin সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 103 | প্রসঙ্গ শূন্য। |
| 104 | AppLovin বিড টোকেন খালি। |
| 105 | একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে৷ AppLovin শুধুমাত্র প্রতি অঞ্চলে একবারে 1টি বিজ্ঞাপন লোড করতে পারে৷ |
| 106 | বিজ্ঞাপন প্রদর্শনের জন্য প্রস্তুত নয়। |
| 108 | অ্যাপলভিন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না। |
iOS
| ভুল সংকেত | কারণ |
|---|---|
| -1009 থেকে -1, 204 | AppLovin SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য AppLovin এর ডকুমেন্টেশন দেখুন। |
| 101 | অনুরোধ করা বিজ্ঞাপনের আকার একটি AppLovin সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 102 | AdMob UI এ কনফিগার করা AppLovin সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
| 103 | AppLovin বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
| 104 | একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে৷ AppLovin শুধুমাত্র প্রতি অঞ্চলে একবারে 1টি বিজ্ঞাপন লোড করতে পারে৷ |
| 105 | AppLovin SDK কী পাওয়া যায়নি। |
| 107 | বিড টোকেন খালি। |
| 108 | অ্যাপলভিন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না। |
| 110 | AppLovin একটি সফল লোড কলব্যাক পাঠিয়েছে কিন্তু শূন্য বিজ্ঞাপন লোড করেছে৷ |
AppLovin Flutter Mediation Adapter Changelog
1.1.0
- GmaMediationApplovin-এর API আর স্থির নয়।
- AppLovin Android অ্যাডাপ্টার সংস্করণ 12.4.3.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- AppLovin iOS অ্যাডাপ্টারের সংস্করণ 12.4.2.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.0.0
- প্রাথমিক মুক্তি।
- AppLovin Android অ্যাডাপ্টার সংস্করণ 12.3.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- AppLovin iOS অ্যাডাপ্টারের সংস্করণ 12.2.1.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি এবং পরীক্ষিত।