هدف گیری

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

پیش‌نیاز

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

RequestConfiguration

RequestConfiguration اطلاعات هدف‌یابی را که به‌طور سراسری برای هر درخواست آگهی اعمال می‌شود جمع‌آوری می‌کند. برای برچسب‌های هدف‌یابی دردسترس، به سند RequestConfiguration.Builder مراجعه کنید.

بااستفاده از سازنده شیء، شیء RequestConfiguration را با برچسب‌های هدف‌یابی موردنیازتان ایجاد کنید، سپس با فراخوانی MobileAds.setRequestConfiguration() پیکربندی را تنظیم کنید.

Kotlin

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

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

Kotlin

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 AdMob 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 AdMob 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، رفتار مقتضی با سن را تنظیم کنید.

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

Kotlin

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

جاوا

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

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

  • TEEN
  • UNSPECIFIED

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

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

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

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

TFCD

TFCD درمان پیری
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
مقداری اختصاص داده نشده است .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
بدون معادل AgeRestrictedTreatment.TEEN

TFUA

TFUA درمان پیری
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
مقداری اختصاص داده نشده است .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
بدون معادل AgeRestrictedTreatment.TEEN

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

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

درمان سن پیش‌برنده با واسطه‌گری AdMob

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

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

نام آداپتور میانجی‌گری پایین‌ترین نسخه پشتیبانی‌شده
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize (Vungle) 7.7.4.2
LY (Line) 3.1.1.1
maio 2.0.9.0
Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

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

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

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

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

Kotlin

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 در درخواست‌های آگهی‌تان گنجانده شود:

Kotlin

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 نباشد:

Kotlin

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 آگهی‌های شخصی‌سازی‌شده ارائه می‌دهند. کد زیر شخصی‌سازی آگهی را برای همه درخواست‌های آگهی خاموش می‌کند:

Kotlin

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

جمع‌آوری مکان غیردقیق

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

از نسخه ۱.۷.۰ GMA Next-Gen SDK، جمع‌آوری مکان غیردقیق به‌طور پیش‌فرض فعال است. می‌توانید جمع‌آوری مکان غیردقیق را بااستفاده از روش setCoarseLocationCollectionEnabled() غیرفعال کنید.

مثال زیر جمع‌آوری مکان غیردقیق را غیرفعال می‌کند:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Disable automatic coarse location collection by the SDK.
    .setCoarseLocationCollectionEnabled(false)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جاوا

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Disable automatic coarse location collection by the SDK.
        .setCoarseLocationCollectionEnabled(false)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

درخواست آگهی

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

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

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

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

Kotlin

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