يوضح هذا الدليل كيفية توفير معلومات الاستهداف لطلب الإعلان.
المتطلّبات الأساسية
- أكمِل البدء.
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();