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

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

هدف گذاری

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

این راهنما نحوه ارائه اطلاعات هدف‌گذاری به SDK تبلیغات موبایلی گوگل را توضیح می‌دهد.

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

دانلود نسخه آزمایشی API پیش‌نیاز

قبل از ادامه، Google Mobile Ads SDK (Legacy) راه‌اندازی کنید .

درخواست پیکربندی

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

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

کاتلین

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() در API مربوط به RequestConfiguration.Builder ، نسبت سنی را تنظیم کنید.

مثال زیر نشان می‌دهد که درخواست‌های تبلیغ باید با توجه به سن کودک تنظیم شوند:

کاتلین

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`	درمان سن
`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 را تنظیم کنید، گوگل محافظه‌کارانه‌ترین روش را اعمال می‌کند.

درمان سنی را با میانجیگری AdMob به جلو ببرید

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

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

نام آداپتور میانجیگری	حداقل نسخه پشتیبانی شده
اپ‌لوین	۱۳.۶.۳.۰
بیدماشین	۳.۷.۱.۱
بیگو	۵.۹.۰.۱
چارتبوست	۹.۱۲.۱.۱
دی‌تی‌اکسچنج (فایبر)	۸.۴.۵.۱
آی-موبایل	۲.۳.۲.۴
این‌موبی	۱۱.۳.۰.۱
آیرون سورس	۹.۴.۳.۰
کسب درآمد از لیفت‌آف (Vungle)	۷.۷.۴.۲
LY (خط)	۳.۱.۱.۱
مایو	۲.۰.۹.۰
متا (فیس‌بوک)	۶.۲۱.۰.۴
انتگرال مینت	۱۷.۱.۶۱.۱
مولوکو	۴.۱۰.۰.۰
مای تارگت	۵.۴۷.۱.۱
پنگل	۸.۱.۰.۳.۱
پاب‌ماتیک	۵.۱.۲.۲
شور و شوق	۳.۹.۰.۰

محیط کودک محور

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

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

شما می‌توانید تنظیمات مربوط به فرزند را از طریق setTagForChildDirectedTreatment() اعمال کنید:

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

مثال زیر نشان می‌دهد که شما می‌خواهید محتوای شما برای اهداف COPPA به عنوان محتوای فرزند-محور در نظر گرفته شود:

کاتلین

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

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

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

تابع setTagForUnderAgeOfConsent() به همراه TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE فراخوانی کنید تا نشان دهید که می‌خواهید درخواست تبلیغ برای کاربرانی که در منطقه اقتصادی اروپا (EEA) و زیر سن قانونی هستند، قابل قبول باشد. این کار همچنین از انتقال شناسه تبلیغاتی اندروید (AAID) جلوگیری می‌کند.
تابع setTagForUnderAgeOfConsent() با TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE فراخوانی کنید تا نشان دهید که می‌خواهید درخواست تبلیغ، برای کاربرانی که در منطقه اقتصادی اروپا (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)RequestConfigurationSnippets.kt

جاوا

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

تگ‌های فعال‌سازی تنظیمات Child-directed و setTagForUnderAgeOfConsent() نباید همزمان روی true تنظیم شوند. در این صورت، تنظیمات Child-directed اولویت دارد.

فیلتر کردن محتوای تبلیغات

برای رعایت سیاست تبلیغات نامناسب گوگل پلی که شامل پیشنهادهای مرتبط در یک تبلیغ می‌شود، تمام تبلیغات و پیشنهادهای مرتبط با آنها که در برنامه شما نمایش داده می‌شوند، باید برای رتبه‌بندی محتوای برنامه شما مناسب باشند، حتی اگر خود محتوا با سیاست‌های گوگل پلی مطابقت داشته باشد.

ابزارهایی مانند حداکثر امتیاز محتوای تبلیغات می‌توانند به شما کمک کنند تا کنترل بیشتری بر محتوای تبلیغاتی که به کاربرانتان نشان داده می‌شود، داشته باشید. می‌توانید حداکثر امتیاز محتوا را برای کمک به رعایت سیاست‌های پلتفرم تنظیم کنید.

برنامه‌ها می‌توانند با استفاده از متد 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)RequestConfigurationSnippets.kt

جاوا

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

اطلاعات بیشتر در مورد:

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

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

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

کاتلین

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 تنظیم می‌کند:

کاتلین

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

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

هدف گذاری