هدف گیری

انتخاب پلاتفرم: Android iOS Unity Flutter Android (قدیمی)

هدف RequestConfiguration پیکربندی سراسری را برای هر درخواست آگهی جمع‌آوری می‌کند و توسط MobileAds.instance.updateRequestConfiguration() اعمال می‌شود.

برای اطمینان از اینکه همه درخواست‌های آگهی تغییرات پیکربندی درخواست را اعمال می‌کنند، قبل‌از مقداردهی اولیه Google Mobile Ads Flutter Plugin، پیکربندی درخواست را به‌روز کنید.

تنظیم کودک‌محور

برای اهداف قانون محافظت از حریم خصوصی آنلاین کودکان (COPPA)، تنظیمی به نام «برچسب‌گذاری برای رفتار کودک‌محور» وجود دارد.

به‌عنوان توسعه‌دهنده برنامه، می‌توانید هنگام درخواست آگهی مشخص کنید که آیا می‌خواهید Google محتوای شما را به‌عنوان محتوای کودک‌محور درنظر بگیرد یا نه. اگر نشان دهید که می‌خواهید Google محتوایتان را به‌عنوان محتوای کودک‌پسند درنظر بگیرد، ما اقداماتی برای غیرفعال کردن آگهی‌های «براساس علاقه» و بازاریابی مجدد در آن درخواست آگهی انجام می‌دهیم. این تنظیم را می‌توان با همه نسخه‌های «کیت توسعه نرم‌افزار خدمات Google Play» تا RequestConfiguration.tagForChildDirectedTreatment() استفاده کرد:

  • از آرگومان TagForChildDirectedTreatment.yes برای نشان دادن اینکه می‌خواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای ویژه کودکان درنظر گرفته شود استفاده کنید.
  • از آرگومان TagForChildDirectedTreatment.no استفاده کنید تا نشان دهید که نمی‌خواهید محتوای شما برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای ویژه کودکان درنظر گرفته شود.
  • اگر نمی‌خواهید مشخص کنید که محتوایتان درخصوص «قانون محافظت از حریم خصوصی آنلاین کودکان» چگونه در درخواست‌های آگهی مدیریت شود، از آرگومان TagForChildDirectedTreatment.unspecified استفاده کنید یا این برچسب را تنظیم نکنید.

مثال زیر نشان می‌دهد که می‌خواهید محتوای شما برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان کودک‌محور درنظر گرفته شود:

final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

می‌توانید درخواست‌های آگهی‌تان را علامت‌گذاری کنید تا برای کاربران ساکن «منطقه اقتصادی اروپا» (EEA) که زیر سن رضایت هستند، پردازش شوند. این ویژگی برای کمک به تسهیل کردن پیروی از مقررات کلی حفاظت از داده (GDPR) طراحی شده است. توجه داشته باشید که ممکن است تحت «مقررات عمومی حفاظت از داده‌ها» تعهدات قانونی دیگری داشته باشید. لطفاً راهنمایی‌های اتحادیه اروپا را مرور کنید و با مشاور حقوقی خود مشورت کنید. لطفاً به‌یاد داشته باشید که ابزارهای Google برای تسهیل کردن رعایت استانداردها طراحی شده‌اند و ناشران را از تعهداتشان تحت قانون معاف نمی‌کنند. درباره نحوه تأثیر «مقررات کلی حفاظت از داده» بر ناشران بیشتر بدانید.

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

برچسب بااستفاده از RequestConfiguration.tagForUnderAgeOfConsent() تنظیم شده است:

  • از آرگومان TagForUnderAgeOfConsent.yes استفاده کنید تا نشان دهید می‌خواهید پیکربندی درخواست به روشی مناسب برای کاربران زیر سن رضایت رسیدگی شود.
  • از آرگومان TagForUnderAgeOfConsent.no استفاده کنید تا نشان دهید نمی‌خواهید پیکربندی درخواست به روشی مناسب برای کاربران زیر سن قانونی انجام شود.

  • از آرگومان TagForUnderAgeOfConsent.unspecified استفاده کنید یا این برچسب را تنظیم نکنید تا نشان دهید مشخص نکرده‌اید که آیا درخواست آگهی باید برای کاربران زیر سن قانونی در «منطقه اقتصادی اروپا» (EEA) تحت درمان قرار گیرد یا نه. مثال زیر نشان می‌دهد که می‌خواهید TFUA در درخواست آگهی‌تان گنجانده شود:

    final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForUnderAgeOfConsent: TagForUnderAgeOfConsent.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

برچسب‌های فعال‌سازی تنظیم «محتوای کودک‌پسند» و setTagForUnderAgeOfConsent نباید به‌طور هم‌زمان روی true تنظیم شوند. اگر این‌طور باشد، تنظیم «ویژه کودکان» اولویت دارد.

فیلتر کردن محتوای آگهی

رده‌بندی‌های محتوای آگهی را می‌توان بااستفاده از RequestConfiguration.maxAdContentRating() تنظیم کرد:

آگهی‌های AdMob برگشتی برای این درخواست‌ها دارای رده‌بندی محتوایی در سطح یا پایین‌تر از آن هستند. مقادیر ممکن برای این افزونه شبکه براساس طبقه‌بندی‌های برچسب محتوای دیجیتال است و می‌تواند یکی از MaxAdContentRating شیء زیر باشد:

  • MaxAdContentRating.g
  • MaxAdContentRating.pg
  • MaxAdContentRating.t
  • MaxAdContentRating.ma

پیکربندی کد زیر یک شیء RequestConfiguration را پیکربندی می‌کند تا مشخص کند که محتوای آگهی برگشتی با یک نامگذاری برچسب محتوای دیجیتال که بالاتر از G نیست مطابقت داشته باشد:

final RequestConfiguration requestConfiguration = RequestConfiguration(
  maxAdContentRating: MaxAdContentRating.g);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

درخواست آگهی

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

هدف‌یابی سفارشی

می‌توانید جفت‌های مقدار-کلید سفارشی را برای هدف‌یابی پویش‌های «مدیر آگهی Google» (مورد خط) ارسال کنید:

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = AdManagerAdRequest(
  customTargeting: {'age': '25'},
);

شناسه‌های ناشرداده

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

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

AdManagerAdRequest adRequest = AdManagerAdRequest(
  publisherProvidedId: 'AB123456789',
);

نشانی وب محتوا

برای ارائه نشانی وب محتوا برای آگهی‌های هدف‌یابی محتوا و ایمنی نمانام، می‌توانید هنگام ساختن AdManagerAdRequest، contentUrl را بگذرانید:

AdManagerAdRequest request = AdManagerAdRequest(
  contentUrl: 'https://www.example.com',
);

ایمنی نمانام

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

final neighboringContentUrls = [
  'https://www.mycontenturl1.com',
  'https://www.mycontenturl2.com',
  'https://www.mycontenturl3.com',
  'https://www.mycontenturl4.com',
];
AdManagerAdRequest request = AdManagerAdRequest(
    neighboringContentUrls: neighboringContentUrls,
  );

‫neighboringContentUrls با contentUrl تفاوت دارد زیرا فقط برای ایمنی نمانام استفاده می‌شود.