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

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

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

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

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

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

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

• সর্বশেষ 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- এ গিয়ে উভয় ভ্যালু দেখুন।

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

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

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

আপনার 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 ডিমান্ড সেট আপ করুন।

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

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

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

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

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

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

dependencies:
  gma_mediation_applovin: ^2.5.2

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

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

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

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

ইইউ সম্মতি এবং জিডিপিআর

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

আপনি যদি এমন কোনো CMP ব্যবহার না করেন যা শেয়ার্ড প্রেফারেন্সে কনসেন্ট স্ট্রিং লিখে রাখে, তাহলে আপনি GmaMediationApplovin.setHasUserConsent() এবং GmaMediationApplovin.setIsAgeRestrictedUser() মেথডগুলো ব্যবহার করতে পারেন। নিচের নমুনা কোডটি দেখায় কিভাবে AppLovin SDK-তে কনসেন্ট তথ্য পাঠাতে হয়। Google Mobile Ads Flutter Plugin ইনিশিয়ালাইজ করার আগে এই অপশনগুলো অবশ্যই সেট করতে হবে, যাতে এগুলো 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 সাথে নিম্নলিখিত সেটিংসগুলির মধ্যে যেকোনো একটি ঘোষণা করে:

• শিশু-নির্দেশিত পরিবেশ
• সম্মতির বয়সের কম বয়সী ব্যবহারকারী

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

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

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 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 ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

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

• ফ্লাটারের সর্বনিম্ন সংস্করণ ৩.৩৫.১-এ আপডেট করা হয়েছে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 7.0.0 সমর্থন করার জন্য আপডেট করা হয়েছে।
• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.5.1.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.5.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.5.1.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.5.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.5.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.5.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.4.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.4.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.3.1.1 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.3.1.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.3.1.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.3.1.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.3.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.3.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.2.0.1 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.2.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.2.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.2.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.1.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.1.0.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 13.0.1.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 13.0.1.0 সমর্থন করে।

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

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

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 12.6.1.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 12.6.1.0 সমর্থন করে।

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

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

• GmaMediationApplovin-এর API এখন আর স্থির নয়।
• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 12.4.3.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 12.4.2.0 সমর্থন করে।

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

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

• প্রাথমিক প্রকাশ।

• AppLovin অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 12.3.0.0 সমর্থন করে।
• AppLovin iOS অ্যাডাপ্টার সংস্করণ 12.2.1.0 সমর্থন করে।

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