يتيح لك تصنيف المفتاح/القيمة تحديد استهداف مخصّص لتصنيف المستخدِمين من خلال طلب عرض إعلان. للاطّلاع على تفاصيل تصنيف المفتاح/القيمة، مثل إضافة زوج من المفتاح/القيمة في واجهة مستخدِم AdMob، يُرجى الاطّلاع على مقالة إضافة تصنيف المفتاح/القيمة إلى مجموعة توسّط.
توضّح لك هذه الصفحة كيفية تنفيذ تصنيف المفتاح/القيمة عند ضبط طلب عرض إعلان باستخدام حزمة SDK لإعلانات Google على الأجهزة الجوّالة لنظام Android.
قبل البدء
لإعداد تصنيف المفتاح/القيمة في تطبيقك، عليك أولاً إضافة تصنيف المفتاح/القيمة إلى مجموعة توسّط.
إرفاق أزواج المفتاح/القيمة بطلب عرض إعلان
بعد إعداد أزواج المفتاح/القيمة المخصّصة في واجهة مستخدِم 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"
}
}