RequestConfiguration.Builder

public class RequestConfiguration.Builder


أداة إنشاء لتطبيق RequestConfiguration

ملخّص

الدوال الإنشائية العامة

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

RequestConfiguration

تنشئ RequestConfiguration.

RequestConfiguration.Builder

تضبط هذه السمة الحدّ الأقصى لتقييم محتوى الإعلان.

RequestConfiguration.Builder

تضبط هذه السمة حالة التخصيص في "معاملة الخصوصية الخاصة بالناشر".

RequestConfiguration.Builder

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

RequestConfiguration.Builder

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

RequestConfiguration.Builder

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

الدوال الإنشائية العامة

عامل بناء

public Builder()

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

إنشاء

public RequestConfiguration build()

تنشئ RequestConfiguration.

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
)

تتيح لك هذه الطريقة تحديد ما إذا كنت تريد أن يتم التعامل مع تطبيقك على أنّه موجّه للأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA) - http://www.ftc.gov/business-guidance/privacy-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
)

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