این راهنما توضیح میدهد که چگونه اطلاعات هدفیابی را به «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» ارائه دهید.
برای دیدن نمونه کاری، برنامه Android API Demo را بارگیری کنید.پیشنیاز
پیشاز ادامه دادن، Google Mobile Ads SDK (Legacy) را راهاندازی کنید.
RequestConfiguration
RequestConfiguration
اطلاعات هدفیابی را که بهصورت جهانی بر هر درخواست آگهی اعمال میشود جمعآوری میکند. برای
برچسبهای هدفیابی دردسترس، به
RequestConfiguration.Builder
اسناد مراجعه کنید.
برای بهروزرسانی پیکربندی درخواست، سازندهای از پیکربندی موجود دریافت کنید، بهروزرسانیهای انتخابشده را انجام دهید، و آن را بهصورت زیر تنظیم کنید:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)جاوا
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);برای اطمینان از اینکه همه درخواستهای آگهی تغییرات پیکربندی درخواست را اعمال میکنند، پیکربندی درخواست را قبلاز مقداردهی اولیه 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)جاوا
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);برای نشان دادن درمان نوجوانان یا درمان برای گروه سنی نامشخص، تنظیم CHILD را
با موارد زیر جایگزین کنید:
TEENUNSPECIFIED
هنگام استفاده از این تنظیم، 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 محافظهکارانهترین رفتار را اعمال میکند.
پردازش سن با میانجیگری
اگر پردازش سنی را بااستفاده از 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 (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تماس بگیرید و اعلام کنید که میخواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» بهعنوان محتوای ویژه کودکان درنظر گرفته شود. این کار از انتقال شناسه تبلیغاتی Android (AAID) جلوگیری میکند.با
setTagForChildDirectedTreatmentباTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEتماس بگیرید تا اعلام کنید که نمیخواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» بهعنوان محتوای معطوف به کودکان درنظر گرفته شود.اگر نمیخواهید مشخص کنید که محتوایتان ازنظر «قانون محافظت از حریم خصوصی آنلاین کودکان» چگونه در درخواستهای آگهی مدیریت شود، با
setTagForChildDirectedTreatmentTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDتماس بگیرید.
مثال زیر نشان میدهد که میخواهید محتوای شما برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» بهعنوان کودکمحور درنظر گرفته شود:
Kotlin
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) طراحی شده است. ممکن است تحت «مقررات عمومی حفاظت از دادهها» تعهدات قانونی دیگری داشته باشید. راهنماییهای اتحادیه اروپا را مرور کنید و با مشاور حقوقی خود مشورت کنید. ابزارهای 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)جاوا
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);برچسبهای فعالسازی تنظیم «هدایتشده برای کودکان»
و setTagForUnderAgeOfConsent() نباید بهطور همزمان روی
true تنظیم شوند. اگر اینگونه باشد، تنظیم «محتوای کودکپسند» اولویت دارد.
فیلتر کردن محتوای آگهی
برای رعایت خطمشی آگهیهای نامناسب Google Play که شامل پیشنهادهای ویژه مرتبط در آگهی میشود، همه آگهیها و پیشنهادهای ویژه مرتبط با آنها که در برنامه شما نشان داده میشود باید برای ردهبندی محتوای برنامه شما مناسب باشد، حتی اگر محتوا بهخودیخود با خطمشیهای Google Play مطابقت داشته باشد.
ابزارهایی مثل ردهبندی حداکثر محتوای آگهی میتواند به شما کمک کند کنترل بیشتری بر محتوای آگهیهایی که به کاربران شما نشان داده میشود داشته باشید. میتوانید حداکثر ردهبندی محتوا را تنظیم کنید تا به رعایت خطمشیهای پلاتفرم کمک کند.
برنامهها میتوانند بااستفاده از روش
setMaxAdContentRating
، حداکثر ردهبندی محتوای آگهی را برای درخواستهای آگهی خود تنظیم کنند. وقتی این تنظیم پیکربندی میشود، آگهیهای AdMob برگشتی دارای ردهبندی محتوایی در سطح یا پایینتر از آن سطح هستند. مقادیر ممکن برای این شبکه اضافی براساس
طبقهبندیهای برچسب محتوای دیجیتال است و باید یکی از رشتههای زیر باشد:
MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
کد زیر یک شیء RequestConfiguration را پیکربندی میکند تا مشخص کند
محتوای آگهی برگشتی باید با یک نامگذاری برچسب محتوای دیجیتال که
بالاتر از G نیست مطابقت داشته باشد:
Kotlin
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);درباره تنظیم حداکثر ردهبندی محتوا برای هر درخواست آگهی بیشتر بدانید.
پردازش حریم خصوصی ناشر (نسخه بتا)
میانای برنامهسازی کاربردی
پردازش حریم خصوصی ناشر
(PPT) ابزاری اختیاری است که به برنامهها امکان میدهد مشخص کنند که آیا شخصیسازی آگهیها را برای همه درخواستهای آگهی بااستفاده از روش
setPublisherPrivacyPersonalizationState()
خاموش کنند یا نه. هنگام استفاده از این ویژگی، پارامتر «درمان حریم خصوصی ناشر» (PPT)
در همه درخواستهای آگهی آینده برای باقیمانده جلسه گنجانده میشود.
بهطور پیشفرض، درخواستهای آگهی به Google آگهیهای شخصیسازیشده ارائه میدهد. کد زیر شخصیسازی آگهی را برای همه درخواستهای آگهی خاموش میکند:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)جاوا
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);درخواست آگهی
شیء
AdManagerAdRequest اطلاعات هدفیابی را جمعآوری میکند تا
با درخواست آگهی ارسال شود.
افزودن موارد اضافی شبکه
افزودههای شبکه جزئیات اضافهای هستند که همراه با درخواست آگهی ارسال میشوند و مختص یک منبع آگهی هستند.
تکهکد زیر کلید پارامتر اضافی collapsible را با مقدار bottom برای Google تنظیم میکند:
Kotlin
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)جاوا
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);هدفیابی سفارشی
میتوانید جفتهای مقدار-کلید سفارشی را برای هدفیابی پویشهای «مدیر آگهی Google» (مورد خط) ارسال کنید. مثال زیر یک جفت کلید-مقدار سفارشی را در درخواست آگهی ارسال میکند:
Kotlin
// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()جاوا
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();میتوانید چندین مقدار را برای یک کلید بهعنوان فهرستی از رشتهها ارسال کنید. برای مثال، برای هدفیابی افراد در اواسط دهه بیست زندگیشان بهجای فقط افراد ۲۵ ساله.
Kotlin
.addCustomTargeting("age", listOf("24", "25", "26"))جاوا
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))دسته انحصاری
بااستفاده از روش
addCategoryExclusion()
میتوانید سطح استثنای دسته سطح جای آگهی را به درخواست اضافه کنید:
Kotlin
// Example: Exclude "automobile" and "boat" categories.
val newRequest =
AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()جاوا
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();برای پیادهسازی استثناهای دسته در برنامه «نمونه Android API»، به مثال استثناهای دسته Ad Manager نگاهی بیندازید.
شناسههای ناشرداده
میتوانید شناسه ارائهشده توسط ناشر (PPID) را برای استفاده در حدگذاری تکرار آگهی، بخشبندی و هدفیابی مخاطب، چرخش آگهی ترتیبی، و دیگر کنترلهای ارائه آگهی مبتنی بر مخاطب در سراسر دستگاهها تنظیم کنید.
در اینجا نمونهای از تنظیم PPID آورده شده است:
Kotlin
val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()جاوا
AdManagerAdRequest adRequest =
new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();برای پیادهسازی شناسههای ناشرداده (PPID) در برنامه «نمونه Android API»، مثال Ad Manager PPID را بررسی کنید.
نشانهای ناشرداده
میتوانید دادههای مخاطب و زمینهای را بهعنوان نشانهای ناشرداده (PPS) در درخواستهای آگهی ارسال کنید. با «سیستم پیشنهاد قیمت خصوصی»، میتوانید با انتقال ویژگیهای مخاطبانتان به پیشنهاددهندگان قیمت در همه انواع تراکنش، بااستفاده از طبقهبندیهای استاندارد، بدون نیاز به همرسانی شناسههای کاربر، از دادههای کاربرتان برای بهبود درآمدزایی برنامهریزیشده استفاده کنید. ویژگیهای مخاطب شما میتواند شامل دادههای رفتاری و مبتنی بر علاقه (طبقهبندی مخاطب IAB نسخه ۱.۱) و دادههای زمینهای (طبقهبندی محتوای IAB نسخه ۲.۲) باشد.
Kotlin
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 =
AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, 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", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));
AdManagerAdRequest request =
new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();نشانی وب محتوا
برای ارائه نشانی وب محتوا برای آگهیهای هدفیابی محتوا و ایمنی نمانام، موارد زیر را اضافه کنید:
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()جاوا
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();ایمنی نمانام (نسخه بتا)
برنامههایی که محتوای پویای درنظرگرفتهشده برای مخاطبان مختلف را نمایش میدهند میتوانند فهرست کوتاهی از نشانیهای وب ارائه دهند:
Kotlin
val urls =
mutableListOf(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com",
)
val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()جاوا
List<String> urls =
Arrays.asList(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent =
new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();.setNeighboringContentUrls() با .setContentUrl() تفاوت دارد زیرا فقط برای ایمنی نمانام استفاده میشود.