يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى طلب عرض الإعلان.
المتطلبات الأساسية
قبل المتابعة، عليك إعداد Google Mobile Ads Unity Plugin.
إعدادات الطلب
يجمع عنصر RequestConfiguration الإعدادات العامة لكل طلب إعلان، ويتم تطبيقه من خلال MobileAds.SetRequestConfiguration().
// Configure your RequestConfiguration with Test Device Ids.
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TestDeviceIds = TestDeviceIds
});
لضمان تطبيق تغييرات إعدادات الطلب على جميع طلبات الإعلانات، اضبط إعدادات الطلب قبل تهيئة حزمة تطوير البرامج (SDK).
إعدادات المحتوى الموجّه إلى الأطفال
بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، يتوفّر إعداد يُعرف باسم "وضع علامة على المحتوى باعتباره موجّهًا للأطفال".
بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال عند إرسال طلب عرض الإعلان. إذا أشرت إلى أنّك تريد أن تتعامل Google مع محتواك بصفته موجّهًا إلى الأطفال، نتّخذ خطوات لإيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات تجديد النشاط التسويقي في طلب عرض الإعلان هذا. يمكن استخدام هذا الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) الخاصة بخدمات Google Play من خلال RequestConfiguration.TagForChildDirectedTreatment:
- استخدِم الدالة
TagForChildDirectedTreatmentفيRequestConfigurationمع الوسيطةTagForChildDirectedTreatment.Trueللإشارة إلى أنّك تريد أن يتم التعامل مع محتواك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA). - استخدِم الدالة
TagForChildDirectedTreatmentفيRequestConfigurationمع الوسيطTagForChildDirectedTreatment.Falseللإشارة إلى أنّك لا تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA. - يُرجى عدم طلب
TagForChildDirectedTreatmentإذا كنت لا تريد الإشارة إلى كيفية التعامل مع المحتوى الخاص بك بموجب قانون COPPA في طلبات الإعلانات.
يوضّح المثال التالي أنّك تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون COPPA:
RequestConfiguration requestConfiguration = new RequestConfiguration
{
TagForChildDirectedTreatment = TagForChildDirectedTreatment.True
};
MobileAds.SetRequestConfiguration(requestConfiguration);
من خلال ضبط هذه العلامة، أنت تقرّ بأنّ هذا الإشعار دقيق وأنّ لديك الإذن بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد يؤدي إلى إغلاق حسابك على Google.
المستخدمون دون سن الرشد
يمكنك وضع علامة على طلبات إعلاناتك لكي يتم التعامل معها بصفتها موجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال للائحة العامة لحماية البيانات (GDPR). يُرجى العلم بأنك قد تتحمّل التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. يُرجى العِلم أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون. مزيد من المعلومات عن كيفية تأثير اللائحة العامة لحماية البيانات في الناشرين
عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة المستخدمين تحت سن الرشد في أوروبا" (TFUA) في طلب الإعلان. تؤدي هذه المَعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي لطلب عرض الإعلان المحدّد هذا. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس أداء الإعلانات وخوادم الإعلانات من جهة خارجية.
يمكن استخدام هذا الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) الخاصة بخدمات Google Play من خلال RequestConfiguration.TagForUnderAgeOfConsent:
- استخدِم الدالة
TagForUnderAgeOfConsentفيRequestConfigurationمع الوسيطTagForUnderAgeOfConsent.Trueللإشارة إلى أنّك تريد أن يتم التعامل مع إعدادات الطلب بطريقة مناسبة للمستخدمين دون سن الرشد. - يشير استدعاء
TagForUnderAgeOfConsentفيRequestConfigurationمع الوسيطةTagForUnderAgeOfConsent.Falseإلى أنّك لا تريد أن يتم التعامل مع إعدادات الطلب بطريقة مناسبة للمستخدمين تحت سن الرشد.
يوضّح المثال التالي أنّك تريد تضمين TFUA في طلب عرض الإعلان:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TagForUnderAgeOfConsent = TagForUnderAgeOfConsent.True
});
يجب عدم ضبط العلامات التي تفعّل الإعداد الموجّه إلى الأطفال
وTagForUnderAgeOfConsent معًا في الوقت نفسه على "صحيح".
وفي حال ضبطهما معًا، يتم منح الأولوية للإعداد الموجّه إلى الأطفال.
فلترة محتوى الإعلانات
يمكن استخدام هذا الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) الخاصة بخدمات Google Play من خلال RequestConfiguration.Builder.SetMaxAdContentRating():
يمكن للتطبيقات ضبط التقييم الأقصى للمحتوى الإعلاني في إعدادات الطلب باستخدام الدالة MaxAdContentRating في RequestConfiguration.
تتضمّن إعلانات AdMob التي يتم عرضها استجابةً لهذه الطلبات تقييمًا للمحتوى لا يزيد عن هذا المستوى. تستند القيم المحتملة لهذه البيانات الإضافية الخاصة بالشبكة إلى تصنيفات الملصقات الخاصة بالمحتوى الرقمي، ويجب أن تكون إحدى عناصر MaxAdContentRating التالية:
MaxAdContentRating.GMaxAdContentRating.PGMaxAdContentRating.TMaxAdContentRating.MA
يضبط الرمز التالي عنصر RequestConfiguration لتحديد أنّ محتوى الإعلان المعروض يجب أن يتوافق مع تصنيف المحتوى الرقمي الذي لا يزيد عن G:
RequestConfiguration requestConfiguration = new RequestConfiguration
{
MaxAdContentRating = MaxAdContentRating.G
};
MobileAds.SetRequestConfiguration(requestConfiguration);
طلب عرض الإعلان
يجمع الكائن AdRequest معلومات الاستهداف ليتم إرسالها مع طلب إعلان.
إضافة تفاصيل إضافية خاصة بالشبكة
تفاصيل إضافية خاصة بالشبكة هي تفاصيل إضافية يتم إرسالها مع طلب عرض الإعلان وتكون خاصة بمصدر إعلان واحد.
يضبط مقتطف الرمز التالي مفتاح مَعلمة إضافية بقيمة collapsible مع قيمة bottom في Google:
var adRequest = new AdRequest();
adRequest.Extras.Add("collapsible", "bottom");