يمكنك مشاركة ملاحظاتك حول "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة" في قناة #gma-next-gen-sdk على Discord في خادم Google Advertising and Measurement Community.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

الاستهداف

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

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

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

RequestConfiguration

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

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

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 إجراءات حماية معيّنة عند عرض الإعلانات للأطفال أو المراهقين. عند استخدام هذا الإعداد، GMA Next-Gen SDK تتضمّن مَعلمة tfat في طلبات الإعلانات. يُرجى الرجوع إلى مستشارك القانوني لتحديد السنّ المعمول به لمستخدميك استنادًا إلى التزاماتك القانونية والتنظيمية. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة وضع علامة على طلب عرض إعلان من تطبيق لمعالجة الطلبات حسب العمر.

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

ضبط المعالجة الموجّهة للأطفال

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

Kotlin

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

جافا

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

ضبط المعالجة الموجّهة للمراهقين

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

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جافا

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have teenage treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

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

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

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

جافا

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have unspecified age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

نقل البيانات إلى المعالجة الموجّهة للفئة العمرية من علامتَي 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 في طلبات الإعلانات.

يشير المثال التالي إلى أنّك تريد أن يتم التعامل مع محتواك على أنّه موجّه إلى الأطفال لأغراض قانون 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 (إصدار تجريبي)

واجهة برمجة التطبيقات Publisher Privacy Treatment (PPT) هي أداة اختيارية تتيح للتطبيقات الإشارة إلى ما إذا كان يجب إيقاف تخصيص الإعلانات لجميع طلبات الإعلانات باستخدام طريقة setPublisherPrivacyPersonalizationState(). عند استخدام هذه الميزة، يتم تضمين مَعلمة Publisher Privacy Treatment (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);

الاستهداف تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

RequestConfiguration

Kotlin

جافا

Kotlin

جافا

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

ضبط المعالجة الموجّهة للأطفال

Kotlin

جافا

ضبط المعالجة الموجّهة للمراهقين

Kotlin

جافا

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

Kotlin

جافا

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

TFCD

TFUA

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

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

Kotlin

جافا

المستخدمون دون سن الرشد

Kotlin

جافا

فلترة محتوى الإعلان

Kotlin

جافا

واجهة برمجة التطبيقات Publisher Privacy Treatment (إصدار تجريبي)

Kotlin

جافا

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

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

Kotlin

جافا

الاستهداف