يوضح هذا الدليل كيفية توفير معلومات الاستهداف لطلب الإعلان. بالنسبة إلى يمكنك تنزيل تطبيق 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)
طلب الإعلان
عنصر AdManagerAdRequest
يجمع الاستهداف
المعلومات التي سيتم إرسالها مع طلب الإعلان.
الاستهداف المخصّص
يمكنك ضبط أزواج المفتاح/القيمة لاستهداف حملات "مدير إعلانات Google" (سطر
من العناصر) إلى AdManagerAdRequest.Builder.addCustomTargeting()
:
Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
Kotlin
// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build()
يمكنك تمرير قيم متعددة لمفتاح كقائمة سلاسل. على سبيل المثال، بهدف استهداف الأفراد في منتصف العشرينات من العمر بدلاً من مجرد 25 عامًا.
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
الاطّلاع على مثال على الاستهداف المخصّص في "مدير إعلانات Google" لتنفيذ استهداف مخصّص في تطبيق Android API التجريبي.
استثناءات الفئات
يمكنك إضافة مستوى استبعاد فئة على مستوى الشريحة إلى طلب باستخدام
addCategoryExclusion()
الطريقة المتوفرة من AdManagerAdRequest.Builder
:
Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
Kotlin
// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()
يمكنك الاطّلاع على مثال على استبعادات الفئات في "مدير إعلانات Google". لتنفيذ استبعادات الفئات في تطبيق Android API التجريبي.
المعرّفات المقدَّمة من الناشر
يمكنك ضبط المعرّف المقدَّم من الناشر (PPID) لاستخدامه في تحديد عدد مرات الظهور. تقسيم الجمهور والاستهداف، وعرض الإعلانات بالتناوب التسلسلي، وغير ذلك عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.
في ما يلي مثال على ضبط المعرّف المقدَّم من الناشر (PPID):
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
Kotlin
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
اطّلِع على مثال المعرّف المقدَّم من الناشر (PPID) على "مدير إعلانات Google". لتنفيذ المعرِّفات التي يقدّمها الناشر (PPID) في نظام التشغيل Android تطبيق واجهة برمجة تطبيقات تجريبي.
إشارات مقدَّمة من الناشر
يمكنك إرسال بيانات الجمهور والسياق إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلان. تتيح لك "الإشارات المقدَّمة من الناشر" (PPS) استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال توصيل سمات جمهورك مقدمي عروض أسعار في جميع أنواع المعاملات، باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. جمهورك البيانات السلوكية استنادًا إلى الاهتمامات (جمهور IAB) التصنيف 1.1) والسياق (تصنيف المحتوى 2.2 من IAB).
Java
Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
Kotlin
val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))
val request = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
عنوان URL الخاص بالمحتوى
لتوفير عنوان URL للمحتوى من أجل إعلانات تستهدف المحتوى وأمان العلامة التجارية، يمكنك طلب
setContentUrl()
عند إنشاء AdManagerAdRequest
:
Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
أمان العلامة التجارية (ميزة تجريبية)
التطبيقات التي تعرض محتوى ديناميكيًا موجَّهًا إلى جماهير متنوعة:
توفير قائمة مختصرة بعناوين URL باستخدام
setNeighboringContentUrls()
عند إنشاء AdManagerAdRequest
:
Java
ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build();
Kotlin
var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
"https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build()
ويختلف .setNeighboringContentUrls()
عن .setContentUrl()
من حيث إنه
للحفاظ على أمان العلامة التجارية.