پیاده‌سازی تقسیم‌بندی کلید-مقدار

انتخاب پلاتفرم: Android iOS Unity Android (قدیمی)

بخش‌بندی کلید-مقدار به شما امکان می‌دهد هدف‌یابی سفارشی را برای بخش‌بندی کاربران ازطریق درخواست آگهی تعریف کنید. برای جزئیات مربوط به تقسیم‌بندی کلید-مقدار، مثل افزودن جفت کلید-مقدار در واسط کاربر AdMob، به افزودن تقسیم‌بندی کلید-مقدار به گروه میانجی‌گری مراجعه کنید.

این صفحه شما را در پیاده‌سازی تقسیم‌بندی کلید-مقدار هنگام پیکربندی درخواست آگهی بااستفاده از «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google برای iOS» راهنمایی می‌کند.

قبل‌از شروع

برای راه‌اندازی تقسیم‌بندی براساس مقدار کلید در برنامه‌تان، ابتدا باید تقسیم‌بندی براساس مقدار کلید را به گروه واسطه‌ای اضافه کنید.

جفت‌های کلید-مقدار را به درخواست آگهی پیوست کنید

پس‌از راه‌اندازی جفت‌های مقدار-کلید سفارشی در «میانای کاربری 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

آبجکتیو-سی

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"
  }
}