الاستهداف

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

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

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:

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