এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google মোবাইল বিজ্ঞাপন SDK-তে টার্গেটিং তথ্য প্রদান করতে হয়।
একটি কার্যকরী উদাহরণের জন্য, Android API ডেমো অ্যাপটি ডাউনলোড করুন।পূর্বশর্ত
- শুরু করুন নির্দেশিকাটি সম্পূর্ণ করুন।
অনুরোধ কনফিগারেশন
RequestConfiguration প্রতিটি বিজ্ঞাপন অনুরোধে বিশ্বব্যাপী প্রয়োগ করা টার্গেটিং তথ্য সংগ্রহ করে। উপলব্ধ টার্গেটিং ট্যাগের জন্য, RequestConfiguration.Builder ডকুমেন্টেশন দেখুন।
অনুরোধ কনফিগারেশন আপডেট করতে, বিদ্যমান কনফিগারেশন থেকে একটি বিল্ডার পান, যেকোনো নির্বাচিত আপডেট সম্পাদন করুন এবং এটি নিম্নরূপ সেট করুন:
কোটলিন
val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)জাভা
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);সমস্ত বিজ্ঞাপন অনুরোধ যাতে অনুরোধ কনফিগারেশনের পরিবর্তনগুলি প্রয়োগ করে তা নিশ্চিত করতে, Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে অনুরোধ কনফিগারেশন সেট করুন।
শিশু-নির্দেশিত সেটিং
শিশুদের অনলাইন গোপনীয়তা সুরক্ষা আইন (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 =
MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)জাভা
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForChildDirectedTreatment(
RequestConfiguration.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 =
MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)জাভা
RequestConfiguration 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 এর চেয়ে বেশি নয় এমন একটি ডিজিটাল কন্টেন্ট লেবেল উপাধির সাথে সঙ্গতিপূর্ণ হওয়া উচিত:
কোটলিন
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)জাভা
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);প্রতিটি বিজ্ঞাপন অনুরোধের জন্য সর্বোচ্চ কন্টেন্ট রেটিং নির্ধারণ সম্পর্কে আরও জানুন।
প্রকাশকের গোপনীয়তা ব্যবস্থাপনা (বিটা)
প্রকাশক গোপনীয়তা ব্যবস্থাপনা (PPT) API হল একটি ঐচ্ছিক টুল যা অ্যাপগুলিকে setPublisherPrivacyPersonalizationState() পদ্ধতি ব্যবহার করে সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করতে হবে কিনা তা নির্দেশ করতে দেয়। এই বৈশিষ্ট্যটি ব্যবহার করার সময়, সেশনের বাকি অংশের জন্য ভবিষ্যতের সমস্ত বিজ্ঞাপন অনুরোধে একটি প্রকাশক গোপনীয়তা ব্যবস্থাপনা (PPT) প্যারামিটার অন্তর্ভুক্ত করা হয়।
ডিফল্টরূপে, Google-এ বিজ্ঞাপনের অনুরোধগুলি ব্যক্তিগতকৃত বিজ্ঞাপন পরিবেশন করা হয়। নিম্নলিখিত কোডটি সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করে দেয়:
কোটলিন
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)জাভা
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);বিজ্ঞাপনের অনুরোধ
AdManagerAdRequest অবজেক্টটি বিজ্ঞাপনের অনুরোধের সাথে পাঠানোর জন্য লক্ষ্য তথ্য সংগ্রহ করে।
নেটওয়ার্কের অতিরিক্ত সুবিধা যোগ করুন
নেটওয়ার্ক এক্সট্রা হলো একটি বিজ্ঞাপনের অনুরোধের সাথে পাঠানো অতিরিক্ত বিবরণ যা একটি একক বিজ্ঞাপন উৎসের জন্য নির্দিষ্ট।
নিম্নলিখিত কোড স্নিপেটটি Google-এ bottom মান সহ collapsible এর একটি অতিরিক্ত প্যারামিটার কী সেট করে:
কোটলিন
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)জাভা
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);কাস্টম টার্গেটিং
আপনি Google বিজ্ঞাপন ম্যানেজার প্রচারাভিযান (লাইন আইটেম) লক্ষ্য করার জন্য কাস্টম কী-মান জোড়া পাস করতে পারেন। নিম্নলিখিত উদাহরণটি একটি বিজ্ঞাপন অনুরোধে একটি কাস্টম কী-মান জোড়া পাস করে:
কোটলিন
// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()জাভা
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();আপনি স্ট্রিং এর তালিকা হিসেবে একটি কী-এর জন্য একাধিক মান পাস করতে পারেন। উদাহরণস্বরূপ, শুধুমাত্র ২৫ বছর বয়সীদের পরিবর্তে বিশের দশকের মাঝামাঝি ব্যক্তিদের লক্ষ্য করে।
কোটলিন
.addCustomTargeting("age", listOf("24", "25", "26"))জাভা
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))বিভাগ বাদ দেওয়া
addCategoryExclusion() পদ্ধতি ব্যবহার করে আপনি একটি অনুরোধে একটি স্লট-লেভেল ক্যাটাগরি এক্সক্লুশন লেভেল যোগ করতে পারেন:
কোটলিন
// Example: Exclude "automobile" and "boat" categories.
val newRequest =
AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()জাভা
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();অ্যান্ড্রয়েড এপিআই ডেমো অ্যাপে বিভাগ বর্জনের বাস্তবায়নের জন্য বিজ্ঞাপন পরিচালক বিভাগ বর্জনের উদাহরণটি দেখুন।
প্রকাশকের দেওয়া শনাক্তকারী
আপনি ডিভাইস জুড়ে ফ্রিকোয়েন্সি ক্যাপিং, দর্শক বিভাজন এবং টার্গেটিং, ক্রমিক বিজ্ঞাপন ঘূর্ণন এবং অন্যান্য দর্শক-ভিত্তিক বিজ্ঞাপন বিতরণ নিয়ন্ত্রণের জন্য একটি প্রকাশক প্রদত্ত শনাক্তকারী (PPID) সেট করতে পারেন।
PPID সেট করার একটি উদাহরণ এখানে দেওয়া হল:
কোটলিন
val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()জাভা
AdManagerAdRequest adRequest =
new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();Android API ডেমো অ্যাপে প্রকাশক প্রদত্ত শনাক্তকারী (PPID) বাস্তবায়নের জন্য বিজ্ঞাপন পরিচালক PPID উদাহরণটি দেখুন।
প্রকাশক সিগন্যাল প্রদান করেছেন
আপনি বিজ্ঞাপনের অনুরোধে প্রকাশক প্রদত্ত সংকেত (PPS) হিসেবে দর্শক এবং প্রাসঙ্গিক ডেটা পাঠাতে পারেন। PPS-এর মাধ্যমে, আপনি ব্যবহারকারীর শনাক্তকারী শেয়ার না করেই স্ট্যান্ডার্ড ট্যাক্সোনমি ব্যবহার করে সকল লেনদেনের ধরণে দরদাতাদের কাছে আপনার দর্শক বৈশিষ্ট্যগুলি যোগাযোগ করে প্রোগ্রাম্যাটিক নগদীকরণ উন্নত করতে আপনার ব্যবহারকারীর ডেটা ব্যবহার করতে পারেন। আপনার দর্শকের বৈশিষ্ট্যগুলির মধ্যে আচরণগত এবং আগ্রহ-ভিত্তিক ডেটা ( IAB Audience Taxonomy 1.1 ) এবং প্রাসঙ্গিক ডেটা ( IAB Content Taxonomy 2.2 ) অন্তর্ভুক্ত থাকতে পারে।
কোটলিন
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 =
AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()জাভা
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", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));
AdManagerAdRequest request =
new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();কন্টেন্ট ইউআরএল
কন্টেন্ট-টার্গেট করা বিজ্ঞাপন এবং ব্র্যান্ড সুরক্ষার জন্য একটি কন্টেন্ট URL প্রদান করতে, নিম্নলিখিতগুলি যোগ করুন:
কোটলিন
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()জাভা
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();ব্র্যান্ড সুরক্ষা (বিটা)
বিভিন্ন শ্রোতাদের জন্য তৈরি গতিশীল সামগ্রী প্রদর্শনকারী অ্যাপ্লিকেশনগুলি URL গুলির একটি সংক্ষিপ্ত তালিকা প্রদান করতে সক্ষম:
কোটলিন
val urls =
mutableListOf(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com",
)
val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()জাভা
List<String> urls =
Arrays.asList(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent =
new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build(); .setNeighboringContentUrls() .setContentUrl() থেকে আলাদা কারণ এটি শুধুমাত্র ব্র্যান্ডের নিরাপত্তার জন্য ব্যবহৃত হয়।