يوضح هذا الدليل كيفية توفير معلومات الاستهداف لطلب الإعلان. بالنسبة إلى يمكنك تنزيل تطبيق Android API Demo.
تنزيل العرض التوضيحي لواجهة برمجة التطبيقات
المتطلبات الأساسية
- أكمِل دليل البدء.
RequestConfiguration
RequestConfiguration
هي كائن يجمع معلومات الاستهداف ليتم تطبيقها عالميًا من خلال
MobileAds
ثابتة.
لتعديل إعدادات الطلب، يجب الحصول على أداة إنشاء من المنصة الحالية وإجراء أي تحديثات مطلوبة وإعدادها على النحو التالي:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
إعداد "موجّه للأطفال"
لأغراض قانون حماية خصوصية الأطفال على الإنترنت قانون حماية خصوصية الأطفال على الإنترنت (COPPA)، هناك إعداد يُسمى "وضع علامة للتعامل مع الموقع باعتباره موجّهًا للأطفال". من خلال إعداد هذه العلامة، أنت تقرّ بدقّة هذا الإشعار. وأن لديك تفويضًا بالتصرف نيابةً عن مالك التطبيق. أشرت إلى إدراكك أنّ إساءة استخدام هذه الإعدادات قد تؤدي إلى إغلاق القناة. في حسابك على Google.
بصفتك مطوّر تطبيقات، يمكنك الإشارة إلى ما إذا كنت تريد أن تتعامل Google مع محتوى موجّه إلى الأطفال عند تقديم طلب إعلان. إذا حددت أنك تريد أن تتعامل Google مع المحتوى الخاص بك باعتباره موجّهًا للأطفال، ونحن نتخذ الخطوات اللازمة إيقاف الإعلانات التي تستهدف الاهتمامات وإعلانات تجديد النشاط التسويقي في طلب الإعلان هذا.
يمكن استخدام الإعداد مع جميع إصدارات حزمة تطوير البرامج (SDK) لخدمات Google Play.
من خلال RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
:
الاتصال بـ
setTagForChildDirectedTreatment
باستخدامTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
للإشارة إلى أنك تريد التعامل مع المحتوى باعتباره موجّهًا للأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA). وهذا يمنع إرسال المعرّف الإعلاني على Android (AAID):الاتصال بـ
setTagForChildDirectedTreatment
باستخدامTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
للإشارة إلى أنك لا تريد التعامل مع المحتوى باعتباره موجّهًا للأطفال بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA).الاتصال بـ
setTagForChildDirectedTreatment
باستخدامTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
إذا كنت لا تريد الإشارة إلى طريقة التعامل مع المحتوى بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA) في طلبات الإعلان.
يشير المثال التالي إلى رغبتك في التعامل مع المحتوى التابع لك موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
المستخدمون دون سن الرشد
يمكنك وضع علامة على طلبات إعلاناتك ليتم التعامل معها على أنّها موجّهة للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) تحت سن الرشد. هذه الميزة مُصمَّمة للمساعدة في تسهيل الامتثال لبنود المبادئ العامة لائحة حماية البيانات (GDPR) لاحظ أنه قد يكون لديك حسابات قانونية أخرى والالتزامات بموجب اللائحة العامة لحماية البيانات. يُرجى مراجعة إرشادات الاتحاد الأوروبي والتشاور مع مستشارك القانوني. تجدر الإشارة إلى أنّ أدوات Google مصمّمة لتسهيل الامتثال ولا تعفي أي ناشر معيّن من التزاماته بموجب بالقانون. اطّلِع على مزيد من المعلومات عن كيفية تأثير "اللائحة العامة لحماية البيانات" على الناشرين.
عند استخدام هذه الميزة، يتم عرض علامة للمستخدمين تحت سن الرشد في أوروبا. يتم تضمين مَعلمة (TFUA) في طلب الإعلان. تعمل هذه المعلمة على إيقاف الإعلانات المخصصة، بما في ذلك تجديد النشاط التسويقي، لجميع طلبات الإعلانات. وكذلك لإيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم إعلانات الجهات الخارجية.
مثلما هو الحال مع الإعدادات الموجّهة إلى الأطفال، هناك طريقة في
RequestConfiguration.Builder
لإعداد مَعلمة TFUA:
setTagForUnderAgeOfConsent()
،
مع الخيارات التالية.
الاتصال بـ "
setTagForUnderAgeOfConsent()
" باستخدام "TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
" للإشارة إلى رغبتك في أن يتلقى طلب الإعلان المعالجة للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) تحت سن الرشد. هذا أيضًا يمنع نقل المعرّف الإعلاني لنظام التشغيل Android (AAID):الاتصال بـ "
setTagForUnderAgeOfConsent()
" باستخدام "TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
" للإشارة إلى رغبتك في عدم تلقي طلب الإعلان لأيّ مستخدم في المنطقة الاقتصادية الأوروبية (EEA) دون سن الرشد.الاتصال بـ
setTagForUnderAgeOfConsent()
باستخدامTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
للإشارة إلى أنك لم ما إذا كان يجب معالجة طلب الإعلان للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) تحت سن الرشد.
يشير المثال التالي إلى أنّك تريد تضمين TFUA في طلبات إعلاناتك:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
العلامات لتفعيل الإعداد الموجّه للأطفال
وsetTagForUnderAgeOfConsent()
يجب ألا يتم ضبطهما معًا على true
.
في هذه الحالة، تكون الأولوية للإعداد الموجّه للأطفال.
تصفية المحتوى الإعلاني
للالتزام ببنود سياسة الإعلانات غير المناسبة في Google Play الذي يتضمّن العروض المرتبطة به ضمن الإعلان وجميع الإعلانات وما يرتبط بها يجب أن تكون العروض التي تظهر داخل التطبيق مناسبة للمحتوى التقييم من تطبيقك، حتى إذا كان المحتوى في حد ذاته متوافقًا مع Google سياسات Play
يمكن أن تساعدك أدوات مثل التقييم الأقصى للمحتوى الإعلاني في التحكم بشكل أكبر في محتوى الإعلانات المعروضة للمستخدمين. يمكنك ضبط التقييم الأقصى للمحتوى على للمساعدة في الامتثال لسياسات النظام الأساسي.
يمكن للتطبيقات وضع حد أقصى لتقييم محتوى الإعلان لطلبات الإعلانات باستخدام
setMaxAdContentRating
. تحتوي إعلانات AdMob التي يتم عرضها بعد تهيئة ذلك على تقييم محتوى بقيمة أو
دون هذا المستوى. تستند القيم المحتملة لهذه الشبكة الإضافية إلى
تصنيفات المحتوى الرقمي، ويجب أن تكون واحدة مما يلي
السلاسل:
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
يعمل الرمز التالي على ضبط عنصر RequestConfiguration
لتحديد
يجب أن يتوافق محتوى الإعلان المعروض مع تعيين تصنيف المحتوى الرقمي "لا"
أعلى من G
:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
يمكنك الاطّلاع على المقالات التالية:
التعامل مع خصوصية الناشر (إصدار تجريبي)
تشير رسالة الأشكال البيانية
معالجة خصوصية الناشر
(PPT) API هي أداة اختيارية تتيح للتطبيقات تحديد ما إذا كان يجب إيقاف الإعلانات أو لا.
التخصيص لجميع طلبات الإعلانات باستخدام
setPublisherPrivacyPersonalizationState()
.
عند استخدام هذه الميزة، يتم ضبط مَعلمة معالجة خصوصية الناشر (PPT) على
تضمينها في جميع طلبات الإعلان المستقبلية خلال الفترة المتبقية من الجلسة.
بشكل تلقائي، يتم عرض إعلانات مخصّصة لطلبات الإعلان إلى Google. ما يلي: يؤدي إلى إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
طلب الإعلان
عنصر AdRequest
يجمع الاستهداف
المعلومات التي سيتم إرسالها مع طلب الإعلان.