هدف گذاری

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

پیش‌نیاز

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

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

با استفاده از سازنده‌ی RequestConfiguration، یک شیء RequestConfiguration با تگ‌های هدف‌گیری مورد نیاز خود ایجاد کنید، سپس با فراخوانی MobileAds.setRequestConfiguration() پیکربندی را تنظیم کنید.

کاتلین 

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

برای اعمال تگ‌های هدف‌گیری از اولین درخواست تبلیغ، پیکربندی درخواست را در هنگام مقداردهی اولیه SDK ارائه دهید:

کاتلین 

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

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

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

به عنوان یک توسعه‌دهنده برنامه، می‌توانید هنگام ارسال درخواست تبلیغ، مشخص کنید که آیا می‌خواهید گوگل محتوای شما را به عنوان محتوای کودک محور در نظر بگیرد یا خیر. اگر مشخص کنید که می‌خواهید گوگل محتوای شما را به عنوان محتوای کودک محور در نظر بگیرد، ما اقداماتی را برای غیرفعال کردن تبلیغات مبتنی بر تعامل (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 = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

شما می‌توانید درخواست‌های تبلیغاتی خود را برای دریافت خدمات درمانی برای کاربران در منطقه اقتصادی اروپا (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 = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

تگ‌هایی که تنظیمات 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 = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

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

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

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

کاتلین 

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جاوا 

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

درخواست تبلیغ

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

اضافه کردن امکانات شبکه

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

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

کاتلین 

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

جاوا 

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);