هدف گذاری

این راهنما نحوه ارائه اطلاعات هدفمندی به Google Mobile Ads SDK را توضیح می‌دهد.

برای مثالی کاربردی، برنامه Android API Demo demo را دانلود کنید.

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

پیش نیاز

RequestConfiguration

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 به‌عنوان کارگردانی کودک در نظر گرفته شود. این از انتقال شناسه تبلیغاتی اندروید (AAID) جلوگیری می کند.

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

مانند تنظیمات هدایت‌شده توسط کودک، روشی در 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 در درخواست های تبلیغاتی شما گنجانده شود:

کاتلین 

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

تگ‌هایی که برای فعال کردن تنظیمات 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 نباشد مطابقت داشته باشد:

کاتلین 

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

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

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

API درمان حریم خصوصی ناشر (PPT) ابزاری اختیاری است که به برنامه‌ها اجازه می‌دهد با استفاده از روش 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);

درخواست آگهی

شی AdRequest اطلاعات هدف را جمع آوری می کند تا با درخواست تبلیغ ارسال شود.

برای اجرای هدف گذاری تبلیغات در برنامه نمایشی Android API به مثال هدف گذاری تبلیغات مراجعه کنید.