هدف گذاری

این راهنما نحوه ارائه اطلاعات هدفمندی به Google Mobile Ads SDK را توضیح می‌دهد.

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

دانلود نسخه نمایشی API

پیش نیاز

RequestConfiguration

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

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

کاتلین 

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

برای اطمینان از اینکه همه درخواست‌های تبلیغات تغییرات پیکربندی درخواست را اعمال می‌کنند، پیکربندی درخواست را قبل از اینکه SDK تبلیغات تلفن همراه را راه‌اندازی کنید، تنظیم کنید.

تنظیم به کارگردانی کودک

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

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

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

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

  • با TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE با setTagForChildDirectedTreatment تماس بگیرید تا نشان دهید که نمی‌خواهید محتوای شما برای اهداف COPPA به‌عنوان کارگردانی کودک در نظر گرفته شود.

  • اگر نمی‌خواهید در درخواست‌های تبلیغاتی نشان دهید که با توجه به COPPA با محتوای شما چگونه رفتار می‌شود، با TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED setTagForChildDirectedTreatment را تماس بگیرید.

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

کاتلین 

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

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

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

  • setTagForUnderAgeOfConsent() با TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE فراخوانی کنید تا نشان دهید که می‌خواهید درخواست آگهی برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (EEA) درمان شود. این همچنین از انتقال شناسه تبلیغاتی اندروید (AAID) جلوگیری می کند.

  • با TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE setTagForUnderAgeOfConsent() فراخوانی کنید تا نشان دهید که می‌خواهید درخواست تبلیغ برای کاربران زیر سن رضایت در منطقه اقتصادی اروپا (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)

جاوا 

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

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

کاتلین 

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

درباره تنظیم حداکثر رتبه بندی محتوا برای هر درخواست آگهی بیشتر بیاموزید.

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

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

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

کاتلین 

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

جاوا 

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

درخواست آگهی

شی AdManagerAdRequest اطلاعات هدف را جمع آوری می کند تا با درخواست تبلیغ ارسال شود.

هدف گذاری سفارشی

می‌توانید از طریق AdManagerAdRequest.Builder.addCustomTargeting() جفت‌های کلید-مقدار سفارشی را برای هدف قرار دادن کمپین‌های Google Ad Manager (موارد خط) ارسال کنید:

کاتلین 

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

می توانید چندین مقدار را برای یک کلید به عنوان لیست رشته ها ارسال کنید. به عنوان مثال، هدف قرار دادن افراد در اواسط بیست سالگی به جای افراد 25 ساله. 

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

مثال Ad Manager Custom Targeting را برای پیاده سازی هدف گذاری سفارشی در برنامه نمایشی Android API بررسی کنید.

استثناهای دسته بندی

با استفاده از متد addCategoryExclusion() که توسط AdManagerAdRequest.Builder ارائه شده است، می‌توانید سطح محرومیت دسته‌بندی در سطح اسلات را به درخواست اضافه کنید:

کاتلین 

// 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، مثال Exclusions Category Ad Manager را بررسی کنید.

ناشر شناسه هایی را ارائه کرد

می‌توانید شناسه ارائه‌شده ناشر (PPID) را برای استفاده در محدودیت‌های فرکانس، تقسیم‌بندی و هدف‌یابی مخاطب، چرخش متوالی آگهی و سایر کنترل‌های تحویل آگهی مبتنی بر مخاطب در دستگاه‌ها تنظیم کنید.

در اینجا مثالی از تنظیم PPID آورده شده است:

کاتلین 

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

جاوا 

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

مثال Ad Manager PPID را برای پیاده سازی شناسه های ارائه شده ناشر (PPID) در برنامه آزمایشی API Android بررسی کنید.

ناشر سیگنال هایی را ارائه کرد

می‌توانید مخاطبان و داده‌های متنی را به‌عنوان سیگنال‌های ارائه‌شده ناشر (PPS) در درخواست‌های آگهی ارسال کنید. با PPS، می‌توانید از داده‌های کاربر خود برای بهبود درآمدزایی برنامه‌ای با برقراری ارتباط با ویژگی‌های مخاطبان خود به پیشنهاد دهندگان در همه انواع تراکنش ، با استفاده از طبقه‌بندی استاندارد، بدون نیاز به اشتراک‌گذاری شناسه‌های کاربر، استفاده کنید. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه ( IAB Audience Taxonomy 1.1 ) و داده‌های متنی ( IAB Content Taxonomy 2.2 ) باشد.

کاتلین 

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 = AdRequest.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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

URL محتوا

برای ارائه یک URL محتوا برای تبلیغات هدفمند محتوا و ایمنی برند، می‌توانید هنگام ایجاد AdManagerAdRequest setContentUrl() تماس بگیرید:

کاتلین 

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

ایمنی برند (بتا)

برنامه‌هایی که محتوای پویا را برای مخاطبان مختلف نمایش می‌دهند، می‌توانند با استفاده از متد setNeighboringContentUrls() فهرست کوتاهی از URLها را هنگام ساخت AdManagerAdRequest ارائه دهند:

کاتلین 

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

جاوا 

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() با .setContentUrl() متفاوت است زیرا فقط برای ایمنی نام تجاری استفاده می شود.