الاستهداف

يوضّح هذا الدليل كيفية تقديم معلومات الاستهداف إلى "حزمة تطوير البرامج (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 Ad Manager 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 Ad Manager 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)

جافا

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

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

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

Kotlin

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

جافا

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

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

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

Kotlin

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

جافا

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

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

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

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

يشير المثال التالي إلى أنّك تريد تضمين مَعلمة 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);

مزيد من المعلومات عن ضبط التقييم حسب الفئة العمرية الأقصى للمحتوى لكل طلب عرض الإعلان

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

واجهة برمجة التطبيقات " المعالجة الموجّهة للخصوصية من الناشر " (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);

الاستهداف المخصّص

يمكنك تمرير أزواج مخصّصة من المفتاح/القيمة لاستهداف حملات (بنود الإعلان) "مدير إعلانات Google". يمرّر المثال التالي زوجًا مخصّصًا من المفتاح/القيمة في طلب عرض الإعلان:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

جافا

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

يمكنك تمرير قيم متعدّدة لمفتاح على شكل قائمة سلاسل. على سبيل المثال، لاستهداف الأشخاص في منتصف العشرينات من العمر بدلاً من استهداف الأشخاص البالغين من العمر 25 عامًا فقط.

Kotlin

.putCustomTargeting("age", listOf("24", "25", "26"))

جافا

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

استثناءات الفئات

يمكنك إضافة مستوى استبعاد فئة على مستوى الموضع إلى طلب باستخدام الـ addCategoryExclusion() طريقة:

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

جافا

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

يُرجى الاطّلاع على مثال استثناءات الفئات في "مدير إعلانات Google" لمعرفة كيفية تنفيذ استثناءات الفئات في تطبيق Android API Demo.

المعرّفات المقدَّمة من الناشر

يمكنك ضبط معرّف مقدَّم من الناشر (PPID) لاستخدامه في تحديد عدد مرات الظهور وتصنيف الجمهور إلى شرائح واستهدافه وعرض الإعلانات بالتناوب وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.

في ما يلي مثال على ضبط المعرّف المقدَّم من الناشر:

Kotlin

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

جافا

AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID")
    .setPublisherProvidedId("AB123456789")
    .build();

يُرجى الاطّلاع على مثال المعرّف المقدَّم من الناشر في مدير إعلانات Google لمعرفة كيفية تنفيذ المعرّفات المقدَّمة من الناشر في تطبيق Android API Demo.

الإشارات المقدَّمة من الناشر

يمكنك إرسال بيانات الجمهور والبيانات السياقية كـ إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلان. باستخدام الإشارات المقدَّمة من الناشر، يمكنك استخدام بيانات المستخدِم لتحسين تحقيق الربح آليًا من خلال إبلاغ مقدِّمي عروض الأسعار بخصائص جمهورك في جميع أنواع المعاملات، باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدِم. يمكن أن تتضمّن خصائص جمهورك بيانات سلوكية وبيانات تستهدف الاهتمامات (تصنيف جمهور IAB 1.1) وبيانات سياقية (تصنيف محتوى IAB 2.2).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

جافا

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

عنوان URL للمحتوى

لتوفير عنوان URL للمحتوى للإعلانات التي تستهدف المحتوى وأمان العلامة التجارية، يُرجى إضافة ما يلي:

Kotlin

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

جافا

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

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

يمكن للتطبيقات التي تعرض محتوًى ديناميكيًا موجّهًا إلى شرائح جمهور مختلفة توفير قائمة قصيرة بعناوين URL:

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .setNeighboringContentUrls(urls)
  .build()

جافا

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

تختلف .setNeighboringContentUrls() عن .setContentUrl() في أنّها تُستخدم فقط لأمان العلامة التجارية.