يجمع عنصر RequestConfiguration الإعدادات العامة لكل طلب إعلان ويتم تطبيقه من خلال MobileAds.instance.updateRequestConfiguration().
لضمان تطبيق تغييرات إعدادات طلب عرض الإعلان على جميع طلبات عرض الإعلانات، عليك تعديل إعدادات طلب عرض الإعلان قبل إعداد Google Mobile Ads Flutter Plugin.
إعداد "موجّه إلى الأطفال"
لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، يتوفّر إعداد يُسمى "وضع علامة على طلبات الإعلان بأنّها موجّهة للأطفال".
بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال عند إرسال طلب عرض إعلان. إذا أشرت إلى أنّك تريد من Google التعامل مع محتواك على أنّه موجّه للأطفال، سنتّخذ الخطوات اللازمة لإيقاف الإعلانات التي تستهدف الاهتمامات والإعلانات للزوّار السابقين في طلب الإعلان هذا. يمكن استخدام هذا الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) لـ "خدمات Google Play" من خلال RequestConfiguration.tagForChildDirectedTreatment():
- استخدِم الوسيطة
TagForChildDirectedTreatment.yesللإشارة إلى أنّك تريد أن تتم معالجة المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA). - استخدِم الوسيطة
TagForChildDirectedTreatment.noللإشارة إلى أنّك لا تريد أن تتم معالجة المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA). - استخدِم الوسيطة
TagForChildDirectedTreatment.unspecifiedأو لا تضبط هذه العلامة إذا كنت لا تريد الإشارة إلى الطريقة التي تريد بها التعامل مع المحتوى في ما يتعلق بقانون حماية خصوصية الأطفال على الإنترنت (COPPA) في طلبات عرض الإعلانات.
يشير المثال التالي إلى أنّك تريد تصنيف المحتوى على أنّه مخصّص للأطفال لأغراض قانون COPPA:
final RequestConfiguration requestConfiguration = RequestConfiguration(
tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);
المستخدمون دون سن الرشد
يمكنك وضع علامة على طلبات عرض الإعلانات ليتم التعامل معها على أنّها موجّهة إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال لبنود اللائحة العامة لحماية البيانات (GDPR). يُرجى العِلم أنّه قد تكون عليك التزامات قانونية أخرى بموجب "اللائحة العامة لحماية البيانات" (GDPR). يُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. ويجب الانتباه إلى أن أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. مزيد من المعلومات عن كيفية تأثير "اللائحة العامة لحماية البيانات" (GDPR) في الناشرين
عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة للقاصرين دون سن الرشد في أوروبا" (TFUA) في طلب عرض الإعلان. تؤدي هذه المعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي، لطلب عرض الإعلان المحدّد هذا. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس أداء الإعلانات وخوادم الإعلانات من جهة خارجية.
يتم ضبط العلامة باستخدام RequestConfiguration.tagForUnderAgeOfConsent():
- استخدِم الوسيطة
TagForUnderAgeOfConsent.yesللإشارة إلى أنّك تريد معالجة إعدادات الطلب بطريقة مناسبة للمستخدمين دون سن الرشد. - استخدِم الوسيطة
TagForUnderAgeOfConsent.noللإشارة إلى أنّك لا تريد معالجة إعدادات الطلب بطريقة مناسبة للمستخدمين دون سن الرشد. استخدِم الوسيطة
TagForUnderAgeOfConsent.unspecifiedأو لا تضبط هذه العلامة للإشارة إلى أنّك لم تحدّد ما إذا كان يجب أن يتلقّى طلب عرض الإعلان معاملة للمستخدمين في المنطقة الاقتصادية الأوروبية دون سن الرشد. يشير المثال التالي إلى أنّك تريد تضمين علامة المعالجة الموجّهة للقاصرين (TFUA) في طلب عرض الإعلان:final RequestConfiguration requestConfiguration = RequestConfiguration( tagForUnderAgeOfConsent: TagForUnderAgeOfConsent.yes); MobileAds.instance.updateRequestConfiguration(requestConfiguration);
يجب عدم ضبط علامات تفعيل إعداد "موجّه إلى الأطفال" وsetTagForUnderAgeOfConsent معًا في الوقت نفسه على true. وفي حال ضبطهما معًا، يتم منح الأولوية للإعدادات المخصّصة للأطفال.
فلترة محتوى الإعلانات
يمكن ضبط تقييمات المحتوى الإعلاني باستخدام RequestConfiguration.maxAdContentRating():
وتكون إعلانات AdMob التي يتم عرضها لهذه الطلبات ذات تقييم محتوى يبلغ هذا المستوى أو أقل منه. تستند القيم المحتمَلة لهذه التفاصيل الإضافية الخاصة بالشبكة إلى تصنيفات المحتوى الرقمي، ويمكن أن تكون إحدى سمات MaxAdContentRating التالية:
MaxAdContentRating.gMaxAdContentRating.pgMaxAdContentRating.tMaxAdContentRating.ma
يضبط الرمز التالي عنصر RequestConfiguration لتحديد أنّ محتوى الإعلان الذي يتم عرضه يتوافق مع تصنيف محتوى رقمي لا يزيد عن G:
final RequestConfiguration requestConfiguration = RequestConfiguration(
maxAdContentRating: MaxAdContentRating.g);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);
طلب عرض الإعلان
يجمع الكائن AdManagerAdRequest معلومات الاستهداف لإرسالها مع طلب عرض الإعلان.
الاستهداف المخصّص
يمكنك تمرير أزواج المفتاح/القيمة المخصّصة لاستهداف حملات "إدارة إعلانات Google" (تفاصيل الإعلان):
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = AdManagerAdRequest(
customTargeting: {'age': '25'},
);
المعرّفات المقدّمة من الناشر
يمكنك ضبط معرّف مقدَّم من الناشر (PPID) لاستخدامه في تحديد عدد مرات الظهور، وتصنيف الجمهور إلى شرائح واستهدافه، وعرض الإعلانات بالتناوب، وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.
في ما يلي مثال على ضبط معرّف PPID:
AdManagerAdRequest adRequest = AdManagerAdRequest(
publisherProvidedId: 'AB123456789',
);
عنوان URL للمحتوى
لتقديم عنوان URL للمحتوى من أجل الإعلانات التي تستهدف المحتوى وأمان العلامة التجارية، يمكنك تمرير
contentUrl عند إنشاء AdManagerAdRequest:
AdManagerAdRequest request = AdManagerAdRequest(
contentUrl: 'https://www.example.com',
);
أمان العلامة التجارية
يمكن للتطبيقات التي تعرض محتوًى ديناميكيًا مخصّصًا لشرائح جمهور مختلفة
تقديم قائمة قصيرة بعناوين URL من خلال توفير neighboringContentUrls
عند إنشاء AdManagerAdRequest:
final neighboringContentUrls = [
'https://www.mycontenturl1.com',
'https://www.mycontenturl2.com',
'https://www.mycontenturl3.com',
'https://www.mycontenturl4.com',
];
AdManagerAdRequest request = AdManagerAdRequest(
neighboringContentUrls: neighboringContentUrls,
);
يختلف neighboringContentUrls عن contentUrl في أنّه يُستخدم فقط لأمان العلامة التجارية.