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

اختيار النظام الأساسي: Android iOS Unity Android (الإصدار القديم)

ملاحظة: تتوفّر ميزة تصنيف مجموعات التوسّط حسب المفتاح/القيمة لعدد محدود من المستخدمين. تواصل مع مدير حسابك في Google لطلب إذن الوصول.

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

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

قبل البدء

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

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

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

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

تُصنِّف شرائح المستخدمين التالية حسب المدة التي يقضونها في أحد التطبيقات:

Kotlin

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

جافا

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

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

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

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

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