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