تقسیمبندی کلید-مقدار به شما امکان میدهد تا از طریق یک درخواست تبلیغ، هدفگیری سفارشی را برای تقسیمبندی کاربران تعریف کنید. برای جزئیات بیشتر در مورد تقسیمبندی کلید-مقدار، مانند اضافه کردن یک جفت کلید-مقدار در رابط کاربری AdMob، به بخش افزودن کلید-مقدار به یک گروه میانجی مراجعه کنید.
این صفحه شما را در پیادهسازی تقسیمبندی کلید-مقدار هنگام پیکربندی درخواست تبلیغ با استفاده از SDK اندروید تبلیغات موبایل گوگل راهنمایی میکند.
قبل از اینکه شروع کنی
برای تنظیم تقسیمبندی کلید-مقدار در برنامه خود، ابتدا باید تقسیمبندی کلید-مقدار را به یک گروه واسطه (mediation group) اضافه کنید .
جفتهای کلید-مقدار را به یک درخواست تبلیغ متصل کنید
پس از تنظیم جفتهای کلید-مقدار سفارشی خود در رابط کاربری AdMob، این جفتها را به یک درخواست تبلیغ در برنامه خود پیوست کنید.
برای اتصال جفتهای کلید-مقدار به یک درخواست تبلیغ، تابع putCustomTargeting() را با کلید و مقدار فراخوانی کنید.
مثال زیر کاربران را بر اساس مدت زمان حضور در یک برنامه تقسیمبندی میکند:
کاتلین
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"
}
}