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

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

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

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

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

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

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

• সর্বশেষ GMA Next-Gen SDK ।

• মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

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

আপনার অ্যাড ইউনিটের বিবরণ পৃষ্ঠায়, আপনার স্লট আইডিটি লিখে রাখুন, যা অ্যাড ইউনিট সেটিংসের অধীনে 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-কে বিজ্ঞাপনের উৎস হিসেবে যোগ করুন

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.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:mytarget:5.45.3.0'
}

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

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

• 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-তে পাঠাতে হয়। আপনি যদি এই পদ্ধতিটি কল করার সিদ্ধান্ত নেন, GMA Next-Gen 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-তে পাঠাতে হয়। আপনি যদি এই পদ্ধতিটি কল করার সিদ্ধান্ত নেন, GMA Next-Gen 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 SDK সবসময় mediaView width এবং height-এর জন্য 0 রিটার্ন করে, তাই myTarget অ্যাডাপ্টারও getAspectRatio() -এর জন্য সবসময় 0 রিটার্ন করে। myTarget SDK ভবিষ্যতের কোনো রিলিজে এই সমস্যাটি সমাধান করবে।

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

GMA Next-Gen SDK ইম্প্রেশন এবং ক্লিক ট্র্যাকিংয়ের জন্য myTarget SDK-এর কলব্যাক ব্যবহার করে, তাই উভয় উৎস থেকে প্রাপ্ত রিপোর্টগুলো প্রায় কোনো অমিল ছাড়াই মিলে যাওয়ার কথা।

ত্রুটি কোড

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

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

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