هدف گیری

این راهنما توضیح می‌دهد که چگونه اطلاعات هدف‌یابی را به کیت توسعه نرم‌افزار Google Mobile Ads ارائه دهید.

پیش‌نیاز

پیش‌از ادامه دادن، GMA Next-Gen SDK را راه‌اندازی کنید.

RequestConfiguration

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

برای اعمال برچسب‌های هدف‌یابی از اولین درخواست آگهی، پیکربندی درخواست را درطول مقداردهی اولیه کیت توسعه نرم‌افزار ارائه دهید:

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

تنظیم رفتار با سن

برای کمک به شما در مدیریت رعایت مقررات حریم خصوصی مربوط به کودکان و نوجوانان، GMA Next-Gen SDK تنظیمات رفتار با سن را ارائه می‌دهد. تنظیم رفتار با سن به شما امکان می‌دهد مشخص کنید که آیا GMA Next-Gen SDK باید محافظت‌های خاصی را برای ارائه آگهی به کودکان، نوجوانان، یا سن نامشخص اعمال کند یا نه.

می‌توانید بااستفاده از روش setAgeRestrictedTreatment() با RequestConfiguration.Builder API، رفتار مقتضی با سن را تنظیم کنید.

مثال زیر نشان می‌دهد که درخواست‌های آگهی باید با محتوای مناسب کودکان رفتار شود:

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

برای نشان دادن رفتار با نوجوان یا سن نامشخص، تنظیم CHILD را با موارد زیر جایگزین کنید:

• TEEN
• UNSPECIFIED

هنگام استفاده از این تنظیم، GMA Next-Gen SDK پارامتر tfat را در درخواست‌های آگهی لحاظ می‌کند. با مشاور حقوقی‌تان مشورت کنید تا براساس تعهدات قانونی و نظارتی‌تان، رفتار مناسب با سن را برای کاربرانتان تعیین کنید. برای اطلاعات بیشتر، برچسب‌گذاری درخواست آگهی برای رفتار مناسب سن را ببینید.

انتقال به رفتار مناسب سن از TFCD و TFUA

تنظیمات رفتار با سن جایگزین تنظیمات منسوخ‌شده .setTagForChildDirectedTreatment() (TFCD) و .setTagForUnderAgeOfConsent() (TFUA) می‌شود.

جدول زیر تنظیمات TFCD و TFUA و معادل‌های رفتار سنی آن‌ها را نشان می‌دهد:

آشنایی با تعاملات رفتار با سن با TFCD و TFUA

اگر تنظیمات رفتار با سن و تنظیمات TFCD یا TFUA را تنظیم کنید، Google محافظه‌کارانه‌ترین رفتار را اعمال می‌کند.

ارسال رفتار با سن با میانجی‌گری

اگر رفتار با سن را بااستفاده از GMA Next-Gen SDK تنظیم کنید، آداپتورهای میانجی سیگنال رفتار با سن را به کیت‌های توسعه نرم‌افزار طرف سوم میانجی‌شده ارسال می‌کنند.

جدول زیر نسخه‌های آداپتور میانجی را فهرست می‌کند که از بازارسال سیگنال رفتار با محدودیت سنی به کیت توسعه نرم‌افزار طرف سوم میانجی‌شده پشتیبانی می‌کنند:

تنظیمات مختص کودکان

برای اهداف قانون محافظت از حریم خصوصی آنلاین کودکان (COPPA)، تنظیمی به‌نام «برچسب برای رفتار مختص کودکان» وجود دارد. با تنظیم این برچسب، گواهی می‌کنید که این اعلان صحیح است و شما مجاز هستید ازطرف مالک برنامه اقدام کنید. می‌دانید که سوءاستفاده از این تنظیم ممکن است منجر به بسته شدن «حساب Google» شما شود.

به‌عنوان توسعه‌دهنده برنامه، می‌توانید مشخص کنید که آیا می‌خواهید Google هنگام درخواست آگهی، محتوای شما را به‌عنوان محتوای مختص کودکان درنظر بگیرد یا نه. اگر مشخص کنید که می‌خواهید Google محتوایتان را به‌عنوان محتوای مختص کودکان درنظر بگیرد، اقداماتی برای غیرفعال کردن IBA و آگهی‌های بازاریابی مجدد در آن درخواست آگهی انجام می‌دهیم.

می‌توانید تنظیمات مختص کودکان را ازطریق setTagForChildDirectedTreatment() اعمال کنید:

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

• setTagForChildDirectedTreatment را با TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE فراخوانی کنید تا نشان دهید نمی‌خواهید محتوایتان برای اهداف COPPA به‌عنوان محتوای ویژه کودکان درنظر گرفته شود.

