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

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

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

توضّح لك هذه الصفحة كيفية تنفيذ تصنيف المفتاح/القيمة عند إعداد طلب عرض الإعلان باستخدام حزمة Google Mobile Ads iOS SDK.

قبل البدء

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

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

بعد إعداد أزواج المفتاح/القيمة المخصّصة في واجهة مستخدِم 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"
  }
}