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

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

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

قبل البدء

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

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

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

1. أنشئ عنصرًا من نوع زوج مفتاح/قيمة يمثّل بيانات الاستهداف المخصّص.

2. اضبط السمة CustomTargeting لطلب عرض الإعلان على هذا العنصر.

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

var daysInApp = 1;

// Step 1: Create the key-value pair dictionary with custom targeting data.
var customTargeting = new Dictionary<string, string> {
  ["USER_DURATION"] = daysInApp < 3 ? "NEW" : "MATURE",
};

// Step 2: Create an ad request with custom targeting.
var request = new AdRequest() {
  CustomTargeting = customTargeting,
};

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

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

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

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