মধ্যস্থতার সাথে লিফটঅফ নগদীকরণকে একীভূত করুন

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

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

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

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

• সর্বশেষ Google Mobile Ads Flutter Plugin
• ফ্লাটার ৩.৭.০ বা উচ্চতর
• [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, AppLovin-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইন 5.1.0 বা তার উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।
• অ্যান্ড্রয়েডে স্থাপন করতে
  • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
• iOS-এ স্থাপন করতে
  • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
• Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
• মধ্যস্থতার ব্যবস্থা করুন ।

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

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

Add Application বোতামে ক্লিক করে আপনার অ্যাপটি Liftoff Monetize ড্যাশবোর্ডে যোগ করুন।

ফর্মটি পূরণ করুন এবং সমস্ত প্রয়োজনীয় তথ্য দিন।

আপনার অ্যাপটি তৈরি হয়ে গেলে, Liftoff Monetize Applications ড্যাশবোর্ড থেকে আপনার অ্যাপটি নির্বাচন করুন।

অ্যাপ আইডিটি লিখে রাখুন।

নতুন প্লেসমেন্ট যোগ করুন

মেডিয়েশনের সাথে ব্যবহার করার জন্য একটি নতুন প্লেসমেন্ট তৈরি করতে, Liftoff Monetize Placements ড্যাশবোর্ডে যান, Add Placement বোতামে ক্লিক করুন এবং ড্রপ-ডাউন তালিকা থেকে আপনার অ্যাপটি নির্বাচন করুন।

নতুন প্লেসমেন্ট যোগ করার বিবরণ নিচে দেওয়া হলো:

রেফারেন্স আইডিটি লিখে নিন এবং 'Sounds Good'-এ ক্লিক করুন।

আপনার রিপোর্টিং এপিআই কী খুঁজুন

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

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

Liftoff Monetize-এর জন্য app-ads.txt প্রয়োগ করতে, Liftoff Monetize-এর app-ads.txt এন্ট্রিগুলি ডাউনলোড করে আপনার বিদ্যমান app-ads.txt ফাইলে যুক্ত করুন। আরও তথ্যের জন্য, app-ads.txt দেখুন।

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

টেস্ট বিজ্ঞাপন চালু করতে, আপনার Liftoff Monetize ড্যাশবোর্ডে যান এবং Applications- এ নেভিগেট করুন।

আপনার অ্যাপের প্লেসমেন্ট রেফারেন্স আইডি (Placement Reference ID) সেকশন থেকে সেই অ্যাপটি নির্বাচন করুন, যেটির জন্য আপনি টেস্ট অ্যাড চালু করতে চান। স্ট্যাটাস (Status ) সেকশনের অধীনে টেস্ট মোড (Test Mode) থেকে শুধুমাত্র টেস্ট অ্যাড দেখানোর (Show test ads ) অপশনটি নির্বাচন করে টেস্ট অ্যাড চালু করা যায়।

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

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

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

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

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

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

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.4.3

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

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

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

Liftoff Monetize ফ্লাটার প্লাগইন সংস্করণ 1.1.0 থেকে শুরু করে, Liftoff Monetize স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, Android এবং iOS- এর জন্য GDPR Recommended Implementation Instructions দেখুন।

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

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

Liftoff Monetize-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটিতে GmaMediationLiftoffmonetize.setCCPAStatus() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Vungle SDK-তে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই মেথডটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads Flutter Plugin মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি কল করার পরামর্শ দেওয়া হয়।

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

আরও বিস্তারিত তথ্যের জন্য এবং মেথডটিতে যে মানগুলো প্রদান করা যেতে পারে, সে সম্পর্কে জানতে অ্যান্ড্রয়েড এবং আইওএস-এর জন্য CCPA-এর প্রস্তাবিত বাস্তবায়ন নির্দেশাবলী দেখুন।

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

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

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

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করুন এবং Liftoff Monetize UI-তে টেস্ট মোড চালু করুন ।

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

আপনি Liftoff Monetize থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে Liftoff Monetize (Bidding) এবং Liftoff Monetize (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

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

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

Vungle SDK থেকে আসা ত্রুটিগুলির জন্য, "Error Codes: Vungle SDK for iOS and Android" দেখুন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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