Implement key-value segmentation

Key-value segmentation lets you define custom targeting to segment users through an ad request. For details on key-value segmentation, such as adding a key-value pair in the AdMob UI, see Add key-value segmentation to a mediation group.

This page guides you through implementing key-value segmentation when configuring an ad request using Google Mobile Ads SDK for React Native.

Before you begin

To set up key-value segmentation in your app, you must first add key-value segmentation to a mediation group.

Attach key-value pairs to an ad request

After setting up your custom key-value pairs in the AdMob UI, attach the pairs to an ad request in your application.

Set the customTargeting property on the AdRequest object to a key-value record representing your custom targeting data.

The following example segments users by duration in an app:

const daysInApp = 1;

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  customTargeting: {
    USER_DURATION: daysInApp < 3 ? 'NEW' : 'MATURE',
  },
};

Test the key-value segmentation setup

To test your implementation on custom key-value pairs, send an ad request and check the response info object. Verify that the value of the mediation_group_name field matches your expected mediation group name.

The following example verifies a mediation group name in the ad response:

{
  "responseId": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "responseExtras": {
    "mediation_group_name": "Mediation group for new users"
  }
}