الاستهداف

يشرح هذا الدليل كيفية توفير معلومات الاستهداف لطلب إعلان. للحصول على مثال عملي، يمكنك تنزيل تطبيق Android API التجريبي.

تنزيل عرض توضيحي لواجهة برمجة التطبيقات

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

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 للإشارة إلى أنّك تريد ألا يتم التعامل مع طلب الإعلان للمستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية.

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

يشير المثال التالي إلى أنّك تريد تضمين 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 التجريبي.