الاستهداف

يشرح هذا الدليل كيفية تقديم معلومات الاستهداف إلى حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

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

قبل المتابعة، عليك إعداد GMA Next-Gen SDK.

RequestConfiguration

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

أنشئ كائن RequestConfiguration باستخدام علامات الاستهداف التي تحتاجها باستخدام أداة الإنشاء، ثم اضبط الإعدادات من خلال استدعاء MobileAds.setRequestConfiguration().

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

لتطبيق علامات الاستهداف من طلب عرض الإعلان الأول، يجب تقديم إعدادات الطلب أثناء إعداد حزمة تطوير البرامج (SDK):

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

ضبط إعدادات المعالجة الموجّهة للفئة العمرية

لمساعدتك في إدارة امتثالك للوائح الخصوصية السارية ذات الصلة بالأطفال والمراهقين، يوفّر "GMA Next-Gen SDK" إعدادًا للمعالجة حسب الفئة العمرية. يتيح لك إعداد "المعالجة حسب الفئة العمرية" تحديد ما إذا كان يجب أن تطبّق "GMA Next-Gen SDK" إجراءات حماية معيّنة عند عرض الإعلانات للأطفال أو المراهقين أو فئة عمرية غير محدّدة.

يمكنك ضبط إعدادات معالجة الطلبات حسب العمر باستخدام طريقة setAgeRestrictedTreatment() من خلال واجهة برمجة التطبيقات RequestConfiguration.Builder.

يشير المثال التالي إلى أنّه يجب التعامل مع طلبات عرض الإعلانات على أنّها موجّهة إلى الأطفال:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

للإشارة إلى معالجة موجّهة إلى المراهقين أو معالجة غير محدّدة حسب العمر، استبدِل الإعداد CHILD بما يلي:

  • TEEN
  • UNSPECIFIED

عند استخدام هذا الإعداد، يتضمّن GMA Next-Gen SDK مَعلمة tfat في طلبات عرض الإعلانات. يُرجى الرجوع إلى مستشارك القانوني لتحديد إعدادات المعالجة الموجّهة للفئات العمرية في ما يتعلّق بمستخدِمي موقعك الإلكتروني استنادًا إلى التزاماتك القانونية والتنظيمية. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة وضع علامة على طلب عرض إعلان من تطبيق لمعالجة مقيَّدة للقاصرين.

الانتقال إلى إعدادات المعالجة الموجّهة للفئة العمرية من علامة TFCD وعلامة TFUA

يحلّ إعداد المعالجة الموجّهة للفئة العمرية محلّ إعدادات علامة المعالجة الموجّهة إلى الأطفال .setTagForChildDirectedTreatment() (TFCD) وعلامة المعالجة الموجّهة للقاصرين.setTagForUnderAgeOfConsent() (TFUA) المتوقّفة نهائيًا.

يعرض الجدول التالي إعدادات TFCD وTFUA وما يعادلها من إعدادات المعالجة حسب الفئة العمرية:

TFCD

TFCD معالجة الطلبات حسب العمر
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
لم يتم تحديد قيمة للسمة .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
بدون مكافئ AgeRestrictedTreatment.TEEN

TFUA

TFUA معالجة الطلبات حسب العمر
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
لم يتم تحديد أي قيمة لسمة .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
بدون مكافئ AgeRestrictedTreatment.TEEN

فهم تفاعلات المعالجة الموجّهة للفئات العمرية مع علامة TFCD وعلامة TFUA

في حال ضبط إعدادات معالجة الطلبات حسب العمر وإعدادات TFCD أو TFUA، تطبّق Google الإعدادات الأكثر تحفّظًا.

إعادة توجيه إعدادات المعالجة حسب السنّ من خلال ميزة "توسط AdMob"

في حال ضبط المعالجة الموجّهة للفئات العمرية باستخدام GMA Next-Gen SDK، ستعيد محوّلات التوسّط توجيه إشارة المعالجة الموجّهة للفئات العمرية إلى حِزم تطوير البرامج (SDK) التابعة لجهات خارجية والتي يتم التوسّط فيها.

يسرد الجدول التالي إصدارات محوّلات التوسّط التي تتيح إعادة توجيه إشارة المعالجة المحظورة على فئات عمرية معيّنة إلى حزمة تطوير البرامج (SDK) التابعة لجهة خارجية والتي يتم التوسّط فيها:

اسم محوِّل التوسّط الحد الأدنى للإصدار المتوافق
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize (Vungle) 7.7.4.2
LY (Line) 3.1.1.1
maio 2.0.9.0
Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

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

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

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

يمكنك تطبيق الإعدادات المخصّصة للأطفال من خلال setTagForChildDirectedTreatment():

  • يمكنك استدعاء 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 في طلبات عرض الإعلانات.

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.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 للإشارة إلى أنّك تريد أن يتم التعامل مع طلب عرض الإعلان على أنّه موجّه إلى المستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية. يمنع هذا أيضًا إرسال المعرّف الإعلاني على Android‏ (AAID).

  • استدعِ setTagForUnderAgeOfConsent() مع TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE للإشارة إلى أنّك تريد عدم التعامل مع طلب عرض الإعلان على أنّه موجّه إلى المستخدمين في المنطقة الاقتصادية الأوروبية (EEA) دون سن الرشد.

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

يشير المثال التالي إلى أنّك تريد تضمين مَعلمة TFUA في طلبات عرض الإعلانات:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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 = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

Publisher Privacy Treatment (إصدار تجريبي)

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

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

جمع الموقع الجغرافي التقريبي

يمكن لتطبيق "GMA Next-Gen SDK" جمع بيانات الموقع الجغرافي التقريبي لاستهداف الإعلانات استنادًا إلى الموقع الجغرافي للجهاز. إذا منح المستخدم إذن تحديد الموقع الجغرافي في تطبيقك، يجمع "GMA Next-Gen SDK" الموقع الجغرافي التقريبي.

بدءًا من الإصدار 1.7.0 من "GMA Next-Gen SDK"، يتم تفعيل ميزة جمع الموقع الجغرافي التقريبي تلقائيًا. يمكنك إيقاف جمع بيانات الموقع الجغرافي التقريبي باستخدام طريقة setCoarseLocationCollectionEnabled().

يؤدي المثال التالي إلى إيقاف جمع بيانات الموقع الجغرافي التقريبي:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Disable automatic coarse location collection by the SDK.
    .setCoarseLocationCollectionEnabled(false)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

جافا

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Disable automatic coarse location collection by the SDK.
        .setCoarseLocationCollectionEnabled(false)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

طلب عرض الإعلان

يجمع الكائن AdRequest معلومات الاستهداف لإرسالها مع طلب عرض الإعلان.

إضافة تفاصيل إضافية خاصة بالشبكة

التفاصيل الإضافية الخاصة بالشبكة هي تفاصيل إضافية يتم إرسالها مع طلب عرض الإعلان وتكون خاصة بمصدر إعلان واحد.

يضبط مقتطف الرمز التالي مفتاح مَعلمة إضافي لـ collapsible بقيمة bottom إلى Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

جافا

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);