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

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

این صفحه شما را در پیاده‌سازی بخش‌بندی کلید-مقدار هنگام پیکربندی درخواست آگهی بااستفاده از GMA Next-Gen SDK راهنمایی می‌کند.

قبل‌از شروع

برای راه‌اندازی بخش‌بندی کلید-مقدار در برنامه‌تان، ابتدا باید بخش‌بندی کلید-مقدار را به گروه میانجی‌گری اضافه کنید.

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

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

برای پیوست کردن جفت‌های کلید-مقدار به درخواست آگهی، 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"
  }
}