کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA را منتقل و راه‌اندازی کنید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

هدف گیری

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

برای مشاهده نمونه‌ای از نحوه عملکرد، برنامه Android API Demo را بارگیری کنید.

بارگیری نسخه نمایشی API

پیش‌نیاز

پیش‌از ادامه دادن، Google Mobile Ads SDK (Legacy) را راه‌اندازی کنید.

RequestConfiguration

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

برای به‌روزرسانی پیکربندی درخواست، سازنده‌ای را از پیکربندی موجود دریافت کنید، به‌روزرسانی‌های انتخاب‌شده را انجام دهید، و آن را به‌صورت زیر تنظیم کنید:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جاوا

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

برای اطمینان از اینکه همه درخواست‌های آگهی تغییرات پیکربندی درخواست را اعمال می‌کنند، پیکربندی درخواست را قبل‌از مقداردهی اولیه Google Mobile Ads SDK (Legacy) تنظیم کنید.

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

برای کمک به شما در مدیریت رعایت مقررات حریم خصوصی مربوط به کودکان و نوجوانان، Google Mobile Ads SDK (Legacy) تنظیمات رفتار با سن را ارائه می‌دهد. تنظیم رفتار با سن به شما امکان می‌دهد مشخص کنید که آیا Google Mobile Ads SDK (Legacy) باید محافظت‌های خاصی را برای ارائه آگهی به کودکان، نوجوانان، یا سن نامشخص اعمال کند یا نه.

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

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

Kotlin

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

جاوا

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

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

TEEN
UNSPECIFIED

هنگام استفاده از این تنظیم، Google Mobile Ads SDK (Legacy) پارامتر 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

اگر رفتار با سن را بااستفاده از Google Mobile Ads SDK (Legacy) تنظیم کنید، آداپتورهای میانجی سیگنال رفتار با سن را به کیت‌های توسعه نرم‌افزار طرف سوم میانجی‌شده ارسال می‌کنند.

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

نام آداپتور میانجی‌گری	پایین‌ترین نسخه پشتیبانی‌شده
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 محتوایتان را به‌عنوان محتوای مختص کودکان درنظر بگیرد، اقداماتی برای غیرفعال کردن 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) به‌عنوان محتوای مختص کودکان درنظر گرفته شود:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جاوا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

کاربران زیر سن رضایت

می‌توانید درخواست‌های آگهی‌تان را علامت‌گذاری کنید تا برای کاربران ساکن «منطقه اقتصادی اروپا» (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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جاوا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

برچسب‌های فعال کردن تنظیمات مختص کودکان و 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جاوا

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

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

Publisher Privacy Treatment (Beta)

‫ Publisher Privacy Treatment (PPT) API ابزاری اختیاری است که به برنامه‌ها اجازه می‌دهد مشخص کنند آیا شخصی‌سازی آگهی‌ها برای همه درخواست‌های آگهی بااستفاده از روش setPublisherPrivacyPersonalizationState() خاموش شود یا نه. هنگام استفاده از این ویژگی، پارامتر «رفتار حریم خصوصی ناشر» (PPT) در همه درخواست‌های آگهی آینده برای باقی‌مانده جلسه گنجانده می‌شود.

به‌طور پیش‌فرض، درخواست‌های آگهی به Google آگهی‌های شخصی‌سازی‌شده ارائه می‌دهند. کد زیر شخصی‌سازی آگهی را برای همه درخواست‌های آگهی خاموش می‌کند:

Kotlin

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

جاوا

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

درخواست آگهی

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

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

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

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

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)AdRequestSnippets.kt

جاوا

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);AdRequestSnippets.java

هدف گیری با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیش‌نیاز

RequestConfiguration

Kotlin

جاوا

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

Kotlin

جاوا

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

TFCD

TFUA

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

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

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

Kotlin

جاوا

کاربران زیر سن رضایت

Kotlin

جاوا

فیلتر کردن محتوای آگهی

Kotlin

جاوا

Publisher Privacy Treatment (Beta)

Kotlin

جاوا

درخواست آگهی

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

Kotlin

جاوا

هدف گیری