টার্গেটিং

এই নির্দেশিকা ব্যাখ্যা করে যে কীভাবে Google মোবাইল বিজ্ঞাপন SDK-কে টার্গেটিং তথ্য প্রদান করতে হয়।

API ডেমো ডাউনলোড করুন

পূর্বশর্ত

• শুরু করুন গাইডটি সম্পূর্ণ করুন।

অনুরোধ কনফিগারেশন

RequestConfiguration প্রতিটি বিজ্ঞাপন অনুরোধে বিশ্বব্যাপী প্রয়োগ করা টার্গেটিং তথ্য সংগ্রহ করে। উপলব্ধ টার্গেটিং ট্যাগের জন্য, RequestConfiguration.Builder ডকুমেন্টেশন পড়ুন।

অনুরোধ কনফিগারেশন আপডেট করতে, বিদ্যমান কনফিগারেশন থেকে একজন বিল্ডার প্রাপ্ত করুন, যেকোনো পছন্দসই আপডেট সম্পাদন করুন এবং এটি নিম্নরূপ সেট করুন:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

সমস্ত বিজ্ঞাপন অনুরোধ অনুরোধ কনফিগারেশন পরিবর্তনগুলি প্রয়োগ করে তা নিশ্চিত করতে, আপনি মোবাইল বিজ্ঞাপন SDK শুরু করার আগে অনুরোধ কনফিগারেশন সেট করুন৷

শিশু-নির্দেশিত সেটিং

চিলড্রেনস অনলাইন প্রাইভেসি প্রোটেকশন অ্যাক্ট (COPPA) এর উদ্দেশ্যে, "শিশু-নির্দেশিত চিকিত্সার জন্য ট্যাগ" নামে একটি সেটিং রয়েছে৷ এই ট্যাগ সেট করে, আপনি প্রত্যয়িত করেন যে এই বিজ্ঞপ্তিটি সঠিক এবং আপনি অ্যাপের মালিকের পক্ষে কাজ করার জন্য অনুমোদিত৷ আপনি বুঝতে পেরেছেন যে এই সেটিংটির অপব্যবহারের ফলে আপনার Google অ্যাকাউন্টটি বন্ধ হয়ে যেতে পারে৷

একজন অ্যাপ ডেভেলপার হিসেবে, আপনি নির্দেশ করতে পারেন যে আপনি বিজ্ঞাপনের অনুরোধ করার সময় Google আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করুক। আপনি যদি ইঙ্গিত করেন যে আপনি Google আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করুক, আমরা সেই বিজ্ঞাপন অনুরোধে IBA এবং পুনরায় বিপণন বিজ্ঞাপনগুলি অক্ষম করার জন্য পদক্ষেপ নিই।

আপনি setTagForChildDirectedTreatment() এর মাধ্যমে শিশু-নির্দেশিত সেটিং প্রয়োগ করতে পারেন:

• 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-এর উদ্দেশ্যে আপনার সামগ্রীকে শিশু-নির্দেশিত হিসাবে বিবেচনা করতে চান:

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) প্যারামিটার বিজ্ঞাপনের অনুরোধে অন্তর্ভুক্ত করা হয়। এই প্যারামিটারটি সমস্ত বিজ্ঞাপন অনুরোধের জন্য পুনরায় বিপণন সহ ব্যক্তিগতকৃত বিজ্ঞাপন অক্ষম করে। এটি তৃতীয় পক্ষের বিজ্ঞাপন বিক্রেতাদের অনুরোধগুলিকে অক্ষম করে, যেমন বিজ্ঞাপন পরিমাপ পিক্সেল এবং তৃতীয় পক্ষের বিজ্ঞাপন সার্ভার৷

শিশু-নির্দেশিত সেটিংসের মতো, 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 অন্তর্ভুক্ত করতে চান:

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);

প্রতিটি বিজ্ঞাপন অনুরোধের জন্য সর্বাধিক সামগ্রী রেটিং সেট করার বিষয়ে আরও জানুন।

প্রকাশকের গোপনীয়তা চিকিত্সা (বিটা)

