RequestConfiguration.Builder

Kotlin |Java

public class RequestConfiguration.Builder

---

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

ملخّص

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

الإجراءات العامة
RequestConfiguration	build() تنشئ RequestConfiguration.
RequestConfiguration.Builder	@CanIgnoreReturnValue setAgeRestrictedTreatment(     @Nullable AgeRestrictedTreatment ageRestrictedTreatment ) تضبط إعدادات المعالجة المحظورة على فئات عمرية معيّنة.
RequestConfiguration.Builder	@CanIgnoreReturnValue setMaxAdContentRating(     @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating ) تضبط التقييم الأقصى للمحتوى الإعلاني.
RequestConfiguration.Builder	@CanIgnoreReturnValue setPublisherPrivacyPersonalizationState(     RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState ) تضبط حالة تخصيص معالجة خصوصية الناشر.
RequestConfiguration.Builder	@CanIgnoreReturnValue setTagForChildDirectedTreatment(     @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment ) تم إيقاف هذا الإجراء نهائيًا. استخدِم setAgeRestrictedTreatment بدلاً منه.
RequestConfiguration.Builder	@CanIgnoreReturnValue setTagForUnderAgeOfConsent(     @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent ) تم إيقاف هذا الإجراء نهائيًا. استخدِم setAgeRestrictedTreatment بدلاً منه.
RequestConfiguration.Builder	@CanIgnoreReturnValue setTestDeviceIds(@Nullable List<String> testDeviceIds) تضبط قائمة بمعرّفات الأجهزة الاختبارية التي ستطلب دائمًا إعلانات اختبارية.

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

عامل بناء

public Builder()

الإجراءات العامة

إنشاء

public RequestConfiguration build()

تنشئ RequestConfiguration.

setAgeRestrictedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setAgeRestrictedTreatment(
    @Nullable AgeRestrictedTreatment ageRestrictedTreatment
)

تضبط إعدادات المعالجة المحظورة على فئات عمرية معيّنة.

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

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

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

setMaxAdContentRating

@CanIgnoreReturnValue
public RequestConfiguration.Builder setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating
)

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

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
public RequestConfiguration.Builder setPublisherPrivacyPersonalizationState(
    RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState
)

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

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment
)

تم إيقاف هذا الإجراء نهائيًا.

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

يسمح لك هذا الإجراء بتحديد ما إذا كنت تريد التعامل مع تطبيقك على أنّه موجّه إلى الأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (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 int tagForChildDirectedTreatment	اضبط القيمة على true للإشارة إلى أنّه يجب التعامل مع تطبيقك على أنّه موجّه إلى الأطفال. اضبط القيمة على false للإشارة إلى أنّه يجب عدم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال.

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent
)

تم إيقاف هذا الإجراء نهائيًا.

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

يسمح لك هذا الإجراء بوضع علامة على تطبيقك لتلقّي المعالجة الموجّهة للمستخدمين تحت سن الرشد في المنطقة الاقتصادية الأوروبية. تم تصميم هذه الميزة للمساعدة في تسهيل الامتثال لـ اللائحة العامة لحماية البيانات (GDPR). يُرجى العِلم أنّه قد تكون لديك التزامات قانونية أخرى بموجب اللائحة العامة لحماية البيانات (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
public RequestConfiguration.Builder setTestDeviceIds(@Nullable List<String> testDeviceIds)

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

المعلمات
@Nullable List<String> testDeviceIds	قائمة بمعرّفات الأجهزة الاختبارية مرِّر القيمة null لمحو القائمة.

المرتجعات
RequestConfiguration.Builder	Builder