গুগল অ্যাডভারটাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি সার্ভারের #gma-next-gen-sdk ডিসকর্ড চ্যানেলে GMA নেক্সট-জেন SDK সম্পর্কে আপনার মতামত শেয়ার করুন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে GMA Next-Gen SDK ব্যবহার করে AdMob মিডিয়েশনের মাধ্যমে BidMachine থেকে বিজ্ঞাপন লোড ও প্রদর্শন করা যায়, যেখানে বিডিং ইন্টিগ্রেশনও অন্তর্ভুক্ত রয়েছে। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে BidMachine যোগ করতে হয় এবং কিভাবে BidMachine SDK ও অ্যাডাপ্টারকে একটি অ্যান্ড্রয়েড অ্যাপে ইন্টিগ্রেট করতে হয়।

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

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

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

^১. বিডিং ইন্টিগ্রেশন বর্তমানে ক্লোজড বিটা পর্যায়ে রয়েছে, অ্যাক্সেসের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

^২ ওয়াটারফল ইন্টিগ্রেশনটি ক্লোজড বিটা পর্যায়ে রয়েছে, অ্যাক্সেসের অনুরোধ জানাতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

^৩ নেটিভ বিজ্ঞাপন ফরম্যাটটি আলফা পর্যায়ে রয়েছে। অন্য সব সমর্থিত বিজ্ঞাপন ফরম্যাট বিটা পর্যায়ে আছে। অ্যাক্সেসের অনুরোধ জানাতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

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

অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

[বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, BidMachine অ্যাডাপ্টার 3.4.0.1 বা উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।

সর্বশেষ GMA Next-Gen SDK
মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

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

আপনার BidMachine অ্যাকাউন্ট ড্যাশবোর্ডে লগ ইন করুন ।

নতুন প্লেসমেন্ট তৈরি করুন

সোর্স ট্যাবে যান এবং সোর্সেস টেবিলের নিচে থাকা এডিট বাটনটি নির্বাচন করুন।

উৎস ড্যাশবোর্ড

আপনাকে আপনার সমস্ত প্লেসমেন্টের একটি তালিকা দেখানো হবে। নতুন প্লেসমেন্ট তৈরি করতে, ডায়ালগ বক্সে থাকা 'অ্যাড প্লেসমেন্ট' বোতামে ক্লিক করুন।

উৎস সম্পাদনা ডায়ালগ

ফর্মটি পূরণ করুন এবং সেভ-এ ক্লিক করুন।

প্লেসমেন্ট তৈরি করুন

অবশেষে, প্লেসমেন্ট আইডি-টি লিখে রাখুন।

প্লেসমেন্টের বিবরণ

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

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

BidMachine-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে app-ads.txt ট্যাবে যান। তারপর, তালিকাটি কপি করে আপনার ওয়েবসাইটের app-ads.txt ফাইলে যুক্ত করুন।

ধাপ ২: AdMob UI-তে BidMachine-এর চাহিদা সেট আপ করুন।

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে বিডমেশিন যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি 'অ্যাড বিডমেশিন অ্যাজ অ্যান অ্যাড সোর্স' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে বিডমেশিন যোগ করুন

নিলাম

বিডিং কার্ডের অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স নির্বাচন করুন। তারপর বিডমেশিন নির্বাচন করুন।

BidMachine-এর সাথে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন , তা জানতে ক্লিক করুন।

স্বীকৃতি ও সম্মতিতে ক্লিক করুন, তারপর চালিয়ে যান-এ ক্লিক করুন।

আপনার যদি BidMachine-এর জন্য আগে থেকেই কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।

এরপর, পূর্ববর্তী অংশে প্রাপ্ত সোর্স আইডি এবং প্লেসমেন্ট আইডি প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

জলপ্রপাত

Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।

বিডমেশিন নির্বাচন করুন। তারপর বিডমেশিনের জন্য একটি eCPM মান প্রবেশ করান এবং ' চালিয়ে যান' বোতামে ক্লিক করুন।

এরপর, পূর্ববর্তী বিভাগে প্রাপ্ত প্লেসমেন্ট আইডিটি প্রবেশ করান। তারপর 'Done' বোতামে ক্লিক করুন।

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

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

ধাপ ৩: বিডমেশিন এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

আপনার অ্যাপ-লেভেলের গ্রেডল ফাইলে নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন:

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:bidmachine:3.6.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

গ্রুভি

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:bidmachine:3.6.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

BidMachine স্বয়ংক্রিয়ভাবে UMP SDK সহ সম্মতি ব্যবস্থাপনা প্ল্যাটফর্মগুলো দ্বারা নির্ধারিত GDPR সম্মতি পড়ে নেয়। আরও তথ্যের জন্য, GDPR দেখুন।

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

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

BidMachine স্বয়ংক্রিয়ভাবে UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মগুলো দ্বারা নির্ধারিত GPP কনসেন্ট পড়ে নেয়। আরও তথ্যের জন্য, GPP দেখুন।

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

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

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

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

আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য রেজিস্টার করে নিন ।

BidMachine-এর টেস্ট মোড চালু করার জন্য, এর অ্যান্ড্রয়েড ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

ঐচ্ছিক পদক্ষেপ

স্থানীয় বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

BidMachine অ্যাডাপ্টার তার নেটিভ অ্যাডগুলোকে NativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি একটি NativeAd এর জন্য নিম্নলিখিত ফিল্ডগুলো পূরণ করে।

মাঠ	বিডমেশিন অ্যাডাপ্টার দ্বারা সম্পদ সর্বদা অন্তর্ভুক্ত থাকে
শিরোনাম
ছবি
শরীর
আইকন
পদক্ষেপ গ্রহণের আহ্বান
তারকা রেটিং
দোকান
মূল্য
বিজ্ঞাপনদাতা

ত্রুটি কোড

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

io.bidmachine
com.google.ads.mediation.bidmachine

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

ত্রুটি কোড	ডোমেইন	কারণ
১০০	com.google.ads.mediation.bidmachine	প্রাপ্ত প্লেসমেন্ট আইডিটি অবৈধ বা খালি।
১০১	com.google.ads.mediation.bidmachine	সংকেত সংগ্রহের সময় ত্রুটি: কোনো সংকেত ডেটা কনফিগারেশন পাওয়া যায়নি।
১০২	com.google.ads.mediation.bidmachine	সিগন্যাল সংগ্রহের সময় অবৈধ বিজ্ঞাপন ফরম্যাট পাওয়া গেছে।
১০৩	com.google.ads.mediation.bidmachine	অনুরোধকৃত বিজ্ঞাপনের আকার `bidmachine.BannerSize` এর সাথে মেলানো যায়নি।
১০৪	com.google.ads.mediation.bidmachine	লোড করা বিডমেশিন বিজ্ঞাপনের অনুরোধটির মেয়াদ শেষ হয়ে গেছে।
১০৫	com.google.ads.mediation.bidmachine	পূর্ণ পর্দার বিজ্ঞাপন দেখানো সম্ভব হয়নি।
১০৬	com.google.ads.mediation.bidmachine	BidMachine SDK, `null` বিজ্ঞাপন ডেটা সহ একটি `onAdLoaded()` কলব্যাক ফেরত দিয়েছে।