الاستهداف

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

يُرجى الرجوع إلى مثال استهداف الإعلانات لتنفيذ استهداف الإعلانات في تطبيق Android API التجريبي.