এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google মোবাইল বিজ্ঞাপন SDK-তে টার্গেটিং তথ্য প্রদান করতে হয়।
পূর্বশর্ত
- শুরু করুন নির্দেশিকাটি সম্পূর্ণ করুন।
অনুরোধ কনফিগারেশন
RequestConfiguration প্রতিটি বিজ্ঞাপন অনুরোধে বিশ্বব্যাপী প্রয়োগ করা টার্গেটিং তথ্য সংগ্রহ করে। উপলব্ধ টার্গেটিং ট্যাগের জন্য, RequestConfiguration.Builder ডকুমেন্টেশন দেখুন।
আপনার প্রয়োজনীয় টার্গেটিং ট্যাগ দিয়ে একটি RequestConfiguration অবজেক্ট তৈরি করুন, এর বিল্ডার ব্যবহার করে, তারপর MobileAds.setRequestConfiguration() কল করে কনফিগারেশন সেট করুন।
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
প্রথম বিজ্ঞাপন অনুরোধ থেকে টার্গেটিং ট্যাগ প্রয়োগ করতে, SDK শুরু করার সময় অনুরোধ কনফিগারেশনটি প্রদান করুন:
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
CoroutineScope(Dispatchers.IO).launch {
// Initialize GMA Next Gen SDK on a background thread.
MobileAds.initialize(
this@MainActivity,
InitializationConfig
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build()
) {
// Adapter initialization is complete.
}
// Other methods on MobileAds can now be called.
}
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
new Thread(
() -> {
// Initialize GMA Next Gen SDK on a background thread.
MobileAds.initialize(
this,
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
new InitializationConfig
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
// Other methods on MobileAds can now be called.
})
.start();
শিশু-নির্দেশিত সেটিং
শিশুদের অনলাইন গোপনীয়তা সুরক্ষা আইন (COPPA) এর উদ্দেশ্যে, "শিশু-নির্দেশিত চিকিৎসার জন্য ট্যাগ" নামে একটি সেটিং রয়েছে। এই ট্যাগটি সেট করে, আপনি নিশ্চিত করছেন যে এই বিজ্ঞপ্তিটি সঠিক এবং আপনি অ্যাপের মালিকের পক্ষে কাজ করার জন্য অনুমোদিত। আপনি বুঝতে পারছেন যে এই সেটিংটির অপব্যবহারের ফলে আপনার Google অ্যাকাউন্ট বন্ধ হয়ে যেতে পারে।
একজন অ্যাপ ডেভেলপার হিসেবে, বিজ্ঞাপনের অনুরোধ করার সময় আপনি নির্দেশ করতে পারেন যে Google আপনার কন্টেন্টকে শিশু-নির্দেশিত হিসেবে বিবেচনা করুক। যদি আপনি নির্দেশ করেন যে Google আপনার কন্টেন্টকে শিশু-নির্দেশিত হিসেবে বিবেচনা করুক, তাহলে আমরা সেই বিজ্ঞাপনের অনুরোধে IBA এবং পুনঃবিপণন বিজ্ঞাপন বন্ধ করার পদক্ষেপ নিই।
আপনি setTagForChildDirectedTreatment() এর মাধ্যমে শিশু-নির্দেশিত সেটিং প্রয়োগ করতে পারেন:
আপনার কন্টেন্টকে COPPA-এর উদ্দেশ্যে শিশু-নির্দেশিত হিসেবে বিবেচনা করতে চান তা বোঝাতে
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUEদিয়েsetTagForChildDirectedTreatmentকল করুন। এটি Android বিজ্ঞাপন শনাক্তকারী (AAID) এর সংক্রমণকে বাধা দেয়।আপনার কন্টেন্টকে COPPA-এর উদ্দেশ্যে শিশু-নির্দেশিত হিসেবে বিবেচনা করতে চান না তা বোঝাতে
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEদিয়েsetTagForChildDirectedTreatmentকল করুন।বিজ্ঞাপনের অনুরোধে COPPA-এর ক্ষেত্রে আপনার কন্টেন্ট কীভাবে ব্যবহার করা হবে তা যদি আপনি না চান, তাহলে
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDদিয়েsetTagForChildDirectedTreatmentকল করুন।
নিম্নলিখিত উদাহরণটি ইঙ্গিত দেয় যে আপনি চান যে আপনার কন্টেন্ট COPPA-এর উদ্দেশ্যে শিশু-নির্দেশিত হিসেবে বিবেচিত হোক:
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
সম্মতির বয়সের কম বয়সী ব্যবহারকারীরা
ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর সম্মতির বয়সের কম বয়সী ব্যবহারকারীদের জন্য আপনার বিজ্ঞাপনের অনুরোধগুলি চিহ্নিত করতে পারেন। এই বৈশিষ্ট্যটি জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) মেনে চলা সহজতর করার জন্য ডিজাইন করা হয়েছে। মনে রাখবেন যে GDPR-এর অধীনে আপনার অন্যান্য আইনি বাধ্যবাধকতা থাকতে পারে। ইউরোপীয় ইউনিয়নের নির্দেশিকা পর্যালোচনা করুন এবং আপনার নিজস্ব আইনি পরামর্শদাতার সাথে পরামর্শ করুন। মনে রাখবেন যে Google-এর সরঞ্জামগুলি মেনে চলা সহজতর করার জন্য ডিজাইন করা হয়েছে এবং আইনের অধীনে কোনও নির্দিষ্ট প্রকাশককে তার বাধ্যবাধকতা থেকে মুক্তি দেয় না। GDPR প্রকাশকদের কীভাবে প্রভাবিত করে সে সম্পর্কে আরও জানুন ।
এই বৈশিষ্ট্যটি ব্যবহার করার সময়, বিজ্ঞাপনের অনুরোধে একটি ট্যাগ ফর ইউজারস আন্ডার দ্য এজ অফ কনসেন্ট ইন ইউরোপ (TFUA) প্যারামিটার অন্তর্ভুক্ত থাকে। এই প্যারামিটারটি সমস্ত বিজ্ঞাপন অনুরোধের জন্য ব্যক্তিগতকৃত বিজ্ঞাপন, পুনঃবিপণন সহ, বন্ধ করে দেয়। এটি তৃতীয় পক্ষের বিজ্ঞাপন বিক্রেতাদের অনুরোধও বন্ধ করে দেয়, যেমন বিজ্ঞাপন পরিমাপ পিক্সেল এবং তৃতীয় পক্ষের বিজ্ঞাপন সার্ভার।
শিশু-নির্দেশিত সেটিংসের মতো, RequestConfiguration.Builder এ TFUA প্যারামিটার সেট করার জন্য একটি পদ্ধতি রয়েছে: setTagForUnderAgeOfConsent() , নিম্নলিখিত বিকল্পগুলি সহ।
ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর সম্মতির বয়সের কম বয়সী ব্যবহারকারীদের জন্য বিজ্ঞাপনের অনুরোধটি গ্রহণ করতে চান তা বোঝাতে
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUEদিয়েsetTagForUnderAgeOfConsent()কল করুন। এটি Android বিজ্ঞাপন শনাক্তকারী (AAID) এর সংক্রমণকেও বাধা দেয়।ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর সম্মতির বয়সের কম বয়সী ব্যবহারকারীদের জন্য বিজ্ঞাপনের অনুরোধটি যাতে ব্যবহার না করা হয় তা বোঝাতে
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSEদিয়েsetTagForUnderAgeOfConsent()কল করুন।TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDদিয়েsetTagForUnderAgeOfConsent()কল করুন, যাতে বোঝা যায় যে আপনি নির্দিষ্ট করেননি যে বিজ্ঞাপনের অনুরোধটি ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর সম্মতির বয়সের কম বয়সী ব্যবহারকারীদের জন্য গ্রহণ করা উচিত কিনা।
নিচের উদাহরণটি ইঙ্গিত করে যে আপনি আপনার বিজ্ঞাপনের অনুরোধে TFUA অন্তর্ভুক্ত করতে চান:
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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 চেয়ে বেশি নয় এমন একটি ডিজিটাল কন্টেন্ট লেবেল উপাধির সাথে সঙ্গতিপূর্ণ হওয়া উচিত:
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
.setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
সম্পর্কে আরও জানুন:
প্রতিটি বিজ্ঞাপন অনুরোধের জন্য সর্বোচ্চ কন্টেন্ট রেটিং সেট করা
একটি অ্যাপ বা অ্যাকাউন্টের জন্য সর্বোচ্চ বিজ্ঞাপন সামগ্রীর রেটিং নির্ধারণ করা
প্রকাশকের গোপনীয়তা ব্যবস্থাপনা (বিটা)
প্রকাশক গোপনীয়তা ব্যবস্থাপনা (PPT) API হল একটি ঐচ্ছিক টুল যা অ্যাপগুলিকে setPublisherPrivacyPersonalizationState() পদ্ধতি ব্যবহার করে সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করতে হবে কিনা তা নির্দেশ করতে দেয়। এই বৈশিষ্ট্যটি ব্যবহার করার সময়, সেশনের বাকি অংশের জন্য ভবিষ্যতের সমস্ত বিজ্ঞাপন অনুরোধে একটি প্রকাশক গোপনীয়তা ব্যবস্থাপনা (PPT) প্যারামিটার অন্তর্ভুক্ত করা হয়।
ডিফল্টরূপে, Google-এ বিজ্ঞাপনের অনুরোধগুলি ব্যক্তিগতকৃত বিজ্ঞাপন পরিবেশন করা হয়। নিম্নলিখিত কোডটি সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করে দেয়:
কোটলিন
val requestConfiguration = RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
জাভা
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
বিজ্ঞাপনের অনুরোধ
AdRequest অবজেক্টটি বিজ্ঞাপনের অনুরোধের সাথে পাঠানোর জন্য লক্ষ্যবস্তু সম্পর্কিত তথ্য সংগ্রহ করে।
নেটওয়ার্কের অতিরিক্ত সুবিধা যোগ করুন
নেটওয়ার্ক এক্সট্রা হলো একটি বিজ্ঞাপনের অনুরোধের সাথে পাঠানো অতিরিক্ত বিবরণ যা একটি একক বিজ্ঞাপন উৎসের জন্য নির্দিষ্ট।
নিম্নলিখিত কোড স্নিপেটটি Google-এ bottom মান সহ collapsible এর একটি অতিরিক্ত প্যারামিটার কী সেট করে:
কোটলিন
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
NativeAdLoader.load(adRequest, adCallback)
জাভা
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
NativeAdLoader.load(adRequest, adCallback);