এই নির্দেশিকা ব্যাখ্যা করে কিভাবে একটি বিজ্ঞাপনের অনুরোধে টার্গেটিং তথ্য প্রদান করতে হয়। কাজের উদাহরণের জন্য, Android API ডেমো অ্যাপ ডাউনলোড করুন।
পূর্বশর্ত
- শুরু করুন গাইডটি সম্পূর্ণ করুন।
অনুরোধ কনফিগারেশন
RequestConfiguration
হল একটি বস্তু যা একটি MobileAds
স্ট্যাটিক পদ্ধতির মাধ্যমে বিশ্বব্যাপী প্রয়োগ করার লক্ষ্যে তথ্য সংগ্রহ করে।
অনুরোধ কনফিগারেশন আপডেট করতে, বিদ্যমান কনফিগারেশন থেকে একজন বিল্ডার প্রাপ্ত করুন, যেকোনো পছন্দসই আপডেট সম্পাদন করুন এবং এটি নিম্নরূপ সেট করুন:
জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
কোটলিন
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
শিশু-নির্দেশিত সেটিং
চিলড্রেনস অনলাইন প্রাইভেসি প্রোটেকশন অ্যাক্ট (COPPA) এর উদ্দেশ্যে, "শিশু-নির্দেশিত চিকিত্সার জন্য ট্যাগ" নামে একটি সেটিং রয়েছে৷ এই ট্যাগ সেট করে, আপনি প্রত্যয়িত করেন যে এই বিজ্ঞপ্তিটি সঠিক এবং আপনি অ্যাপের মালিকের পক্ষে কাজ করার জন্য অনুমোদিত৷ আপনি বুঝতে পেরেছেন যে এই সেটিংটির অপব্যবহারের ফলে আপনার Google অ্যাকাউন্টটি বন্ধ হয়ে যেতে পারে৷
একজন অ্যাপ ডেভেলপার হিসেবে, আপনি নির্দেশ করতে পারেন যে আপনি বিজ্ঞাপনের অনুরোধ করার সময় Google আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করুক। আপনি যদি ইঙ্গিত করেন যে আপনি Google আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করুক, আমরা সেই বিজ্ঞাপন অনুরোধে IBA এবং পুনরায় বিপণন বিজ্ঞাপনগুলি অক্ষম করার জন্য পদক্ষেপ নিই।
সেটিংটি RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
এর মাধ্যমে Google Play পরিষেবা SDK-এর সমস্ত সংস্করণের সাথে ব্যবহার করা যেতে পারে :
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
এর সাথেsetTagForChildDirectedTreatment
কল করুন যে আপনি COPPA-এর উদ্দেশ্যে আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করতে চান। এটি অ্যান্ড্রয়েড বিজ্ঞাপন শনাক্তকারীর (এএআইডি) সংক্রমণকে বাধা দেয়।TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
এর সাথেsetTagForChildDirectedTreatment
কল করুন যে আপনি COPPA-এর উদ্দেশ্যে আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করতে চান না।আপনি যদি বিজ্ঞাপনের অনুরোধে COPPA-এর ক্ষেত্রে আপনার বিষয়বস্তুকে কীভাবে ব্যবহার করতে চান তা নির্দেশ করতে না চাইলে
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
এর সাথেsetTagForChildDirectedTreatment
এ কল করুন।
নিম্নলিখিত উদাহরণটি নির্দেশ করে যে আপনি COPPA-এর উদ্দেশ্যে আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করতে চান:
জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
কোটলিন
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
সম্মতির বয়স কম ব্যবহারকারীদের
ইউরোপিয়ান ইকোনমিক এরিয়া (EEA) এর ব্যবহারকারীদের সম্মতির বয়সের কম বয়সী ব্যবহারকারীদের চিকিৎসা পাওয়ার জন্য আপনি বিজ্ঞাপনের অনুরোধগুলি চিহ্নিত করতে পারেন। এই বৈশিষ্ট্যটি জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) মেনে চলার সুবিধার্থে ডিজাইন করা হয়েছে। মনে রাখবেন GDPR-এর অধীনে আপনার অন্যান্য আইনি বাধ্যবাধকতা থাকতে পারে। ইউরোপীয় ইউনিয়নের নির্দেশিকা পর্যালোচনা করুন এবং আপনার নিজের আইনী পরামর্শের সাথে পরামর্শ করুন। মনে রাখবেন যে Google-এর টুলগুলি সম্মতি সহজতর করার জন্য ডিজাইন করা হয়েছে এবং আইনের অধীনে কোনও নির্দিষ্ট প্রকাশককে তার বাধ্যবাধকতা থেকে মুক্তি দেয় না।GDPR কীভাবে প্রকাশকদের প্রভাবিত করে সে সম্পর্কে আরও জানুন ।
এই বৈশিষ্ট্যটি ব্যবহার করার সময়, ইউরোপে সম্মতির বয়সের নিচে ব্যবহারকারীদের জন্য একটি ট্যাগ (TFUA) প্যারামিটার বিজ্ঞাপনের অনুরোধে অন্তর্ভুক্ত করা হয়। এই প্যারামিটারটি সমস্ত বিজ্ঞাপন অনুরোধের জন্য পুনরায় বিপণন সহ ব্যক্তিগতকৃত বিজ্ঞাপন অক্ষম করে। এটি তৃতীয় পক্ষের বিজ্ঞাপন বিক্রেতাদের অনুরোধগুলিকে অক্ষম করে, যেমন বিজ্ঞাপন পরিমাপ পিক্সেল এবং তৃতীয় পক্ষের বিজ্ঞাপন সার্ভার৷
শিশু-নির্দেশিত সেটিংসের মতো, TFUA প্যারামিটার সেট করার জন্য RequestConfiguration.Builder
এ একটি পদ্ধতি রয়েছে: setTagForUnderAgeOfConsent()
, নিম্নলিখিত বিকল্পগুলির সাথে।
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
এর সাথেsetTagForUnderAgeOfConsent()
এ কল করুন যে আপনি বিজ্ঞাপনের অনুরোধটি ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ব্যবহারকারীদের সম্মতির কম বয়সের জন্য চিকিত্সা পেতে চান তা বোঝাতে। এটি অ্যান্ড্রয়েড বিজ্ঞাপন শনাক্তকারীর (এএআইডি) সংক্রমণকেও বাধা দেয়।TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
এর সাথেsetTagForUnderAgeOfConsent()
এ কল করুন যে আপনি বিজ্ঞাপনের অনুরোধটি ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) সম্মতির বয়সের কম ব্যবহারকারীদের জন্য চিকিত্সা গ্রহণ না করতে চান তা নির্দেশ করুন৷TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
এর সাথেsetTagForUnderAgeOfConsent()
এ কল করুন যে বিজ্ঞাপনের অনুরোধটি ইউরোপীয় অর্থনৈতিক এলাকার (EEA) সম্মতির বয়সের কম ব্যবহারকারীদের জন্য ব্যবহার করা উচিত কিনা তা নির্দিষ্ট করেননি।
নিম্নলিখিত উদাহরণটি নির্দেশ করে যে আপনি আপনার বিজ্ঞাপনের অনুরোধে TFUA অন্তর্ভুক্ত করতে চান:
জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
কোটলিন
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
শিশু-নির্দেশিত সেটিং সক্ষম করার ট্যাগ এবং setTagForUnderAgeOfConsent()
উভয়ই একই সাথে true
সেট করা উচিত নয়। যদি সেগুলি হয়, তবে শিশু-নির্দেশিত সেটিং অগ্রাধিকার পায়৷
বিজ্ঞাপন সামগ্রী ফিল্টারিং
Google Play-এর অনুপযুক্ত বিজ্ঞাপন নীতি মেনে চলার জন্য যাতে একটি বিজ্ঞাপনের মধ্যে সম্পর্কিত অফারগুলি অন্তর্ভুক্ত থাকে, আপনার অ্যাপের মধ্যে দেখানো সমস্ত বিজ্ঞাপন এবং তাদের সম্পর্কিত অফারগুলি অবশ্যই আপনার অ্যাপের সামগ্রীর রেটিং- এর জন্য উপযুক্ত হতে হবে, এমনকি সামগ্রীটি নিজে থেকেই Google Play-এর নীতির সাথে সঙ্গতিপূর্ণ হলেও .
সর্বাধিক বিজ্ঞাপন সামগ্রী রেটিং এর মতো সরঞ্জামগুলি আপনাকে আপনার ব্যবহারকারীদের দেখানো বিজ্ঞাপনগুলির বিষয়বস্তুর উপর আরও নিয়ন্ত্রণ করতে সহায়তা করতে পারে। প্ল্যাটফর্ম নীতি মেনে চলতে সাহায্য করার জন্য আপনি সর্বোচ্চ কন্টেন্ট রেটিং সেট করতে পারেন।
অ্যাপগুলি setMaxAdContentRating
পদ্ধতি ব্যবহার করে তাদের বিজ্ঞাপনের অনুরোধের জন্য সর্বাধিক বিজ্ঞাপন সামগ্রী রেটিং সেট করতে পারে। যখন এটি কনফিগার করা হয় তখন AdMob বিজ্ঞাপনগুলিকে সেই স্তরে বা নীচে একটি সামগ্রী রেটিং দেওয়া হয়৷ এই নেটওয়ার্কের জন্য অতিরিক্ত সম্ভাব্য মানগুলি ডিজিটাল সামগ্রী লেবেল শ্রেণীবিভাগের উপর ভিত্তি করে , এবং নিম্নলিখিত স্ট্রিংগুলির মধ্যে একটি হতে হবে:
-
MAX_AD_CONTENT_RATING_G
-
MAX_AD_CONTENT_RATING_PG
-
MAX_AD_CONTENT_RATING_T
-
MAX_AD_CONTENT_RATING_MA
নিম্নলিখিত কোডটি একটি RequestConfiguration
অবজেক্ট কনফিগার করে তা নির্দিষ্ট করে যে বিজ্ঞাপনের সামগ্রীটি একটি ডিজিটাল সামগ্রী লেবেল উপাধির সাথে সঙ্গতিপূর্ণ হওয়া উচিত G
এর চেয়ে বেশি নয়:
জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
কোটলিন
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
এই সম্পর্কে আরও জানো:
প্রতিটি বিজ্ঞাপন অনুরোধের জন্য সর্বাধিক কন্টেন্ট রেটিং সেট করা
একটি অ্যাপ বা অ্যাকাউন্টের জন্য সর্বাধিক বিজ্ঞাপন সামগ্রী রেটিং সেট করা
প্রকাশকের গোপনীয়তা চিকিত্সা (বিটা)
প্রকাশকের গোপনীয়তা চিকিত্সা(PPT) API হল একটি ঐচ্ছিক টুল যা অ্যাপগুলিকে setPublisherPrivacyPersonalizationState()
পদ্ধতি ব্যবহার করে সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করতে হবে কিনা তা নির্দেশ করতে দেয়। এই বৈশিষ্ট্যটি ব্যবহার করার সময়, একটি প্রকাশক গোপনীয়তা চিকিত্সা (PPT) প্যারামিটারটি সেশনের বাকি অংশের জন্য ভবিষ্যতের সমস্ত বিজ্ঞাপন অনুরোধে অন্তর্ভুক্ত করা হয়।
ডিফল্টরূপে, Google-এর কাছে বিজ্ঞাপনের অনুরোধ ব্যক্তিগতকৃত বিজ্ঞাপন পরিবেশন করা হয়। নিম্নলিখিত কোড সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করে:
জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
কোটলিন
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
বিজ্ঞাপন অনুরোধ
AdManagerAdRequest
অবজেক্ট একটি বিজ্ঞাপন অনুরোধের সাথে পাঠানোর জন্য টার্গেটিং তথ্য সংগ্রহ করে।
কাস্টম টার্গেটিং
আপনি AdManagerAdRequest.Builder.addCustomTargeting()
এর মাধ্যমে Google বিজ্ঞাপন ম্যানেজার প্রচারাভিযান (লাইন আইটেম) লক্ষ্য করতে কাস্টম কী-মান জোড়া পাস করতে পারেন :
জাভা
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
কোটলিন
// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build()
আপনি স্ট্রিংগুলির একটি তালিকা হিসাবে একটি কীটির জন্য একাধিক মান পাস করতে পারেন। উদাহরণস্বরূপ, মাত্র 25 বছর বয়সী ব্যক্তিদের লক্ষ্য না করে তাদের বিশের দশকের মাঝামাঝি ব্যক্তিদের লক্ষ্য করা।
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
Android API ডেমো অ্যাপে কাস্টম টার্গেটিং বাস্তবায়নের জন্য অ্যাড ম্যানেজার কাস্টম টার্গেটিং উদাহরণ দেখুন।
বিভাগ বর্জন
আপনি AdManagerAdRequest.Builder
দ্বারা প্রদত্ত addCategoryExclusion()
পদ্ধতি ব্যবহার করে একটি অনুরোধে একটি স্লট-স্তরের বিভাগ বর্জন স্তর যোগ করতে পারেন:
জাভা
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
কোটলিন
// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()
অ্যান্ড্রয়েড এপিআই ডেমো অ্যাপে বিভাগ বর্জনের একটি বাস্তবায়নের জন্য অ্যাড ম্যানেজার ক্যাটাগরি এক্সক্লুশনের উদাহরণ দেখুন।
প্রকাশক শনাক্তকারী প্রদান করেছেন
ফ্রিকোয়েন্সি ক্যাপিং, দর্শক বিভাজন এবং টার্গেটিং, অনুক্রমিক বিজ্ঞাপন ঘূর্ণন, এবং ডিভাইস জুড়ে অন্যান্য দর্শক-ভিত্তিক বিজ্ঞাপন বিতরণ নিয়ন্ত্রণে ব্যবহারের জন্য আপনি একটি প্রকাশক প্রদত্ত শনাক্তকারী (PPID) সেট করতে পারেন।
এখানে PPID সেট করার একটি উদাহরণ:
জাভা
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
কোটলিন
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
অ্যান্ড্রয়েড এপিআই ডেমো অ্যাপে প্রকাশক প্রদত্ত শনাক্তকারী (পিপিআইডি) বাস্তবায়নের জন্য অ্যাড ম্যানেজার পিপিআইডি উদাহরণ দেখুন।
প্রকাশক সংকেত প্রদান করেছে
আপনি বিজ্ঞাপনের অনুরোধে প্রকাশক প্রদত্ত সংকেত (পিপিএস) হিসাবে দর্শক এবং প্রাসঙ্গিক ডেটা পাঠাতে পারেন। PPS-এর সাহায্যে, আপনি ব্যবহারকারীর শনাক্তকারী শেয়ার করার প্রয়োজন ছাড়াই, স্ট্যান্ডার্ড ট্যাক্সোনমি ব্যবহার করে, সমস্ত লেনদেনের ধরনে বিডারদের কাছে আপনার দর্শকের বৈশিষ্ট্যগুলিকে যোগাযোগ করে প্রোগ্রাম্যাটিক নগদীকরণ উন্নত করতে আপনার ব্যবহারকারীর ডেটা ব্যবহার করতে পারেন। আপনার শ্রোতা বৈশিষ্ট্য আচরণগত এবং আগ্রহ-ভিত্তিক ডেটা ( IAB অডিয়েন্স ট্যাক্সোনমি 1.1 ) এবং প্রাসঙ্গিক ডেটা ( IAB কন্টেন্ট ট্যাক্সোনমি 2.2 ) অন্তর্ভুক্ত করতে পারে।
জাভা
Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
কোটলিন
val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))
val request = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
বিষয়বস্তুর URL
বিষয়বস্তু-লক্ষ্যযুক্ত বিজ্ঞাপন এবং ব্র্যান্ড নিরাপত্তার জন্য একটি সামগ্রী URL প্রদান করতে, আপনি একটি AdManagerAdRequest
তৈরি করার সময় setContentUrl()
কল করতে পারেন:
জাভা
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
কোটলিন
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
ব্র্যান্ড নিরাপত্তা (বিটা)
বিভিন্ন শ্রোতাদের উদ্দেশ্যে গতিশীল বিষয়বস্তু প্রদর্শন করে এমন অ্যাপ্লিকেশনগুলি একটি AdManagerAdRequest
তৈরি করার সময় setNeighboringContentUrls()
পদ্ধতি ব্যবহার করে URLগুলির একটি সংক্ষিপ্ত তালিকা প্রদান করতে সক্ষম হয়:
জাভা
ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build();
কোটলিন
var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
"https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build()
.setNeighboringContentUrls()
.setContentUrl()
থেকে আলাদা যে এটি শুধুমাত্র ব্র্যান্ড নিরাপত্তার জন্য ব্যবহার করা হয়।