মেডিয়েশনের সাথে AppLovin ইন্টিগ্রেট করা

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

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

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

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

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

১ ওয়াটারফল ইন্টিগ্রেশন ক্লোজড বিটা ভার্সনে আছে।

ওয়াটারফলে শুধুমাত্র ৩২০x৫০ এবং ৭২৮x৯০ ব্যানার সাইজ কাজ করে। বিডিংয়ে ব্যানার বিজ্ঞাপন কাজ করে না।

পূর্বশর্ত

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

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

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

আপনার AppLovin অ্যাকাউন্টে সাইন-আপ করুন অথবা লগ-ইন করুন ।

আপনার AdMob বিজ্ঞাপন ইউনিট সেট-আপ করতে, আপনার AppLovin SDK কী ও রিপোর্ট কী প্রয়োজন হবে। সেগুলি খুঁজে পেতে, AppLovin UI > অ্যাকাউন্ট > কী বিকল্পে গিয়ে দুটি ভ্যালুই দেখুন।

আপনি যদি শুধু বিডিং ইন্টিগ্রেট করার পরিকল্পনা করে থাকেন, তাহলে আপনার মধ্যস্থতা সেটিংস কনফিগার করুন।

মধ্যস্থতার জন্য অ্যাপ বেছে নিন

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন হয় না।

জলপ্রপাত

আপনার রেজিস্টার করা অ্যাপে যেতে, AppLovin UI-তে, মনিটাইজেশন বিভাগের অধীনে অ্যাপ্লিকেশন বেছে নিন। উপলভ্য অ্যাপের তালিকা থেকে আপনি যে অ্যাপটি মধ্যস্থতার সাথে ব্যবহার করতে চান সেটি বেছে নিন।

জোন তৈরি করা

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন হয় না।

জলপ্রপাত

আপনার রেজিস্টার করা জোন আইডি পেতে, AppLovin UI-তে, মনিটাইজেশন বিভাগের অধীনে জোন বিকল্প বেছে নিন। আপনার অ্যাপের জন্য প্রয়োজনীয় জোন আগে থেকেই তৈরি করে থাকলে, ধাপ ২-এ যান। নতুন জোন আইডি তৈরি করতে, জোন তৈরি করুন বিকল্পে ক্লিক করুন।

জোন আইডির নাম লিখুন, প্ল্যাটফর্ম হিসেবে Android বেছে নিন এবং বিজ্ঞাপনের ধরন বেছে নিন।

ফ্ল্যাট CPM অথবা AppLovin-এর মাধ্যমে অপ্টিমাইজ করা বিকল্প বেছে নিয়ে জোনের জন্য মূল্য কনফিগার করুন। ফ্ল্যাট CPM বিকল্পের জন্য প্রতিটি দেশ অনুযায়ী CPM কনফিগার করা যেতে পারে। তারপর, সেভ করুন বিকল্পে ক্লিক করুন।

Android

iOS

জোন তৈরি হয়ে গেলে, জোন আইডি কলামের মধ্যে জোন আইডি দেখতে পাবেন।

Android

iOS

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

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

app-ads.txt AppLovin-এর জন্য ads.txt প্রয়োগ করতে, আপনার app-ads.txt ফাইলে AppLovin যোগ করুন।

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

AppLovin টেস্ট বিজ্ঞাপন কীভাবে চালু করতে হয় তা AppLovin-এর MAX টেস্ট মোড গাইড থেকে জানুন।

ধাপ ২: AdMob UI-তে AppLovin ডিমান্ড সেট-আপ করা

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_applovin: ^2.6.4

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

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

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

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

AppLovin Flutter অ্যাডাপ্টারের ভার্সন ১.০.০ ও তার পরবর্তী যেকোনও ভার্সন থেকে UMP SDK ও Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন-এর সাথে ইন্টিগ্রেট করা সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে GDPR সম্মতি সিগন্যাল পাস করা যায়

আরও তথ্যের জন্য AppLovin-এর গোপনীয়তা সেটিং দেখুন।

অপ্রাপ্তবয়স্ক ব্যবহারকারী সম্পর্কে ঘোষণা করা

AppLovin কোনও বাচ্চার সাথে কানেক্ট করে AppLovin SDK-এর ইনস্টলেশন সমর্থন করে না। আরও তথ্যের জন্য, দেখুন AppLovin-এর ডকুমেন্টেশন Android বা iOS-এর জন্য "শিশুদের ডেটা বা শিশুদের জন্য পরিষেবা ব্যবহার করা বা অ্যাপ যা বিশেষভাবে শিশুদের টার্গেট করে" সংক্রান্ত নিষেধাজ্ঞা।

Google Mobile Ads Flutter মধ্যস্থতা প্লাগ-ইন AppLovin ভার্সন 9.1.0 বা তার পরের যেকোনও ভার্সনের জন্য নিম্নলিখিত সেটিংসের যেকোনও একটি ব্যবহার করে কোনও অ্যাপে শিশু ব্যবহারকারী আছে বলে ঘোষণা করা হলে, সেটি অটোমেটিক AppLovin এর জন্য মধ্যস্থতা বন্ধ করে দেয়:

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

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

