الاستهداف

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى "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 الإعدادات الأكثر تحفّظًا.

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

بموجب قانون حماية خصوصية الأطفال على الإنترنت (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:

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

  • استخدِم الدالة 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 (PPT) هي أداة اختيارية تتيح للتطبيقات تحديد ما إذا كان سيتم إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات باستخدام الطريقة 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);

طلب الإعلان

يجمع الكائن 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);