মধ্যস্থতার সাথে AppLovin সংহত করুন

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট

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

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
বিন্যাস
ব্যানার 1
ইন্টারস্টিশিয়াল
পুরস্কৃত

জলপ্রপাত শুধুমাত্র 320x50 এবং 728x90 ব্যানার আকার সমর্থন করে। বিডিং ব্যানার বিজ্ঞাপন সমর্থন করে না.

প্রয়োজনীয়তা

  • সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
  • ফ্লটার 3.7.0 বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • Android API স্তর 23 বা উচ্চতর
  • iOS এ স্থাপন করতে
    • 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
  • Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
  • মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড

ধাপ 1: AppLovin UI এ কনফিগারেশন সেট আপ করুন

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

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

আপনি যদি শুধু বিডিং একীভূত করার পরিকল্পনা করেন, আপনি আপনার মধ্যস্থতা সেটিংস কনফিগার করতে এগিয়ে যেতে পারেন।

মধ্যস্থতার জন্য অ্যাপ নির্বাচন করুন

বিডিং

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

জলপ্রপাত

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

একটি জোন তৈরি করুন

বিডিং

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

জলপ্রপাত

AppLovin UI-তে, আপনার নিবন্ধিত জোন আইডিগুলি পেতে মনিটাইজেশন বিভাগের অধীনে অঞ্চলগুলি নির্বাচন করুন৷ আপনি যদি ইতিমধ্যেই আপনার অ্যাপের জন্য প্রয়োজনীয় জোন তৈরি করে থাকেন, তাহলে ধাপ 2 এ যান। একটি নতুন জোন আইডি তৈরি করতে, জোন তৈরি করুন ক্লিক করুন।

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

ফ্ল্যাট CPM বা AppLovin দ্বারা অপ্টিমাইজ করা নির্বাচন করে জোনের জন্য মূল্য নির্ধারণ করুন। ফ্ল্যাট CPM বিকল্পের জন্য প্রতি দেশের ভিত্তিতে CPMগুলি কনফিগার করা যেতে পারে। তারপর, Save এ ক্লিক করুন।

অ্যান্ড্রয়েড

iOS

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

অ্যান্ড্রয়েড

iOS

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

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

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

পরীক্ষা মোড চালু করুন

AppLovin পরীক্ষার বিজ্ঞাপনগুলি কীভাবে সক্ষম করতে হয় সে সম্পর্কে AppLovin-এর MAX টেস্ট মোড গাইডের নির্দেশাবলী অনুসরণ করুন৷

ধাপ 2: অ্যাড ম্যানেজার UI এ AppLovin চাহিদা সেট আপ করুন

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।

iOS

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

GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় AppLovin Corp. যোগ করুন

Ad Manager UI-এ ইউরোপীয় ও মার্কিন রাজ্যের বিধিবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় Applovin Corp. যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।

ধাপ 3: AppLovin SDK এবং অ্যাডাপ্টার আমদানি করুন

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

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

dependencies:
  gma_mediation_applovin: ^

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

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: আপনার বাস্তবায়ন পরীক্ষা করুন

পরীক্ষা বিজ্ঞাপন সক্ষম করুন

নিশ্চিত করুন যে আপনি অ্যাড ম্যানেজারের জন্য আপনার পরীক্ষা ডিভাইস নিবন্ধন করেছেন এবং Applovin UI-তে পরীক্ষা মোড সক্ষম করেছেন

পরীক্ষা বিজ্ঞাপন যাচাই করুন

আপনি Applovin থেকে পরীক্ষার বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, Applovin (Bidding) এবং 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 অ্যাপলভিন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না।
109 প্রসঙ্গ একটি কার্যকলাপ উদাহরণ নয়.
110 অবৈধ সার্ভার প্যারামিটার (যেমন SDK কী শূন্য)।
112 ব্যবহারকারী একজন শিশু।

iOS

ত্রুটি কোড কারণ
-1009 থেকে -1, 204 AppLovin SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য AppLovin এর ডকুমেন্টেশন দেখুন।
101 অনুরোধ করা বিজ্ঞাপনের আকার একটি AppLovin সমর্থিত ব্যানার আকারের সাথে মেলে না।
102 অ্যাড ম্যানেজার UI-তে কনফিগার করা AppLovin সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ।
103 AppLovin বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷
104 একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে৷ AppLovin শুধুমাত্র প্রতি অঞ্চলে একবারে 1টি বিজ্ঞাপন লোড করতে পারে৷
105 AppLovin SDK কী পাওয়া যায়নি।
107 বিড টোকেন খালি।
108 অ্যাপলভিন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না।
110 AppLovin একটি সফল লোড কলব্যাক পাঠিয়েছে কিন্তু শূন্য বিজ্ঞাপন লোড করেছে৷
111 AppLovin SDK-এর উদাহরণ পুনরুদ্ধার করতে অক্ষম৷
112 ব্যবহারকারী একজন শিশু।
113 AppLovin SDK ভাগ করা উদাহরণ আরম্ভ করা হয়নি।
114 AppLovin SDK বিড টোকেন ফেরত দিতে ব্যর্থ হয়েছে৷

AppLovin Flutter Mediation Adapter Changelog

সংস্করণ 2.3.1

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.3.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.2.1

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.2.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.1.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 2.0.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.2.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.1.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.0.0

  • প্রাথমিক মুক্তি।
  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি এবং পরীক্ষিত।