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

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

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

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

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

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

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

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

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

সর্বশেষ Google Mobile Ads SDK ।
মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

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

আপনার myTarget অ্যাকাউন্টে লগ ইন করুন । হেডারে থাকা ‘APPS’- এ ক্লিক করে অ্যাপস পেজে যান। ‘ADD APP’-এ ক্লিক করে আপনার অ্যাপটি যোগ করুন।

এরপর, আপনার অ্যাপের গুগল প্লে ইউআরএল (URL) প্রদান করুন।

অ্যাপ যোগ করার সময়, প্রক্রিয়াটি সম্পন্ন করার আগে myTarget-এ আপনাকে একটি অ্যাড ইউনিট তৈরি করতে হবে।

উপলব্ধ বিজ্ঞাপন ফরম্যাটগুলো থেকে ব্যানার (BANNER) নির্বাচন করুন, এবং তারপর অ্যাড অ্যাড ইউনিট (ADD AD UNIT) বোতামে ক্লিক করুন।

ইন্টারস্টিশিয়াল

উপলব্ধ বিজ্ঞাপন ফরম্যাটগুলো থেকে ইন্টারস্টিশিয়াল (INTERSTITIAL) নির্বাচন করুন, এবং তারপর অ্যাড অ্যাড ইউনিট (ADD AD UNIT) বোতামে ক্লিক করুন।

পুরস্কৃত

উপলব্ধ বিজ্ঞাপন ফরম্যাটগুলো থেকে রিওয়ার্ডেড ভিডিও নির্বাচন করুন, এবং তারপর অ্যাড অ্যাড ইউনিট বোতামে ক্লিক করুন।

স্থানীয়

উপলব্ধ বিজ্ঞাপন ফরম্যাটগুলো থেকে নেটিভ (NATIVE) নির্বাচন করুন, এবং তারপর অ্যাড ইউনিট (ADD AD UNIT )-এ ক্লিক করুন।

আপনার অ্যাড ইউনিটের বিবরণ পৃষ্ঠায়, আপনার স্লট আইডিটি লিখে রাখুন, যা অ্যাড ইউনিট সেটিংসের অধীনে slot_id হিসাবে পাওয়া যাবে। পরবর্তী বিভাগে আপনার AdMob অ্যাড ইউনিট সেট আপ করার জন্য এই স্লট আইডিটি ব্যবহার করা হবে।

slot_id- এর পাশাপাশি, আপনার AdMob অ্যাড ইউনিট আইডি সেট আপ করার জন্য আপনার myTarget পার্মানেন্ট অ্যাক্সেস টোকেন- এরও প্রয়োজন হবে। প্রোফাইল ট্যাবে যান এবং অ্যাক্সেস টোকেন নির্বাচন করুন। আপনার myTarget পার্মানেন্ট অ্যাক্সেস টোকেন দেখতে ক্রিয়েট টোকেন বা শো টোকেন-এ ক্লিক করুন।

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

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

myTarget-এর জন্য app-ads.txt প্রয়োগ করতে, কীভাবে একটি ফাইল তৈরি এবং প্রকাশ করতে হয় তা দেখুন।

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

myTarget UI-তে একটি টেস্ট ডিভাইস যোগ ও কনফিগার করতে myTarget-এর ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: AdMob UI-তে myTarget ডিমান্ড সেট আপ করুন।

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

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

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

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

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

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

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

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

myTarget-কে বিজ্ঞাপনের উৎস হিসেবে যোগ করুন

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

myTarget নির্বাচন করুন এবং Optimize সুইচটি সক্রিয় করুন। myTarget-এর জন্য বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত Permanent Access Token-টি প্রবেশ করান। তারপর myTarget-এর জন্য একটি eCPM মান প্রবেশ করান এবং Continue-তে ক্লিক করুন।

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

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

দ্রষ্টব্য : একটি মিডিয়েশন নেটওয়ার্কের জন্য eCPM সঠিকভাবে গণনা করার মতো পর্যাপ্ত ডেটা সংগ্রহ করতে অ্যাড সোর্স অপটিমাইজেশনের কয়েক দিন সময় লাগে। এই সময়ের মধ্যে, অ্যাড সোর্স অপটিমাইজেশনের স্ট্যাটাস PENDING থাকে, তাই আপনাকে নেটওয়ার্কটির জন্য ম্যানুয়ালি একটি eCPM ভ্যালু সেট করতে হবে। একবার eCPM গণনা করা সম্ভব হলে, অ্যাড সোর্সটি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে eCPM আপডেট করা শুরু করে।

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

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

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

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

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

