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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েডনতুন অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

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

AppLovin-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খুলুন ১
ব্যানার ২
ইন্টারস্টিশিয়াল
পুরস্কৃত

১. ওয়াটারফল ইন্টিগ্রেশন বর্তমানে ক্লোজড বিটা পর্যায়ে রয়েছে।

Waterfall শুধুমাত্র 320x50 এবং 728x90 ব্যানার সাইজ সমর্থন করে। বিডিং-এ ব্যানার বিজ্ঞাপন সমর্থিত নয়।

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

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
  • মধ্যস্থতার ব্যবস্থা করুন ।

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

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

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

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

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

নিলাম

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

জলপ্রপাত

AppLovin UI-তে, আপনার নিবন্ধিত অ্যাপগুলো খুঁজে পেতে Monetization সেকশনের অধীনে Applications নির্বাচন করুন। উপলব্ধ অ্যাপের তালিকা থেকে আপনি মিডিয়েশনের সাথে যে অ্যাপটি ব্যবহার করতে চান, সেটি বেছে নিন।

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

নিলাম

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

জলপ্রপাত

AppLovin UI-তে, আপনার নিবন্ধিত জোন আইডিগুলো পেতে Monetization বিভাগের অধীনে Zones নির্বাচন করুন। যদি আপনি আপনার অ্যাপের জন্য প্রয়োজনীয় জোনগুলো আগে থেকেই তৈরি করে থাকেন, তাহলে সরাসরি ধাপ ২- এ চলে যান। একটি নতুন জোন আইডি তৈরি করতে, Create Zone-এ ক্লিক করুন।

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

ফ্ল্যাট সিপিএম অথবা অ্যাপলভিন দ্বারা অপ্টিমাইজ করা বিকল্পটি নির্বাচন করে জোনের জন্য মূল্য নির্ধারণ করুন। ফ্ল্যাট সিপিএম বিকল্পটির ক্ষেত্রে, দেশ-ভিত্তিক সিপিএম নির্ধারণ করা যেতে পারে। তারপর, সেভ-এ ক্লিক করুন।

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

আইওএস

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

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

আইওএস

আপনার 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 টেস্ট অ্যাড চালু করার জন্য এর MAX টেস্ট মোড গাইডের নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে AppLovin ডিমান্ড সেট আপ করুন।

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

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

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

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

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

ধাপ ৩: AppLovin SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

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

dependencies:
  gma_mediation_applovin: ^2.6.1

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

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

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

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

To comply with Google EU User Consent Policy , you must make certain disclosures to your users in the European Economic Area (EEA), the UK, and Switzerland, and obtain their consent for the use of cookies or other local storage where legally required, and for the collection, sharing, and use of personal data for ads personalization. This policy reflects the requirements of the EU ePrivacy Directive and the General Data Protection Regulation (GDPR). You are responsible for verifying consent is propagated to each ad source in your mediation chain. Google is unable to pass the user's consent choice to such networks automatically.

AppLovin শেয়ার্ড প্রেফারেন্স থেকে কনসেন্ট স্ট্রিং পড়তে এবং সেই অনুযায়ী কনসেন্ট স্ট্যাটাস সেট করতে সমর্থন করে।

If you are not using a CMP that writes the consent string into the shared preferences, you can use GmaMediationApplovin.setHasUserConsent() and GmaMediationApplovin.setIsAgeRestrictedUser() methods. The following sample code shows how to pass consent information to the AppLovin SDK. These options must be set before you initialize Google Mobile Ads Flutter Plugin to ensure they get forwarded properly to the AppLovin SDK.

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

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

শিশু ব্যবহারকারীদের ঘোষণা করুন

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

AppLovin-এর জন্য Google Mobile Ads Flutter মিডিয়েশন প্লাগইনের ভার্সন 2.0.0 বা তার উচ্চতর সংস্করণ, সেইসব অ্যাপের জন্য AppLovin মিডিয়েশন স্বয়ংক্রিয়ভাবে নিষ্ক্রিয় করে দেয়, যারা Google Mobile Ads Flutter Plugin সাথে নিম্নলিখিত সেটিংসগুলির মধ্যে যেকোনো একটি ঘোষণা করে:

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

US states privacy laws require giving users the right to opt out of the "sale" of their "personal information" (as the law defines those terms), with the opt-out offered through a prominent "Do Not Sell My Personal Information" link on the "selling" party's homepage. The US states privacy laws compliance guide offers the ability to enable restricted data processing for Google ad serving, but Google is unable to apply this setting to each ad network in your mediation chain. Therefore, you must identify each ad network in your mediation chain that may participate in the sale of personal information and follow guidance from each of those networks to ensure compliance.

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

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

GmaMediationApplovin.setDoNotSell(true);

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

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

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

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

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork আইডেন্টিফায়ারগুলো যোগ করতে AppLovin-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারে রেজিস্টার করুন এবং 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 ইভেন্ট ট্র্যাক করার ক্ষমতা পায়।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি AppLovin থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

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

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

আইওএস 

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন AppLovin অ্যাডাপ্টার যে কোড এবং তার সাথে বার্তাগুলো প্রদর্শন করে, তা নিচে দেওয়া হলো:

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

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

আইওএস

ত্রুটি কোড কারণ
-১০০৯ থেকে -১,২০৪ AppLovin SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে AppLovin-এর ডকুমেন্টেশন দেখুন।
১০১ অনুরোধ করা বিজ্ঞাপনের আকারটি AppLovin সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০২ অ্যাড ম্যানেজার UI-তে কনফিগার করা AppLovin সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০৩ AppLovin বিজ্ঞাপনটি দেখানো সম্ভব হয়নি।
১০৪ একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে। AppLovin প্রতি জোনে একবারে কেবল একটি বিজ্ঞাপনই লোড করতে পারে।
১০৫ AppLovin SDK কী খুঁজে পাওয়া যায়নি।
১০৭ বিড টোকেনটি খালি।
১০৮ AppLovin অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন ফরম্যাটটি সমর্থন করে না।
১১০ AppLovin একটি সফল লোড কলব্যাক পাঠিয়েছে কিন্তু কোনো বিজ্ঞাপন লোড করেনি।
১১১ AppLovin SDK-এর ইনস্ট্যান্স পুনরুদ্ধার করা সম্ভব হয়নি।
১১২ ব্যবহারকারী একজন শিশু।
১১৩ AppLovin SDK শেয়ার্ড ইনস্ট্যান্সটি ইনিশিয়ালাইজ করা হয়নি।
১১৪ AppLovin SDK বিড টোকেন ফেরত দিতে ব্যর্থ হচ্ছে।
১১৫ বিজ্ঞাপন ইউনিট আইডি অনুপস্থিত। বিজ্ঞাপনটি লোড করা যাচ্ছে না।
১১৬ বিজ্ঞাপনটি প্রস্তুত নয়। বিজ্ঞাপনটি প্রদর্শন করা যাচ্ছে না।

AppLovin ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ২.৬.১

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 8.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৬.০

সংস্করণ ২.৫.২

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 7.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৫.১

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৫.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৪.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৩.২

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৩.১

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.৩.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.২.১

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.২.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.১.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.৩.১ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ২.০.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.৩.১ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.২.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.১.০

  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.০.০

  • প্রাথমিক প্রকাশ।
  • গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।