تنفيذ تقسيم القيم الأساسية

يتيح لك تصنيف المفتاح/القيمة تحديد استهداف مخصّص لتصنيف المستخدمين من خلال طلب عرض الإعلان. للاطّلاع على تفاصيل حول تصنيف المفتاح/القيمة، مثل إضافة زوج المفتاح/القيمة في واجهة مستخدم AdMob، يُرجى الاطّلاع على المقالة إضافة تصنيف المفتاح/القيمة إلى مجموعة توسّط.

ترشدك هذه الصفحة إلى كيفية تنفيذ تصنيف المفتاح/القيمة عند ضبط طلب عرض إعلان باستخدام GMA Next-Gen SDK.

قبل البدء

لإعداد تصنيف المفتاح/القيمة في تطبيقك، عليك أولاً إضافة تصنيف المفتاح/القيمة إلى مجموعة توسّط.

إرفاق أزواج المفتاح/القيمة بطلب عرض الإعلان

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

لإرفاق أزواج المفتاح/القيمة بطلب عرض إعلان، يمكنك استدعاء putCustomTargeting() باستخدام المفتاح والقيمة.

يصنّف المثال التالي المستخدمين حسب مدة استخدام التطبيق:

Kotlin

val daysInApp = 1
val request = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

جافا

int daysInApp = 1;
AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
    .putCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

اختبار إعداد تصنيف المفتاح/القيمة

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

يتحقّق المثال التالي من اسم مجموعة توسّط في استجابة الإعلان:

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}