الاستهداف

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى حزمة SDK لإعلانات Google على الأجهزة الجوّالة.

للاطّلاع على مثال عملي، نزِّل تطبيق Android API Demo.

تنزيل الإصدار التجريبي من واجهة برمجة التطبيقات

المتطلبات الأساسية

RequestConfiguration

تجمع RequestConfiguration معلومات الاستهداف المطبَّقة بشكلٍ عام على كلّ طلب إعلان. للاطّلاع على علامات الاستهداف المتاحة، يُرجى الرجوع إلى مستندات RequestConfiguration.Builder.

لتعديل إعدادات الطلب، احصل على أداة إنشاء من الإعدادات الحالية، ونفِّذ أي تعديلات مطلوبة، واضبطها على النحو التالي:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

الإعداد الموجّه إلى الأطفال

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

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

يمكنك تطبيق الإعداد "محتوى موجّه إلى الأطفال" من خلال setTagForChildDirectedTreatment():

  • يُرجى الاتصال برقم setTagForChildDirectedTreatment باستخدام الرقم المرجعي TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE للإشارة إلى أنّك تريد أن يتم التعامل مع المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA). ويؤدي ذلك إلى منع إرسال المعرِّف الإعلاني على Android (AAID).

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

  • يُرجى الاتصال برقم setTagForChildDirectedTreatment مع TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED إذا كنت لا تريد تحديد الطريقة التي تريد أن يُعامل بها المحتوى الخاص بك بموجب قانون حماية خصوصية الأطفال على الإنترنت في طلبات الإعلانات.

يشير المثال التالي إلى أنّك تريد أن يُعامل المحتوى الخاص بك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA):

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration 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:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

يمكنك الاطّلاع على المقالات التالية:

معالجة خصوصية الناشر (إصدار تجريبي)

‫ Publisher Privacy Treatment API (PPT) هي أداة اختيارية تتيح للتطبيقات الإشارة إلى ما إذا كان سيتم إيقاف ميزة تخصيص الإعلانات لجميع طلبات الإعلانات باستخدام الطريقة setPublisherPrivacyPersonalizationState(). عند استخدام هذه الميزة، يتم تضمين مَعلمة معالجة خصوصية الناشر (PPT) في جميع طلبات الإعلانات المستقبلية خلال الفترة المتبقية من الجلسة.

تعرض طلبات الإعلان المُرسَلة إلى Google إعلانات مخصّصة تلقائيًا. يؤدي الرمز التالي إلى إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

طلب الإعلان

يجمع عنصر AdRequest معلومات targeting لإرسالها مع طلب إعلان.

راجِع مثال استهداف الإعلانات للاطّلاع على كيفية تنفيذ استهداف الإعلانات في تطبيق Android API Demo.