الاستهداف


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

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

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 للإشارة إلى أنّك تريد اعتبار المحتوى موجّهًا للأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).
  • اضبط قيمة RequestConfiguration::tag_for_child_directed_treatment على RequestConfiguration::kChildDirectedTreatmentFalse للإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).
  • يمكنك تعيين القيمة RequestConfiguration::tag_for_child_directed_treatment إلى RequestConfiguration::kChildDirectedTreatmentUnspecifiedإذا كنت لا تريد تحديد الطريقة التي تريد أن تتم بها معالجة المحتوى الخاص بك في ما يتعلق بقانون COPPA في طلبات عرض الإعلانات.

يشير المثال التالي إلى أنّك تريد أن تتم معاملة المحتوى على أنّه موجّه للأطفال لأغراض قانون 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.

يمكنك وضع علامة على طلبات عرض الإعلانات ليتم التعامل معها على أنّها موجّهة إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال لبنود اللائحة العامة لحماية البيانات (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 للإشارة إلى أنّك تريد عدم التعامل مع طلب عرض الإعلان على أنّه موجّه إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية.
  • يمكنك تعيين 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();