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

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

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

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

قبل‌از شروع

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

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

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