RequestConfiguration.Builder

class RequestConfiguration.Builder


أداة إنشاء لـ RequestConfiguration

ملخّص

طُرق وضع التصميم العامة

وظائف عامة

RequestConfiguration!

تنشئ RequestConfiguration.

RequestConfiguration.Builder!

تضبط إعدادات المعالجة الموجّهة للفئات العمرية.

RequestConfiguration.Builder!

تضبط التقييم الأقصى للمحتوى الإعلاني.

RequestConfiguration.Builder!

تضبط حالة تخصيص معالجة خصوصية الناشر.

RequestConfiguration.Builder!

تم إيقاف هذه الدالة نهائيًا.

استخدِم setAgeRestrictedTreatment بدلاً منها.

RequestConfiguration.Builder!

تم إيقاف هذه الدالة نهائيًا.

استخدِم setAgeRestrictedTreatment بدلاً منها.

RequestConfiguration.Builder!

تضبط قائمة بمعرّفات الأجهزة الاختبارية التي تتطابق مع الأجهزة الاختبارية التي ستطلب دائمًا إعلانات اختبارية.

طُرق وضع التصميم العامة

عامل بناء

Builder()

وظائف عامة

إنشاء

fun build(): RequestConfiguration!

تنشئ RequestConfiguration.

setAgeRestrictedTreatment

@CanIgnoreReturnValue
fun setAgeRestrictedTreatment(
    ageRestrictedTreatment: AgeRestrictedTreatment?
): RequestConfiguration.Builder!

تضبط إعدادات المعالجة الموجّهة للفئات العمرية.

يُرجى الرجوع إلى مستشارك القانوني لتحديد إعدادات المعالجة الموجّهة للفئات العمرية في ما يتعلّق بمستخدِمي موقعك الإلكتروني استنادًا إلى متطلّباتك القانونية والتنظيمية. لمزيد من المعلومات عن هذا الإعداد، يُرجى مراجعة https://developers.google.com/admob/android/targeting#set_the_age_treatment.

من خلال ضبط هذه السمة، أنت تقرّ بأنّ هذا الإشعار دقيق وبأنّك مخوّل بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد يؤدي إلى إغلاق حسابك على Google.

المعلمات
ageRestrictedTreatment: AgeRestrictedTreatment?

المعالجة الموجّهة للفئات العمرية، والتي تشير إلى ما إذا كان يجب التعامل مع طلب عرض الإعلان على أنّه موجّه إلى الأطفال أو المراهقين أو غير محدّد.

setMaxAdContentRating

@CanIgnoreReturnValue
fun setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating maxAdContentRating: String?
): RequestConfiguration.Builder!

تضبط التقييم الأقصى للمحتوى الإعلاني. ستتضمّن إعلانات AdMob التي يتم عرضها في تطبيقك تقييمًا حسب الفئة العمرية عند هذا المستوى أو أقل. القيم الصالحة هي MAX_AD_CONTENT_RATING_G وMAX_AD_CONTENT_RATING_PG وMAX_AD_CONTENT_RATING_T وMAX_AD_CONTENT_RATING_MA.

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
fun setPublisherPrivacyPersonalizationState(
    publisherPrivacyPersonalizationState: RequestConfiguration.PublisherPrivacyPersonalizationState!
): RequestConfiguration.Builder!

تضبط حالة تخصيص معالجة خصوصية الناشر.

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
fun setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment tagForChildDirectedTreatment: Int
): RequestConfiguration.Builder!

تتيح لك هذه الطريقة تحديد ما إذا كنت تريد أن يتم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA) - http://business.ftc.gov/privacy-and-security/childrens-privacy.

إذا ضبطت هذه الطريقة على TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE، ستشير إلى أنّه يجب التعامل مع تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

إذا ضبطت هذه الطريقة على TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE، ستشير إلى أنّه يجب عدم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

إذا لم تضبط هذه الطريقة أو ضبطتها على TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED، لن تتضمّن طلبات الإعلانات أي إشارة إلى الطريقة التي تريد أن يتم بها التعامل مع تطبيقك في ما يتعلّق بقانون حماية خصوصية الأطفال على الإنترنت (COPPA).

من خلال ضبط هذه الطريقة، أنت تقرّ بأنّ هذا الإشعار دقيق وبأنّك مخوّل بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد يؤدي إلى إغلاق حسابك على Google.

ملاحظة: قد يستغرق الأمر بعض الوقت حتى يتم تنفيذ هذه الإجراءات في خدمات Google السارية.

المعلمات
@RequestConfiguration.TagForChildDirectedTreatment tagForChildDirectedTreatment: Int

اضبط هذه المعلمة على true للإشارة إلى أنّه يجب التعامل مع تطبيقك على أنّه موجّه إلى الأطفال. اضبط هذه المعلمة على false للإشارة إلى أنّه يجب عدم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال.

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
fun setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent tagForUnderAgeOfConsent: Int
): RequestConfiguration.Builder!

تتيح لك هذه الطريقة وضع علامة على تطبيقك لتلقّي المعالجة الموجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال لـ اللائحة العامة لحماية البيانات (GDPR). يُرجى العلم بأنك قد تتحمّل التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات. ويُرجى مراجعة إرشادات الاتحاد الأوروبي والرجوع إلى مستشارك القانوني. ويجب الانتباه إلى أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب القانون.

عند استخدام هذه الميزة، سيتم تضمين معلَمة "علامة المستخدمين تحت سن الرشد في أوروبا" (TFUA) في جميع طلبات الإعلانات. تؤدي هذه المعلَمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي لطلب عرض الإعلان المحدّد هذا. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.

إذا ضبطت هذه الطريقة على TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE، ستشير إلى أنّك تريد أن يتم التعامل مع تطبيقك بطريقة مناسبة للمستخدمين تحت سن الرشد.

إذا ضبطت هذه الطريقة على TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE، ستشير إلى أنّك لا تريد أن يتم التعامل مع تطبيقك بطريقة مناسبة للمستخدمين تحت سن الرشد.

إذا لم تضبط هذه الطريقة أو ضبطتها على TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED، لن يتضمّن تطبيقك أي إشارة إلى الطريقة التي تريد أن يتم بها التعامل مع تطبيقك بطريقة مناسبة للمستخدمين تحت سن الرشد.

setTestDeviceIds

@CanIgnoreReturnValue
fun setTestDeviceIds(testDeviceIds: (Mutable)List<String!>?): RequestConfiguration.Builder!

تضبط قائمة بمعرّفات الأجهزة الاختبارية التي تتطابق مع الأجهزة الاختبارية التي ستطلب دائمًا إعلانات اختبارية. يتم تسجيل رقم تعريف الجهاز الاختباري للجهاز الحالي في أداة Logcat عند إرسال طلب عرض الإعلان الأول.

المعلمات
testDeviceIds: (Mutable)List<String!>?

قائمة بمعرّفات الأجهزة الاختبارية مرِّر null لمحو القائمة.