এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে AppLovin থেকে মধ্যস্থতা ব্যবহার করে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং এবং জলপ্রপাত উভয়ই একীভূতকরণকে কভার করে৷ এটি কভার করে কিভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে AppLovin যোগ করতে হয় এবং কিভাবে AppLovin SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপ
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
দ Ad Manager AppLovin-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
ইন্টিগ্রেশন | |
---|---|
বিডিং | |
জলপ্রপাত | |
বিন্যাস | |
ব্যানার | 1 |
ইন্টারস্টিশিয়াল | |
পুরস্কৃত |
ব্যানার বিজ্ঞাপন (MREC ব্যানার ব্যতীত) শুধুমাত্র মধ্যস্থতায় সমর্থিত। বিডিং কোনো ধরনের ব্যানার বিজ্ঞাপন সমর্থন করে না।
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- একটি কাজ Flutter প্রোজেক্টটি Google Mobile Ads SDK-এর সাথে কনফিগার করা হয়েছে। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: AppLovin UI এ কনফিগারেশন সেট আপ করুন
সাইন আপ করুন বা আপনার AppLovin অ্যাকাউন্টে লগ ইন করুন ।
আপনার AdMob বিজ্ঞাপন ইউনিট সেট আপ করতে, আপনার AppLovin SDK কী এবং রিপোর্ট কী প্রয়োজন। সেগুলি খুঁজে পেতে, উভয় মান দেখতে AppLovin UI > অ্যাকাউন্ট > কী- তে যান৷
আপনি যদি শুধু বিডিং একীভূত করার পরিকল্পনা করেন, আপনি আপনার মধ্যস্থতা সেটিংস কনফিগার করতে এগিয়ে যেতে পারেন।
মধ্যস্থতার জন্য অ্যাপ নির্বাচন করুন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
AppLovin UI-তে, আপনার নিবন্ধিত অ্যাপগুলি পেতে মনিটাইজেশন বিভাগের অধীনে অ্যাপ্লিকেশনগুলি নির্বাচন করুন৷ উপলব্ধ অ্যাপ্লিকেশানগুলির তালিকা থেকে আপনি মধ্যস্থতার সাথে যে অ্যাপটি ব্যবহার করতে চান সেটি নির্বাচন করুন৷
একটি জোন তৈরি করুন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
AppLovin UI-তে, আপনার নিবন্ধিত জোন আইডিগুলি পেতে মনিটাইজেশন বিভাগের অধীনে অঞ্চলগুলি নির্বাচন করুন৷ আপনি যদি ইতিমধ্যেই আপনার অ্যাপের জন্য প্রয়োজনীয় জোন তৈরি করে থাকেন, তাহলে ধাপ 2 এ যান। একটি নতুন জোন আইডি তৈরি করতে, জোন তৈরি করুন ক্লিক করুন।
জোন আইডির নাম লিখুন, প্ল্যাটফর্ম হিসাবে অ্যান্ড্রয়েড নির্বাচন করুন এবং বিজ্ঞাপনের ধরন নির্বাচন করুন।
ফ্ল্যাট CPM বা AppLovin দ্বারা অপ্টিমাইজ করা নির্বাচন করে জোনের জন্য মূল্য নির্ধারণ করুন। ফ্ল্যাট CPM বিকল্পের জন্য প্রতি দেশের ভিত্তিতে CPMগুলি কনফিগার করা যেতে পারে। তারপর, Save এ ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
জোন তৈরি হয়ে গেলে, জোন আইডি জোন আইডি কলামের অধীনে পাওয়া যাবে।
অ্যান্ড্রয়েড
iOS
পরীক্ষা মোড চালু করুন
AppLovin পরীক্ষার বিজ্ঞাপনগুলি কীভাবে সক্ষম করতে হয় সে সম্পর্কে AppLovin-এর MAX টেস্ট মোড গাইডের নির্দেশাবলী অনুসরণ করুন৷
ধাপ 2: অ্যাপলোভিনের চাহিদা সেট আপ করুন Ad Manager UI
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, নির্দেশিকাতে ধাপ 2 দেখুনঅ্যান্ড্রয়েড
iOS
নির্দেশাবলীর জন্য, নির্দেশিকাতে ধাপ 2 দেখুনiOS
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় AppLovin Corp. যোগ করুন
ধাপ অনুসরণ করুনGDPR সেটিংসএবংমার্কিন রাষ্ট্র প্রবিধান সেটিংসযোগ করতেAppLovin Corp. জিডিপিআর এবং ইউএস স্টেট রেগুলেশনের বিজ্ঞাপন অংশীদারদের তালিকাতে Ad Manager UI
,ধাপ অনুসরণ করুনGDPR সেটিংসএবংমার্কিন রাষ্ট্র প্রবিধান সেটিংসযোগ করতেAppLovin Corp. জিডিপিআর এবং ইউএস স্টেট রেগুলেশনের বিজ্ঞাপন অংশীদারদের তালিকাতে Ad Manager UI
,ধাপ অনুসরণ করুনGDPR সেটিংসএবংমার্কিন রাষ্ট্র প্রবিধান সেটিংসযোগ করতেAppLovin Corp. জিডিপিআর এবং ইউএস স্টেট রেগুলেশনের বিজ্ঞাপন অংশীদারদের তালিকাতে Ad Manager UI
ধাপ 3: AppLovin SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
এর সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন৷AppLovin আপনার প্যাকেজের pubspec.yaml
ফাইলে SDK এবং অ্যাডাপ্টার:
dependencies:
gma_mediation_applovin: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণ ডাউনলোড করুনAppLovin , ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার 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: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি আপনার পরীক্ষার ডিভাইস নিবন্ধন করেছেনAd Manager এবং পরীক্ষা মোড সক্ষম করুন AppLovin UI
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি যে থেকে পরীক্ষার বিজ্ঞাপন পাচ্ছেন তা যাচাই করতেAppLovin, ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন AppLovin (Bidding) and AppLovin (Waterfall) বিজ্ঞাপনের উৎস(গুলি)
,পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি আপনার পরীক্ষার ডিভাইস নিবন্ধন করেছেনAd Manager এবং পরীক্ষা মোড সক্ষম করুন AppLovin UI
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি যে থেকে পরীক্ষার বিজ্ঞাপন পাচ্ছেন তা যাচাই করতেAppLovin, ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন AppLovin (Bidding) and AppLovin (Waterfall) বিজ্ঞাপনের উৎস(গুলি)
,পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি আপনার পরীক্ষার ডিভাইস নিবন্ধন করেছেনAd Manager এবং পরীক্ষা মোড সক্ষম করুন 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 | AppLovin সার্ভার প্যারামিটার কনফিগার করা হয়েছে Ad Manager UI অনুপস্থিত/অবৈধ। |
103 | AppLovin বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
104 | একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে৷ AppLovin শুধুমাত্র প্রতি অঞ্চলে একবারে 1টি বিজ্ঞাপন লোড করতে পারে৷ |
105 | AppLovin SDK কী পাওয়া যায়নি। |
107 | বিড টোকেন খালি। |
108 | অ্যাপলভিন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না। |
110 | AppLovin একটি সফল লোড কলব্যাক পাঠিয়েছে কিন্তু শূন্য বিজ্ঞাপন লোড করেছে৷ |
AppLovin Flutter Mediation Adapter Changelog
1.2.0
- AppLovin Android অ্যাডাপ্টার সংস্করণ 12.6.1.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- AppLovin iOS অ্যাডাপ্টারের সংস্করণ 12.6.1.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।
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 দিয়ে তৈরি এবং পরীক্ষিত।