هدف گذاری

این راهنما نحوه ارائه اطلاعات هدفمند به درخواست آگهی را توضیح می دهد. برای مثالی کاربردی، برنامه Android API Demo demo را دانلود کنید.

دانلود نسخه نمایشی API

پيش نياز

RequestConfiguration

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) می‌توان از این تنظیم با همه نسخه‌های SDK خدمات Google Play استفاده کرد:

  • با TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE با setTagForChildDirectedTreatment تماس بگیرید تا نشان دهید که می‌خواهید محتوای شما برای اهداف COPPA به‌عنوان کارگردانی کودک در نظر گرفته شود. این از انتقال شناسه تبلیغاتی اندروید (AAID) جلوگیری می کند.

  • با 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) در درخواست آگهی گنجانده شده است. این پارامتر تبلیغات شخصی شده، از جمله بازاریابی مجدد را برای همه درخواست‌های تبلیغات غیرفعال می‌کند. همچنین درخواست‌های فروشنده‌های تبلیغات شخص ثالث، مانند پیکسل‌های اندازه‌گیری آگهی و سرورهای آگهی شخص ثالث را غیرفعال می‌کند.

مانند تنظیمات هدایت‌شده توسط کودک، روشی در RequestConfiguration.Builder برای تنظیم پارامتر TFUA وجود دارد: setTagForUnderAgeOfConsent() با گزینه‌های زیر.

  • setTagForUnderAgeOfConsent() را با TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE فراخوانی کنید تا نشان دهید که می‌خواهید درخواست آگهی برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (EEA) درمان شود. این همچنین از انتقال شناسه تبلیغاتی اندروید (AAID) جلوگیری می کند.

  • با TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE setTagForUnderAgeOfConsent() فراخوانی کنید تا نشان دهید که می‌خواهید درخواست تبلیغ برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (EEA) درمان نشود .

  • با setTagForUnderAgeOfConsent() با TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED تماس بگیرید تا مشخص کنید که آیا درخواست آگهی باید برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (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)

تگ‌هایی که برای فعال کردن تنظیمات Child-directed و 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)

بیشتر بدانید در مورد:

درمان حریم خصوصی ناشر (بتا)

APIPublisher Privacy Treatment(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 Ad Manager (موارد خط) ارسال کنید:

جاوا

// 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"))

مثال Ad Manager Custom Targeting را برای پیاده سازی هدف گذاری سفارشی در برنامه نمایشی Android API بررسی کنید.

استثناهای دسته بندی

با استفاده از متد addCategoryExclusion() که توسط AdManagerAdRequest.Builder ارائه شده است، می‌توانید سطح محرومیت دسته‌بندی در سطح اسلات را به درخواست اضافه کنید:

جاوا

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

برای پیاده‌سازی استثناهای دسته‌بندی در برنامه آزمایشی Android API ، مثال Exclusions Category Ad Manager را بررسی کنید.

ناشر شناسه هایی را ارائه کرد

می‌توانید شناسه ارائه‌شده ناشر (PPID) را برای استفاده در محدودیت‌های فرکانس، تقسیم‌بندی و هدف‌یابی مخاطب، چرخش متوالی آگهی و سایر کنترل‌های تحویل آگهی مبتنی بر مخاطب در دستگاه‌ها تنظیم کنید.

در اینجا مثالی از تنظیم PPID آورده شده است:

جاوا

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

کاتلین

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

مثال Ad Manager PPID را برای پیاده سازی شناسه های ارائه شده ناشر (PPID) در برنامه آزمایشی API Android بررسی کنید.

ناشر سیگنال هایی را ارائه کرد

می‌توانید مخاطبان و داده‌های متنی را به‌عنوان سیگنال‌های ارائه‌شده ناشر (PPS) در درخواست‌های آگهی ارسال کنید. با PPS، می‌توانید از داده‌های کاربر خود برای بهبود درآمدزایی برنامه‌ای با برقراری ارتباط با ویژگی‌های مخاطبان خود به پیشنهاد دهندگان در همه انواع تراکنش ، با استفاده از طبقه‌بندی استاندارد، بدون نیاز به اشتراک‌گذاری شناسه‌های کاربر، استفاده کنید. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه ( IAB Audience Taxonomy 1.1 ) و داده‌های متنی ( IAB Content Taxonomy 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()

ایمنی برند (بتا)

برنامه‌هایی که محتوای پویا را برای مخاطبان مختلف نمایش می‌دهند، می‌توانند با استفاده از متد setNeighboringContentUrls() فهرست کوتاهی از URLها را هنگام ساخت AdManagerAdRequest ارائه دهند:

جاوا

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() متفاوت است زیرا فقط برای ایمنی نام تجاری استفاده می شود.