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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

পুরস্কৃত

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

স্থানীয়

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

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

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

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

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

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

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

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

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

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

ডেলিভারি > ইল্ড গ্রুপস- এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন।

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

এরপর, 'Add yield partner' বাটনটিতে ক্লিক করুন।

আপনার myTarget-এর জন্য যদি আগে থেকেই কোনো Yield partner থাকে, তাহলে আপনি তাকে নির্বাচন করতে পারেন। অন্যথায়, ‘Create a new yield partner’ নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে myTarget নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন সক্রিয় করুন।

স্বয়ংক্রিয় ডেটা সংগ্রহ চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত স্থায়ী অ্যাক্সেস টোকেনটি প্রবেশ করান।

একবার Yield পার্টনার নির্বাচিত হয়ে গেলে, ইন্টিগ্রেশন টাইপ হিসেবে Mobile SDK Mediation , প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত স্লট আইডিটি প্রবেশ করান। তারপর, একটি ডিফল্ট CPM মান প্রবেশ করান।

কাজ শেষ হলে পৃষ্ঠার নীচে থাকা সেভ বাটনে ক্লিক করুন।

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

অ্যাড ম্যানেজার 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-তে গোপনীয়তা সেটিংস প্রয়োগ করুন।

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 ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

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

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

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

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

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

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

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

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

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 অ্যাডাপ্টার দ্বারা প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:

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