تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الاستهداف

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف لطلب إعلان.

المتطلبات الأساسية

أكمِل مقالة البدء.

`RequestConfiguration`

RequestConfiguration عبارة عن بنية تجمع معلومات الاستهداف ليتم تطبيقها على مستوى العالم من خلال الدالة العالمية SetRequestConfiguration().

لتحديث إعدادات الطلب، عليك الحصول أولاً على الإعدادات الحالية وإجراء أي تعديلات مطلوبة وضبطها على النحو التالي:

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

إعداد موجّه للأطفال

لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، ثمة إعداد اسمه "علامة التعامل مع المحتوى الموجّه إلى الأطفال". من خلال ضبط هذه العلامة، تقرّ بأنّ هذا الإشعار دقيق، وأنّه يحق لك التصرف نيابةً عن مالك التطبيق. أنت تدرك أنّ إساءة استخدام هذا الإعداد قد تؤدي إلى إغلاق حسابك على Google.

بصفتك مطوِّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع المحتوى الخاص بك باعتباره موجّهًا للأطفال عند تقديم طلب الإعلان. إذا أشرت إلى أنّك تريد من Google أن تتعامل مع المحتوى الذي تقدّمه باعتباره موجّهًا للأطفال، نتّخذ خطوات لإيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات تجديد النشاط التسويقي في طلب الإعلان هذا.

يمكن ضبط الإعداد من خلال تخصيص عضو tag_for_child_directed_treatment في البنية RequestConfiguration لإحدى القيم العددية التالية:

عليك ضبط السمة RequestConfiguration::tag_for_child_directed_treatment على RequestConfiguration::kChildDirectedTreatmentTrue للإشارة إلى أنّك تريد التعامل مع المحتوى الخاص بك باعتباره موجّهًا للأطفال لأغراض تتعلّق بقانون حماية خصوصية الأطفال على الإنترنت.
عليك ضبط السمة RequestConfiguration::tag_for_child_directed_treatment على RequestConfiguration::kChildDirectedTreatmentFalse للإشارة إلى أنك لا تريد أن يتم تصنيف المحتوى الخاص بك على أنه موجّه للأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت.
عليك ضبط السمة 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 مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. اطّلِع على مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات على الناشرين.

عند استخدام هذه الميزة، سيتم تضمين مَعلمة علامة المستخدمين تحت سن الرشد في أوروبا (TFUA) في طلب الإعلان. تؤدي هذه المعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي لجميع طلبات الإعلانات. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.

مثل الإعدادات الموجّهة للأطفال، هناك عضو في RequestConfiguration لضبط إعدادات مَعلمة TFUA: tag_for_under_age_of_consent، والتي قد يتم ضبطها باستخدام القيم العددية التالية:

تخصيص RequestConfiguration::tag_for_under_age_of_consent إلى RequestConfiguration::kUnderAgeOfConsentTrue للإشارة إلى أنّك تريد أن يتلقّى طلب الإعلان معاملة المستخدمين في المنطقة الاقتصادية الأوروبية تحت سن الرشد.
تخصيص RequestConfiguration::tag_for_under_age_of_consent إلى RequestConfiguration::kUnderAgeOfConsentFalse للإشارة إلى أنّك تريد عدم تلقّي طلب الإعلان للتعامل مع المستخدمين في المنطقة الاقتصادية الأوروبية (EEA) دون سن الرشد.
تخصيص RequestConfiguration::tag_for_under_age_of_consent RequestConfiguration::kUnderAgeOfConsentUnspecified للإشارة إلى أنك لم تحدّد ما إذا كان يجب أن يتلقّى طلب الإعلان المعاملة للمستخدمين في المنطقة الاقتصادية الأوروبية تحت سن الرشد.

يشير المثال التالي إلى رغبتك في تضمين 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();