هدف گیری

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

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

تنظیمات مختص کودکان

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

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

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

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

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 تفاوت دارد زیرا فقط برای ایمنی نمانام استفاده می‌شود.