این راهنما توضیح میدهد که چگونه اطلاعات هدفیابی را به کیت توسعه نرمافزار تبلیغات تلفن همراه 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 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 =
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);درباره تنظیم کردن حداکثر ردهبندی محتوا برای هر درخواست آگهی بیشتر بدانید.
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)جاوا
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();نمونه «استثناهای دسته Ad Manager» را برای پیادهسازی استثناهای دسته در برنامه Android API Demo بررسی کنید.
شناسههای ارائهشده از ناشر
میتوانید شناسه ارائهشده توسط ناشر (PPID) را برای استفاده در حدگذاری تکرار، بخشبندی و هدفیابی مخاطب، چرخش آگهی متوالی، و دیگر کنترلهای ارائه آگهی مبتنی بر مخاطب در دستگاهها تنظیم کنید.
در اینجا نمونهای از تنظیم PPID آورده شده است:
Kotlin
val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()جاوا
AdManagerAdRequest adRequest =
new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();برای پیادهسازی شناسههای ارائهشده توسط ناشر (PPID) در برنامه نمایشی Android API، نمونه PPID در Ad Manager را بررسی کنید.
نشانهای ناشرداده
میتوانید دادههای زمینهای و مخاطب را بهعنوان نشانهای ناشرداده (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() تفاوت دارد زیرا فقط برای ایمنی نمانام استفاده میشود.