يجمع عنصر 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). يُرجى العِلم أنّه قد تكون لديك التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. ويُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. ويجب الانتباه إلى أن أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات في الناشرين.
عند استخدام هذه الميزة، سيتم تضمين مَعلمة "وضع علامة على المحتوى للتعامل معه باعتباره موجّهًا للمستخدمين تحت سن الرشد في أوروبا" (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) لاستخدامه في تحديد عدد مرات الظهور وتصنيف الجمهور إلى شرائح واستهدافه وعرض الإعلانات بالتناوب وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على مستوى الأجهزة.
في ما يلي مثال على ضبط المعرّف المقدَّم من الناشر:
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 في أنّه يُستخدم فقط لأمان العلامة التجارية.