هدف گذاری


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

پیش نیازها

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 اختصاص دهید تا نشان دهید که می‌خواهید محتوای شما برای اهداف COPPA به‌عنوان هدایت‌شده توسط کودک در نظر گرفته شود.
  • RequestConfiguration::tag_for_child_directed_treatment به RequestConfiguration::kChildDirectedTreatmentFalse اختصاص دهید تا نشان دهید که نمی‌خواهید محتوای شما برای اهداف 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) طراحی شده است. توجه داشته باشید که ممکن است تعهدات قانونی دیگری تحت GDPR داشته باشید. لطفاً راهنمایی های اتحادیه اروپا را مرور کنید و با مشاور حقوقی خود مشورت کنید. لطفاً به یاد داشته باشید که ابزارهای Google برای تسهیل در رعایت قوانین طراحی شده اند و هیچ ناشر خاصی را از تعهدات خود بر اساس قانون سلب نمی کند. درباره نحوه تأثیر GDPR بر ناشران بیشتر بیاموزید .

هنگام استفاده از این ویژگی، یک پارامتر برچسب برای کاربران زیر سن رضایت در اروپا (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 اطلاعات هدف را جمع آوری می کند تا با درخواست تبلیغ ارسال شود.

URL محتوا

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

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

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

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


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

پیش نیازها

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 اختصاص دهید تا نشان دهید که می‌خواهید محتوای شما برای اهداف COPPA به‌عنوان هدایت‌شده توسط کودک در نظر گرفته شود.
  • RequestConfiguration::tag_for_child_directed_treatment به RequestConfiguration::kChildDirectedTreatmentFalse اختصاص دهید تا نشان دهید که نمی‌خواهید محتوای شما برای اهداف 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) طراحی شده است. توجه داشته باشید که ممکن است تعهدات قانونی دیگری تحت GDPR داشته باشید. لطفاً راهنمایی های اتحادیه اروپا را مرور کنید و با مشاور حقوقی خود مشورت کنید. لطفاً به یاد داشته باشید که ابزارهای Google برای تسهیل در رعایت قوانین طراحی شده اند و هیچ ناشر خاصی را از تعهدات خود بر اساس قانون سلب نمی کند. درباره نحوه تأثیر GDPR بر ناشران بیشتر بیاموزید .

هنگام استفاده از این ویژگی، یک پارامتر برچسب برای کاربران زیر سن رضایت در اروپا (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 اطلاعات هدف را جمع آوری می کند تا با درخواست تبلیغ ارسال شود.

URL محتوا

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

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

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

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