هدف گیری


این راهنما توضیح می‌دهد که چگونه اطلاعات هدف‌یابی را به درخواست آگهی ارائه دهید.

پیش‌نیازها

RequestConfiguration

‫RequestConfiguration ساختاری است که اطلاعات هدف‌یابی را جمع‌آوری می‌کند تا به‌طور سراسری ازطریق تابع سراسری SetRequestConfiguration() اعمال شود.

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

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

به‌عنوان توسعه‌دهنده نرم‌افزار، می‌توانید هنگام درخواست آگهی مشخص کنید که آیا می‌خواهید Google محتوایتان را به‌عنوان محتوای مختص کودکان درنظر بگیرد یا نه. اگر مشخص کنید که می‌خواهید Google با محتوای شما به‌عنوان محتوای مختص کودکان رفتار کند، اقداماتی را برای غیرفعال کردن تبلیغات IBA و بازاریابی مجدد در آن درخواست آگهی انجام می‌دهیم.

این تنظیم را می‌توان با اختصاص دادن عضو tag_for_child_directed_treatment از ساختار RequestConfiguration به یکی از مقادیر شمارشی زیر پیکربندی کرد:

  • RequestConfiguration::tag_for_child_directed_treatment را به RequestConfiguration::kChildDirectedTreatmentTrue اختصاص دهید تا نشان دهید که می‌خواهید محتوایتان برای اهداف «قانون محافظت از حریم خصوصی آنلاین کودکان» به‌عنوان محتوای ویژه کودکان درنظر گرفته شود.
  • RequestConfiguration::tag_for_child_directed_treatment را به RequestConfiguration::kChildDirectedTreatmentFalse اختصاص دهید تا نشان دهید که نمی‌خواهید محتوایتان برای اهداف COPPA به‌عنوان محتوای ویژه کودکان درنظر گرفته شود.
  • اگر نمی‌خواهید نحوه برخورد با محتوایتان را ازنظر COPPA در درخواست‌های آگهی مشخص کنید، RequestConfiguration::tag_for_child_directed_treatment را به RequestConfiguration::kChildDirectedTreatmentUnspecified اختصاص دهید.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

با تنظیم این برچسب، گواهی می‌کنید که این اعلان صحیح است و شما مجاز هستید ازطرف مالک برنامه اقدام کنید. شما می‌دانید که سوءاستفاده از این تنظیم ممکن است منجر به بسته شدن حساب Google شما شود.

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

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

مانند تنظیمات مختص کودکان، عضوی در RequestConfiguration برای پیکربندی پارامتر TFUA وجود دارد: tag_for_under_age_of_consent، که ممکن است با مقادیر شمارشی زیر پیکربندی شود:

  • RequestConfiguration::tag_for_under_age_of_consent را به RequestConfiguration::kUnderAgeOfConsentTrue اختصاص دهید تا نشان دهید می‌خواهید درخواست آگهی برای کاربران ساکن منطقه اقتصادی اروپا (EEA) که زیر سن رضایت هستند، رفتار مناسب دریافت کند.
  • RequestConfiguration::tag_for_under_age_of_consent را به RequestConfiguration::kUnderAgeOfConsentFalse اختصاص دهید تا نشان دهید که می‌خواهید درخواست آگهی برای کاربران ساکن منطقه اقتصادی اروپا (EEA) که زیر سن قانونی هستند، رفتار خاصی دریافت نکند.
  • RequestConfiguration::tag_for_under_age_of_consent را به RequestConfiguration::kUnderAgeOfConsentUnspecified اختصاص دهید تا نشان دهید مشخص نکرده‌اید که آیا درخواست آگهی باید برای کاربران در «منطقه اقتصادی اروپا» (EEA) که زیر سن قانونی هستند، رفتار خاصی دریافت کند یا نه.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

برچسب‌های فعال کردن تنظیم «مختص کودکان» و «کاربران زیر سن قانونی» نباید به‌طور هم‌زمان روی «درست» تنظیم شوند. اگر این‌طور باشد، تنظیم مختص کودکان اولویت دارد.

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

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

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

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

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

هنگام درخواست آگهی، برنامه‌ها ممکن است نشانی وب محتوایی را که ارائه می‌دهند ارسال کنند. این کار هدف‌یابی کلیدواژه را فعال می‌کند تا آگهی با محتوا مطابقت داده شود.

برای مثال، اگر برنامه‌تان درحال درخواست آگهی است و هم‌زمان محتوایی از https://www.example.com نشان می‌دهد، می‌توانید این نشانی وب را برای هدف‌یابی کلیدواژه‌های مرتبط ارسال کنید:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();