কোটলিন

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.1.0")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

গ্রুভি

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.1.0'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

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

myTarget SDK অন্তর্ভুক্ত করতে, myTarget অ্যান্ড্রয়েড SDK ডকুমেন্টেশন দেখুন।
গুগলের মেভেন রিপোজিটরিতে myTarget অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, myTarget অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রজেক্টে যোগ করুন।

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

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

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

SDK সংস্করণ 5.1.0-এ, myTarget গোপনীয়তার প্রয়োজনীয়তা পূরণের জন্য একটি ব্যবহারকারীর সম্মতি API যুক্ত করেছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে এই সম্মতির তথ্য myTarget SDK-তে পাঠাতে হয়। আপনি যদি এই পদ্ধতিটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে তা করার পরামর্শ দেওয়া হচ্ছে।

জাভা

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

কোটলিন

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

এছাড়াও, যদি ব্যবহারকারী কোনো বয়স-সীমাবদ্ধ বিভাগের অন্তর্ভুক্ত বলে জানা যায়, তাহলে আপনি এই সম্মতির তথ্য myTarget SDK-তে পাঠানোর জন্য নিম্নলিখিত কোডটি ব্যবহার করতে পারেন।

জাভা

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

কোটলিন

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

SDK সংস্করণ 5.9.0-এ, myTarget গোপনীয়তার প্রয়োজনীয়তা পূরণের জন্য একটি ব্যবহারকারীর সম্মতি API যুক্ত করেছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে এই সম্মতির তথ্য myTarget SDK-তে পাঠাতে হয়। আপনি যদি এই পদ্ধতিটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে তা করার পরামর্শ দেওয়া হচ্ছে।

জাভা

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

কোটলিন

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

আরও তথ্যের জন্য এবং মেথডটিতে যে মানগুলো প্রদান করা যেতে পারে সে সম্পর্কে জানতে myTarget সাপোর্টের সাথে যোগাযোগ করুন।

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

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

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

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

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

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

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

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

নেটিভ বিজ্ঞাপন ব্যবহার করে

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

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

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

myTarget SDK সবসময় mediaView width এবং height-এর জন্য 0 রিটার্ন করে, তাই myTarget অ্যাডাপ্টারও getAspectRatio() -এর জন্য সবসময় 0 রিটার্ন করে। myTarget SDK ভবিষ্যতের কোনো রিলিজে এই সমস্যাটি সমাধান করবে।

ইম্প্রেশন এবং ক্লিক ট্র্যাকিং

Google Mobile Ads SDK ইম্প্রেশন এবং ক্লিক ট্র্যাকিংয়ের জন্য মাইটার্গেট এসডিকে-এর কলব্যাক ব্যবহার করে, তাই উভয় উৎস থেকে প্রাপ্ত রিপোর্টগুলো প্রায় একই রকম হওয়ার কথা।

ত্রুটি কোড

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

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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

ত্রুটি কোড	কারণ
১০০	myTarget SDK একটি ত্রুটি দেখিয়েছে।
১০১	AdMob UI-তে কনফিগার করা myTarget সার্ভার প্যারামিটারগুলো অনুপস্থিত/অবৈধ।
১০২	অনুরোধ করা বিজ্ঞাপনের আকারটি myTarget সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩	বিজ্ঞাপনের অনুরোধটি একটি ইউনিফাইড নেটিভ বিজ্ঞাপনের অনুরোধ নয়।
১০৪	myTarget থেকে লোড হওয়া নেটিভ বিজ্ঞাপনটি অনুরোধ করা নেটিভ বিজ্ঞাপন থেকে ভিন্ন।
১০৫	myTarget থেকে লোড হওয়া নেটিভ বিজ্ঞাপনটিতে কিছু প্রয়োজনীয় অ্যাসেট (যেমন ছবি বা আইকন) অনুপস্থিত।

myTarget অ্যান্ড্রয়েড মিডিয়েশন অ্যাডাপ্টার পরিবর্তন-লগ