Publisher Privacy Treatment (PPT) API হল একটি ঐচ্ছিক টুল যা অ্যাপগুলিকে setPublisherPrivacyPersonalizationState() পদ্ধতি ব্যবহার করে সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করতে হবে কিনা তা নির্দেশ করতে দেয়। এই বৈশিষ্ট্যটি ব্যবহার করার সময়, একটি প্রকাশক গোপনীয়তা চিকিত্সা (PPT) প্যারামিটারটি সেশনের বাকি অংশের জন্য ভবিষ্যতের সমস্ত বিজ্ঞাপন অনুরোধে অন্তর্ভুক্ত করা হয়।

ডিফল্টরূপে, Google-এর কাছে বিজ্ঞাপনের অনুরোধ ব্যক্তিগতকৃত বিজ্ঞাপন পরিবেশন করা হয়। নিম্নলিখিত কোড সমস্ত বিজ্ঞাপন অনুরোধের জন্য বিজ্ঞাপন ব্যক্তিগতকরণ বন্ধ করে:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

বিজ্ঞাপন অনুরোধ

AdManagerAdRequest অবজেক্ট একটি বিজ্ঞাপন অনুরোধের সাথে পাঠানোর জন্য টার্গেটিং তথ্য সংগ্রহ করে।

কাস্টম টার্গেটিং

আপনি AdManagerAdRequest.Builder.addCustomTargeting() এর মাধ্যমে 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();

আপনি স্ট্রিংগুলির একটি তালিকা হিসাবে একটি কীটির জন্য একাধিক মান পাস করতে পারেন। উদাহরণস্বরূপ, মাত্র 25 বছর বয়সী ব্যক্তিদের লক্ষ্য না করে তাদের বিশের দশকের মাঝামাঝি ব্যক্তিদের লক্ষ্য করা।

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Android API ডেমো অ্যাপে কাস্টম টার্গেটিং বাস্তবায়নের জন্য অ্যাড ম্যানেজার কাস্টম টার্গেটিং উদাহরণ দেখুন।

বিভাগ বর্জন

আপনি AdManagerAdRequest.Builder দ্বারা প্রদত্ত 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();

অ্যান্ড্রয়েড এপিআই ডেমো অ্যাপে প্রকাশক প্রদত্ত শনাক্তকারী (পিপিআইডি) বাস্তবায়নের জন্য অ্যাড ম্যানেজার পিপিআইডি উদাহরণ দেখুন।

প্রকাশক সংকেত প্রদান করেছে

আপনি বিজ্ঞাপনের অনুরোধে প্রকাশক প্রদত্ত সংকেত (পিপিএস) হিসাবে দর্শক এবং প্রাসঙ্গিক ডেটা পাঠাতে পারেন। PPS-এর সাহায্যে, আপনি ব্যবহারকারীর শনাক্তকারী শেয়ার করার প্রয়োজন ছাড়াই, স্ট্যান্ডার্ড ট্যাক্সোনমি ব্যবহার করে, সমস্ত লেনদেনের ধরনে বিডারদের কাছে আপনার দর্শকের বৈশিষ্ট্যগুলিকে যোগাযোগ করে প্রোগ্রাম্যাটিক নগদীকরণ উন্নত করতে আপনার ব্যবহারকারীর ডেটা ব্যবহার করতে পারেন। আপনার শ্রোতা বৈশিষ্ট্য আচরণগত এবং আগ্রহ-ভিত্তিক ডেটা ( IAB অডিয়েন্স ট্যাক্সোনমি 1.1 ) এবং প্রাসঙ্গিক ডেটা ( IAB কন্টেন্ট ট্যাক্সোনমি 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 = AdRequest.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", 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()

বিষয়বস্তুর URL

বিষয়বস্তু-লক্ষ্যযুক্ত বিজ্ঞাপন এবং ব্র্যান্ড নিরাপত্তার জন্য একটি সামগ্রী URL প্রদান করতে, আপনি একটি AdManagerAdRequest তৈরি করার সময় setContentUrl() কল করতে পারেন:

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();

ব্র্যান্ড নিরাপত্তা (বিটা)

বিভিন্ন শ্রোতাদের উদ্দেশ্যে গতিশীল বিষয়বস্তু প্রদর্শন করে এমন অ্যাপ্লিকেশনগুলি একটি AdManagerAdRequest তৈরি করার সময় setNeighboringContentUrls() পদ্ধতি ব্যবহার করে 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()

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();

.setNeighboringContentUrls() .setContentUrl() থেকে আলাদা যে এটি শুধুমাত্র ব্র্যান্ড নিরাপত্তার জন্য ব্যবহার করা হয়।