الاستهداف


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

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

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