• اگر نمی‌خواهید مشخص کنید که می‌خواهید با محتوایتان در درخواست‌های آگهی ازنظر COPPA چگونه رفتار شود، setTagForChildDirectedTreatment را با TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED فراخوانی کنید.

مثال زیر نشان می‌دهد که می‌خواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» (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) طراحی شده است. ممکن است تعهدات قانونی دیگری تحت «مقررات عمومی حفاظت از داده‌ها» داشته باشید. راهنمای اتحادیه اروپا را مرور کنید و با مشاور حقوقی خودتان مشورت کنید. ابزارهای Google برای تسهیل رعایت مقررات طراحی شده‌اند و هیچ ناشر خاصی را از تعهداتش طبق قانون معاف نمی‌کنند. درباره نحوه تأثیر «مقررات کلی حفاظت از داده» بر ناشران بیشتر بدانید.

هنگام استفاده از این ویژگی، پارامتر «برچسب برای کاربران زیر سن قانونی در اروپا» (TFUA) در درخواست آگهی گنجانده می‌شود. این پارامتر تبلیغات شخصی‌سازی‌شده، ازجمله بازاریابی مجدد، را برای همه درخواست‌های آگهی غیرفعال می‌کند. همچنین درخواست‌ها به فروشندگان آگهی طرف سوم، مانند پیکسل‌های سنجش آگهی و سرورهای آگهی طرف سوم را غیرفعال می‌کند.

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

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

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

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

درباره تنظیم حداکثر رده‌بندی محتوا برای هر درخواست آگهی بیشتر بدانید.

Publisher Privacy Treatment (Beta)

‫ Publisher Privacy Treatment (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 اطلاعات هدف‌یابی را برای ارسال با درخواست آگهی جمع‌آوری می‌کند.

افزودن موارد اضافی شبکه

موارد اضافی شبکه جزئیات اضافه‌ای هستند که با درخواست آگهی ارسال می‌شوند و مختص یک منبع آگهی هستند.

تکه‌کد زیر یک کلید پارامتر اضافی collapsible با مقدار bottom برای Google تنظیم می‌کند:

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

هدف‌یابی سفارشی

می‌توانید جفت‌های کلید-مقدار سفارشی را برای هدف‌یابی کمپین‌های «مدیر آگهی Google» (ردیف‌های آگهی) ارسال کنید. نمونه زیر یک جفت کلید-مقدار سفارشی را در درخواست آگهی ارسال می‌کند:

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

می‌توانید چند مقدار را برای یک کلید به‌عنوان فهرستی از رشته‌ها ارسال کنید. برای مثال، برای هدف‌یابی افراد در اواسط دهه بیست سالگی به‌جای فقط افراد ۲۵ ساله.

.putCustomTargeting("age", listOf("24", "25", "26"))

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

دسته انحصاری

بااستفاده از روش addCategoryExclusion() می‌توانید سطح استثنای دسته در سطح جایگاه را به درخواست اضافه کنید:

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

نمونه «استثناهای دسته Ad Manager» را برای پیاده‌سازی استثناهای دسته در برنامه Android API Demo بررسی کنید.

شناسه‌های ارائه‌شده از ناشر

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

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

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

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

نمونه PPID در Ad Manager را برای پیاده‌سازی شناسه‌های ارائه‌شده توسط ناشر (PPID) در برنامه نمایشی Android API بررسی کنید.

نشان‌های ناشرداده

می‌توانید داده‌های زمینه‌ای و مخاطب را به‌عنوان نشان‌های ناشرداده (PPS) در درخواست‌های آگهی ارسال کنید. با «سیگنال‌های ارائه‌شده توسط ناشر»، می‌توانید از داده‌های کاربرتان برای بهبود درآمدزایی برنامه‌ای استفاده کنید. این کار با انتقال ویژگی‌های مخاطبانتان به پیشنهاددهندگان در همه انواع تراکنش، بااستفاده از طبقه‌بندی‌های استاندارد، و بدون نیاز به هم‌رسانی شناسه‌های کاربر انجام می‌شود. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه (طبقه‌بندی مخاطب IAB نسخه ۱.۱) و داده‌های زمینه‌ای (طبقه‌بندی محتوای IAB نسخه ۲.۲) باشد.

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("AD_UNIT_ID")
  .setGoogleExtrasBundle(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));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

نشانی وب محتوا

برای ارائه نشانی وب محتوا برای آگهی‌های هدف‌یابی‌شده براساس محتوا و ایمنی نمانام، موارد زیر را اضافه کنید:

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

ایمنی نمانام (نسخه بتا)

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

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .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");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() با .setContentUrl() تفاوت دارد زیرا فقط برای ایمنی نمانام استفاده می‌شود.