هدف گذاری


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

پیش‌نیازها

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

محیط کودک محور

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

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

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

  • برای نشان دادن اینکه می‌خواهید محتوای شما برای اهداف COPPA به صورت child-directed در نظر گرفته شود، 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);

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

شما می‌توانید درخواست‌های تبلیغاتی خود را برای دریافت خدمات درمانی برای کاربران در منطقه اقتصادی اروپا (EEA) زیر سن قانونی علامت‌گذاری کنید. این ویژگی برای کمک به تسهیل رعایت مقررات عمومی حفاظت از داده‌ها (GDPR) طراحی شده است. توجه داشته باشید که ممکن است تعهدات قانونی دیگری تحت GDPR داشته باشید. لطفاً راهنمایی‌های اتحادیه اروپا را بررسی کرده و با وکیل حقوقی خود مشورت کنید. لطفاً به یاد داشته باشید که ابزارهای گوگل برای تسهیل رعایت این مقررات طراحی شده‌اند و هیچ ناشر خاصی را از تعهدات خود تحت قانون معاف نمی‌کنند. درباره چگونگی تأثیر 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);

برچسب‌های مربوط به فعال کردن تنظیمات Child-directed و Users under the Age of Consent نباید همزمان روی true تنظیم شوند. در صورت وجود، تنظیمات Child-directed اولویت دارد.

فیلتر کردن محتوای تبلیغات

برنامه‌ها می‌توانند از طریق 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 محتوایی را که ارائه می‌دهند، ارسال کنند. این امر امکان هدف‌گیری کلمات کلیدی را برای مطابقت تبلیغ با محتوا فراهم می‌کند.

برای مثال، اگر برنامه شما هنگام نمایش محتوا از 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();