الاستهداف


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

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

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