يتيح لك تصنيف المفتاح/القيمة تحديد استهداف مخصّص لتصنيف المستخدمين من خلال طلب عرض الإعلان. للاطّلاع على تفاصيل حول تصنيف المفتاح/القيمة، مثل إضافة زوج المفتاح/القيمة في واجهة مستخدم 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"
}
}