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

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

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

قبل البدء

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

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

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

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

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

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

Swift 

let daysInApp = 1

// Step 1: Create the key-value pair dictionary with custom targeting data.
let customTargeting: [String: String] = [
  "USER_DURATION": daysInApp < 3 ? "NEW" : "MATURE"
]

// Step 2: Create an ad request with custom targeting.
let request = GADRequest()
request.customTargeting = customTargeting

Objective-C 

int days_in_app = 1;

// Step 1: Create the key-value pair object with custom targeting data.
NSDictionary *customTargeting = @{
  @"USER_DURATION" : days_in_app < 3 ? @"NEW" : @"MATURE"
};

// Step 2: Create an ad request with custom targeting.
GADRequest *request = [GADRequest request];
request.customTargeting = customTargeting;

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

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

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

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