Google Mobile Ads মধ্যস্থতা প্লাগ-ইনে AppLovin এর জন্য GmaMediationApplovin.setDoNotSell() মেথড অন্তর্ভুক্ত থাকে। নিচে দেওয়া নমুনা কোড থেকে কীভাবে AppLovin SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করতে হয় তা জানতে পারবেন। Google Mobile Ads SDK ইনিশিয়ালাইজ করার আগে এই বিকল্পগুলি সেট করতে হবে, যাতে সেগুলি AppLovin SDK-তে সঠিকভাবে ফরওয়ার্ড করা যায়।

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

আরও তথ্যের জন্য AppLovin-এর গোপনীয়তা সংক্রান্ত ডকুমেন্টেশন দেখুন।

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

Android

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

iOS

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

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

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

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

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

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

আপনি AppLovin-এর থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন। এর জন্য AppLovin (বিডিং) ও AppLovin (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করুন।

ঐচ্ছিক ধাপ

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার সেট করতে, 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-কে ইভেন্ট ট্র্যাক করার ক্ষমতা প্রদান করা হয়।

সমস্যার কোড

অ্যাডাপ্টার AppLovin-এর থেকে বিজ্ঞাপন না পেলে, প্রকাশকরা নিম্নলিখিত ক্লাস থেকে ResponseInfo ব্যবহার করে বিজ্ঞাপন রেসপন্স থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

বিজ্ঞাপন লোড করা না গেলে AppLovin অ্যাডাপ্টার এইসব কোড ও মেসেজ দেখায়:

Android

সমস্যার কোড কারণ
-১০০৯ থেকে -১, ২০৪ AppLovin SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য AppLovin-এর ডকুমেন্টেশন দেখুন।
১০১ অনুরোধ করা বিজ্ঞাপনের সাইজ AppLovin-এ কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
103 প্রসঙ্গের মান শূন্য।
104 AppLovin বিড টোকেন খালি।
১০৫ একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে। AppLovin প্রতিটি জোনে একবারে শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে।
106 বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
108 অনুরোধ করা বিজ্ঞাপন ফর্ম্যাট AppLovin অ্যাডাপ্টরে কাজ করে না।
১০৯ কনটেক্সট হল অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
110 SDK কী নেই।
112 ব্যবহারকারী অপ্রাপ্তবয়স্ক।
১১৩ বিজ্ঞাপন ইউনিট আইডি নেই।

iOS

সমস্যার কোড কারণ
-১০০৯ থেকে -১, ২০৪ AppLovin SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য AppLovin-এর ডকুমেন্টেশন দেখুন।
১০১ অনুরোধ করা বিজ্ঞাপনের সাইজ AppLovin-এ কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
102 AdMob UI-তে কনফিগার করা AppLovin সার্ভার প্যারামিটার নেই/ভুল।
103 AppLovin বিজ্ঞাপন দেখানো যায়নি।
104 একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে। AppLovin প্রতিটি জোনে একবারে শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে।
১০৫ AppLovin SDK কী খুঁজে পাওয়া যায়নি।
107 বিড টোকেন খালি আছে।
108 অনুরোধ করা বিজ্ঞাপন ফর্ম্যাট AppLovin অ্যাডাপ্টরে কাজ করে না।
110 AppLovin সফল লোড কলব্যাক পাঠিয়েছে কিন্তু কোনও বিজ্ঞাপন লোড করেনি।
111 AppLovin SDK-এর ইনস্ট্যান্স ফিরিয়ে আনা যায়নি।
112 ব্যবহারকারী অপ্রাপ্তবয়স্ক।
১১৩ AppLovin SDK শেয়ার করা ইনস্ট্যান্স চালু করা হয়নি।
114 AppLovin SDK বিড টোকেন রিটার্ন করতে পারেনি।
115 বিজ্ঞাপন ইউনিট আইডি নেই। বিজ্ঞাপন লোড করা যাচ্ছে না।
১১৬ বিজ্ঞাপন রেডি নেই। বিজ্ঞাপনটি দেখানো যাচ্ছে না।

AppLovin Flutter মেডিয়েশন অ্যাডাপ্টরের পরিবর্তনের লগ

ভার্সন 2.6.5 (কাজ চলছে)

ভার্সন 2.6.4

ভার্সন 2.6.3

ভার্সন 2.6.2

ভার্সন 2.6.1

  • Google Mobile Ads Flutter Plugin ভার্সন 8.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.6.0

ভার্সন 2.5.2

  • Google Mobile Ads Flutter Plugin ভার্সন 7.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.5.1

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.5.0

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.4.0

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.3.2

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.3.1

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.3.0

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন ২.২.১

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.2.0

  • Google Mobile Ads Flutter Plugin ভার্সন 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.1.0

  • Google Mobile Ads Flutter Plugin ভার্সন 5.3.1 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 2.0.0

  • Google Mobile Ads Flutter Plugin ভার্সন 5.3.1 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 1.2.0

  • Google Mobile Ads Flutter Plugin ভার্সন 5.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 1.1.0

  • Google Mobile Ads Flutter Plugin ভার্সন 5.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

ভার্সন 1.0.0

  • প্রাথমিক রিলিজ।
  • Google Mobile Ads Flutter Plugin ভার্সন 5.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।