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

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

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

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

myTarget-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
স্থানীয়

আবশ্যকতা

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

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

আপনার myTarget অ্যাকাউন্টে লগ ইন করুন । হেডারের APPS- এ ক্লিক করে অ্যাপস পৃষ্ঠায় যান। ADD APP-এ ক্লিক করে আপনার অ্যাপ যোগ করুন।

এরপর, আপনার অ্যাপের জন্য Google Play URL প্রদান করুন।

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

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

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

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

পুরস্কৃত

উপলব্ধ বিজ্ঞাপন ফর্ম্যাটগুলি থেকে REWARDED VIDEO নির্বাচন করুন, এবং তারপর ADD AD UNIT বোতামে ক্লিক করুন।

স্থানীয়

উপলব্ধ বিজ্ঞাপন ফর্ম্যাটগুলি থেকে NATIVE নির্বাচন করুন, এবং তারপর ADD AD UNIT এ ক্লিক করুন।

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

slot_id ছাড়াও, আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার myTarget Permanent Access Token এরও প্রয়োজন হবে। প্রোফাইল ট্যাবে যান এবং Access Tokens নির্বাচন করুন। আপনার myTarget Permanent Access Token দেখতে Create Token অথবা Show Token এ ক্লিক করুন।

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

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

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

পরীক্ষা মোড চালু করুন

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

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

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

আপনার বিজ্ঞাপন পরিচালক অ্যাকাউন্টে সাইন ইন করুন।

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

আপনার yield গ্রুপের জন্য একটি অনন্য নাম লিখুন, Status কে Active এ সেট করুন, আপনার Ad Format নির্বাচন করুন এবং Inventory type কে Mobile App এ সেট করুন। Targetting > Inventory বিভাগের অধীনে, Inventory and Mobile application এর অধীনে যে বিজ্ঞাপন ইউনিটে আপনি mediation যোগ করতে চান সেটি নির্বাচন করুন।

এরপর, অ্যাড ইয়েলড পার্টনার বোতামে ক্লিক করুন।

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

বিজ্ঞাপন নেটওয়ার্ক হিসেবে myTarget নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং Mediation সক্ষম করুন।

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

Yield পার্টনার নির্বাচন করা হয়ে গেলে, Integration type হিসেবে Mobile SDK Mediation , Platform হিসেবে Android এবং Status হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত Slot ID লিখুন। তারপর, একটি Default CPM মান লিখুন।

হয়ে গেলে পৃষ্ঠার নীচে সংরক্ষণ করুন -এ ক্লিক করুন।

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

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

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

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

কোটলিন 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

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.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

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 ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (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 নির্দেশিকা দেখুন।

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

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

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

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

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

নিশ্চিত করুন যে আপনি আপনার পরীক্ষামূলক ডিভাইসটি বিজ্ঞাপন পরিচালকের জন্য নিবন্ধিত করেছেন এবং myTarget UI তে পরীক্ষামূলক মোড সক্ষম করেছেন ।

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

আপনি myTarget থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, myTarget (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।

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

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

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

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

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

myTarget SDK সর্বদা mediaView প্রস্থ এবং উচ্চতার জন্য 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 থেকে লোড করা নেটিভ বিজ্ঞাপনটিতে কিছু প্রয়োজনীয় সম্পদ (যেমন ছবি বা আইকন) অনুপস্থিত।