هدف گیری

هدف‌یابی به شما امکان می‌دهد اطلاعات بافتی و مخاطب را به Google Mobile Ads SDK for React Native ارائه دهید تا آگهی‌های مرتبط به کاربران شما ارائه شود.

می‌توانید هدف‌یابی را در این سطوح پیکربندی کنید:

  • پیکربندی درخواست سراسری: تنظیمات را در همه درخواست‌های آگهی در برنامه‌تان اعمال کنید، ازجمله رفتار با کودکان و نوجوانان، حداکثر رده‌بندی محتوای آگهی، رفتار با حریم خصوصی ناشر، و شناسه‌های دستگاه آزمایشی.
  • هدف‌یابی براساس درخواست: درخواست‌های آگهی تکی را بااستفاده از اشیای درخواست آگهی، ازجمله نشانی‌های وب محتوا و موارد اضافی شبکه، سفارشی‌سازی کنید.

این راهنما توضیح می‌دهد که چگونه اطلاعات هدف‌یابی را به Google Mobile Ads SDK for React Native ارائه دهید.

پیش‌نیازها

پیش‌از ادامه دادن، Google Mobile Ads SDK for React Native را راه‌اندازی کنید.

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

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

برای اعمال تنظیمات هدف‌یابی از اولین درخواست آگهی، هنگام فراخوانی روش initialize، ویژگی requestConfiguration را تنظیم کنید:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

TEST_DEVICE_HASHED_ID را با شناسه دستگاه آزمایشی درهم‌سازی‌شده جایگزین کنید. این شناسه دستگاهی را مشخص می‌کند که باید آگهی‌های آزمایشی را دریافت کند.

برای به‌روزرسانی تنظیمات هدف‌یابی پس‌از مقداردهی اولیه Google Mobile Ads SDK for React Native، روش setRequestConfiguration را فراخوانی کنید. روش setRequestConfiguration جایگزین پیکربندی موجود می‌شود و در درخواست‌های آگهی بعدی اعمال می‌شود.

مثال زیر یک شیء RequestConfiguration را با تنظیمات هدف‌یابی به‌روزشده بازبینی می‌کند و تنظیمات را برای درخواست‌های آگهی اعمال می‌کند:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

تنظیم رفتار با سن

برای کمک به شما در مدیریت رعایت مقررات حریم خصوصی مربوط به کودکان و نوجوانان، Google Mobile Ads SDK for React Native تنظیمات رفتار با سن را ارائه می‌دهد. تنظیم رفتار با سن به شما امکان می‌دهد مشخص کنید که آیا Google Mobile Ads SDK for React Native باید محافظت‌های خاصی را برای ارائه آگهی به کودکان، نوجوانان، یا سن نامشخص اعمال کند یا نه.

می‌توانید با ویژگی ageRestrictedTreatment در RequestConfiguration، رفتار با سن را تنظیم کنید.

مثال زیر نشان می‌دهد که درخواست‌های آگهی باید با رفتار مناسب برای سن کودکان دریافت شود:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

برای نشان دادن رفتار با نوجوان یا سن نامشخص، تنظیم AgeRestrictedTreatment.CHILD را با موارد زیر جایگزین کنید:

وقتی از این تنظیم استفاده می‌کنید، Google Mobile Ads SDK for React Native پارامتر tfat را در درخواست‌های آگهی لحاظ می‌کند. با مشاور حقوقی‌تان مشورت کنید تا براساس تعهدات قانونی و نظارتی‌تان، نحوه برخورد با سن ذی‌ربط را برای کاربرانتان تعیین کنید. برای اطلاعات بیشتر، به برچسب‌گذاری درخواست آگهی از برنامه برای رفتار دارای محدودیت سنی مراجعه کنید.

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

رده‌بندی بیشینه محتوای آگهی به شما امکان می‌دهد محتوای آگهی‌های نشان‌داده‌شده به کاربرانتان را کنترل کنید. می‌توانید حداکثر رده‌بندی محتوا را تنظیم کنید تا به رعایت خط‌مشی‌های پلاتفرم کمک کنید.

می‌توانید بااستفاده از ویژگی maxAdContentRating در شیء RequestConfiguration، حداکثر رده‌بندی محتوای آگهی را برای درخواست‌های آگهی در برنامه‌تان تنظیم کنید. پس‌از پیکربندی این تنظیم، آگهی‌های برگشتی دارای رده‌بندی محتوای برابر یا پایین‌تر از آن رده‌بندی هستند. مقادیر ممکن برای این تنظیم براساس طبقه‌بندی‌های برچسب محتوای دیجیتال است، و باید یکی از ثابت‌های زیر باشد:

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

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

برای جزئیات، موارد زیر را ببینید:

اختیاری: تنظیم PPT API (نسخه بتا)

‫Publisher Privacy Treatment (PPT) API به شما امکان می‌دهد مشخص کنید که آیا شخصی‌سازی آگهی برای همه درخواست‌های آگهی بااستفاده از ویژگی publisherPrivacyPersonalizationState در شیء RequestConfiguration خاموش شود یا نه. وقتی از این ویژگی استفاده می‌کنید، Google Mobile Ads SDK for React Native پارامتر «رفتار حریم خصوصی ناشر» (PPT) را در همه درخواست‌های آگهی برای باقی‌مانده جلسه لحاظ می‌کند.

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

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

تنظیم کردن شیء AdRequest

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

برخلاف پیکربندی سراسری که با روش setRequestConfiguration تنظیم می‌شود، شیء AdRequest به روش load کلاس قالب آگهی ارسال می‌شود، برای مثال، InterstitialAd.load برای آگهی‌های بینابینی یا BannerAd.load برای آگهی‌های برنمایی.

افزودن موارد اضافی شبکه

برای ارسال پارامترهای خاص شبکه به Google Mobile Ads SDK for React Native، مانند پارامترهای آگهی‌های جمع‌شدنی، از ویژگی extras استفاده کنید.

مثال زیر کلید پارامتر اضافی collapsible را با مقدار bottom تنظیم می‌کند:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

نشانی وب محتوا را ارائه دهید

برای ارائه نشانی وب محتوا برای آگهی‌های هدف‌یابی‌شده براساس محتوا و ایمنی نمانام، ویژگی contentUrl را اضافه کنید:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

نشانی وب محتوا باید حداکثر ۵۱۲ نویسه داشته باشد.