Help improve AdMob developer resources. Take this short survey today!

Targeting

This guide explains how to provide targeting information to an ad request.

To see ad targeting in action, download the Android API Demo app.

Download API Demo

Prerequisite

AdRequest

The AdRequest object collects targeting information to be sent with an ad request.

Gender

If your app already knows a user's gender, it can provide that information in the ad request for targeting purposes. The information is also forwarded to ad network mediation adapters if mediation is enabled.

Java

AdRequest request = new AdRequest.Builder()
        .setGender(AdRequest.GENDER_FEMALE)
        .build();

Kotlin

val request = AdRequest.Builder()
        .setGender(AdRequest.GENDER_FEMALE)
        .build()

Birthday

If your app already knows a user's birthday, it can provide that information in the ad request for targeting purposes. This information is also forwarded to ad network mediation adapters if mediation is enabled.

Java

AdRequest request = new AdRequest.Builder()
        .setBirthday(new GregorianCalendar(1985, 1, 1).getTime())
        .build();

Kotlin

val request = AdRequest.Builder()
        .setBirthday(GregorianCalendar(1985, 1, 1).time)
        .build()

Location

If a user has granted your app location permissions, AdMob automatically passes this location data to the SDK. The SDK uses this data to improve ad targeting without requiring any code changes in your app. You can, of course, enable or disable location data for ads.

Autopopulated location information is not forwarded to mediation networks and it may also be disabled entirely. Therefore, the SDK provides the ability to set location manually. You can specify location-targeting information in the AdRequest as follows:

Java

AdRequest request = new AdRequest.Builder()
        .setLocation(location)
        .build();

Kotlin

val request = AdRequest.Builder()
        .setLocation(location)
        .build()

The user's location should be obtained by a suitable method.

Out of respect for user privacy, Google asks that you specify location only if that information is already being used by your app.

Child-directed setting

For purposes of the Children's Online Privacy Protection Act (COPPA), there is a setting called "tag for child-directed treatment". By setting this tag, you certify that this notification is accurate and you are authorized to act on behalf of the owner of the app. You understand that abuse of this setting may result in termination of your Google account.

As an app developer, you can indicate whether you want Google to treat your content as child-directed when you make an ad request. If you indicate that you want Google to treat your content as child-directed, we take steps to disable IBA and remarketing ads on that ad request. The setting can be used with all versions of the Google Play services SDK via AdRequest.Builder.tagForChildDirectedTreatment(boolean):

  • Set tagForChildDirectedTreatment to true to indicate that you want your content treated as child-directed for purposes of COPPA.
  • Set tagForChildDirectedTreatment to false to indicate that you don't want your content treated as child-directed for purposes of COPPA.
  • Do not set tagForChildDirectedTreatment if you do not wish to indicate how you would like your content treated with respect to COPPA in ad requests.

The following example indicates that you want your content treated as child-directed for purposes of COPPA:

Java

AdRequest request = new AdRequest.Builder()
        .tagForChildDirectedTreatment(true)
        .build();

Kotlin

val request = AdRequest.Builder()
        .tagForChildDirectedTreatment(true)
        .build()

Ad content filtering

Apps can set a maximum ad content rating for their ad requests using the max_ad_content_rating network extra. AdMob ads returned for these requests have a content rating at or below that level. The possible values for this network extra are based on digital content label classifications, and should be one of the following strings:

  • G
  • PG
  • T
  • MA

The following code configures an AdRequest object to specify that ad content returned should correspond to a digital content label designation no higher than G:

Java

Bundle extras = new Bundle();
extras.putString("max_ad_content_rating", "G");

AdRequest request = new AdRequest.Builder()
        .addNetworkExtrasBundle(AdMobAdapter.class, extras)
        .build();

Kotlin

val extras = Bundle()

extras.putString("max_ad_content_rating", "G")

val request = AdRequest.Builder()
        .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
        .build()

Load an ad with targeting

Once your request targeting information is set, call loadAd() on the AdView with your AdRequest instance.

Java

AdRequest request = new AdRequest.Builder()
        .setGender(AdRequest.GENDER_FEMALE)
        .setBirthday(new GregorianCalendar(1985, 1, 1).getTime())
        .tagForChildDirectedTreatment(true)
        .build();
adView.loadAd(request);

Kotlin

val request = AdRequest.Builder()
        .setGender(AdRequest.GENDER_FEMALE)
        .setBirthday(GregorianCalendar(1985, 1, 1).time)
        .tagForChildDirectedTreatment(true)
        .build()
adView.loadAd(request)

See the AdMob Ad Targeting example for an implementation of ad targeting in the Android API Demo app.

Send feedback about...

Google Mobile Ads SDK for Android
Google Mobile Ads SDK for Android
Need help? Visit our support page.