هدف گذاری

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

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

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

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

پیش‌نیاز

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

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

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

کاتلین 

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

جاوا 

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

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

برای اهداف قانون حفاظت از حریم خصوصی آنلاین کودکان (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 =
  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