Known Direct Subclasses |
Builds an AdRequest
.
Public Constructor Summary
Builder()
Construct a
AdRequest.Builder .
|
Public Method Summary
AdRequest.Builder |
addCustomEventExtrasBundle(Class<? extends CustomEvent>
adapterClass, Bundle
customEventExtras)
Add extra parameters to pass to a specific custom event adapter.
|
AdRequest.Builder | |
AdRequest.Builder |
addNetworkExtras(NetworkExtras
networkExtras)
Add extra parameters to pass to a specific ad network adapter.
|
AdRequest.Builder |
addNetworkExtrasBundle(Class<? extends MediationExtrasReceiver>
adapterClass, Bundle
networkExtras)
Add extra parameters to pass to a specific ad network adapter.
|
AdRequest.Builder |
addTestDevice(String deviceId)
This method is deprecated. Use
RequestConfiguration.Builder.setTestDeviceIds(List) .
|
AdRequest | |
AdRequest.Builder | |
AdRequest.Builder |
setContentUrl(String contentUrl)
Sets the content URL for a web site whose content matches the app's primary
content.
|
AdRequest.Builder |
setGender(int gender)
This method is deprecated. No replacement.
|
AdRequest.Builder |
setHttpTimeoutMillis(int httpTimeoutMillis)
Sets a custom timeout for HTTPS calls made by the Google Mobile Ads SDK during
an ad request.
|
AdRequest.Builder |
setIsDesignedForFamilies(boolean isDesignedForFamilies)
This method is deprecated. Use Ad
Content Filtering.
|
AdRequest.Builder | |
AdRequest.Builder |
setMaxAdContentRating(String
maxAdContentRating)
This method is deprecated. See
RequestConfiguration.Builder.setMaxAdContentRating(String)
|
AdRequest.Builder |
setNeighboringContentUrls(List<String>
neighboringContentUrls)
Sets URLs representing web content near an ad.
|
AdRequest.Builder |
setRequestAgent(String
requestAgent)
Sets the request agent string to identify the ad request's origin.
|
AdRequest.Builder |
setTagForUnderAgeOfConsent(int tagForUnderAgeOfConsent)
This method is deprecated. See
RequestConfiguration.Builder.setTagForUnderAgeOfConsent(int)
|
AdRequest.Builder |
tagForChildDirectedTreatment(boolean tagForChildDirectedTreatment)
This method is deprecated. See
RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
|
Inherited Method Summary
Public Constructors
public Builder ()
Construct a AdRequest.Builder
.
Public Methods
public AdRequest.Builder addCustomEventExtrasBundle (Class<? extends CustomEvent> adapterClass, Bundle customEventExtras)
public AdRequest.Builder addKeyword (String keyword)
Add a keyword for targeting purposes.
public AdRequest.Builder addNetworkExtras (NetworkExtras networkExtras)
Add extra parameters to pass to a specific ad network adapter. The networkExtras
parameter should be an instance of com.google.ads.mediation.NetworkExtras
,
which is provided by ad network adapters.
Note that the NetworkExtras
class has been deprecated. This method is
included to maintain compatibility with older adapters.
public AdRequest.Builder addNetworkExtrasBundle (Class<? extends MediationExtrasReceiver> adapterClass, Bundle networkExtras)
public AdRequest.Builder addTestDevice (String deviceId)
This method is deprecated.
Use
RequestConfiguration.Builder.setTestDeviceIds(List)
.
Causes a device to receive test ads. The deviceId
can be obtained by
viewing the logcat output after creating a new ad.
This method should only be used while debugging. Be sure to remove all calls to this method before releasing your app.
public AdRequest.Builder setBirthday (Date birthday)
This method is deprecated.
No replacement.
Sets the user's birthday for targeting purposes.
public AdRequest.Builder setContentUrl (String contentUrl)
Sets the content URL for a web site whose content matches the app's primary content. This web site content is used for targeting and brand safety purposes.
Throws
NullPointerException | If contentUrl is {code null}. |
---|---|
IllegalArgumentException | If contentUrl is empty, or if its length exceeds 512. |
public AdRequest.Builder setGender (int gender)
This method is deprecated.
No replacement.
Sets the user's gender for targeting purposes. This should be AdRequest.GENDER_MALE
,
AdRequest.GENDER_FEMALE
,
or AdRequest.GENDER_UNKNOWN
.
public AdRequest.Builder setHttpTimeoutMillis (int httpTimeoutMillis)
Sets a custom timeout for HTTPS calls made by the Google Mobile Ads SDK during an ad request.
If your app uses mediation, this timeout does not apply to network calls made by third-party ad network SDKs.
Parameters
httpTimeoutMillis | An integer specifying the HTTPS timeout in milliseconds. Any values lower than
5000 (5 seconds) will be ignored. The default value is
60000 (60 seconds). |
---|
public AdRequest.Builder setIsDesignedForFamilies (boolean isDesignedForFamilies)
This method is deprecated.
Use Ad
Content Filtering.
This method allows apps that have opted into the Designed for Families program to specify whether a given ad request should return Designed for Families-compliant ads. Please note that the method is ONLY intended for apps that have opted into Designed for Families. Please see the Google AdMob help center article for more information about this setting.
If you set this value to true
, you indicate that your app requires that
the ad request should return a Designed for Families-compliant ad.
If you set this value to false
, you indicate that your app does not
require that the ad request should return a Designed for Families-compliant ad.
Note: This setting is separate from the Children's
Online Privacy Protection Act (COPPA) "tag for child directed treatment" setting.
For COPPA-related compliance, see
tagForChildDirectedTreatment(boolean)
.
public AdRequest.Builder setLocation (Location location)
Sets the user's location for mediation targeting purposes. This location data is not
used by Google for targeting, but is made available to mediation adapters via
MediationAdConfiguration.getLocation()
.
public AdRequest.Builder setMaxAdContentRating (String maxAdContentRating)
This method is deprecated.
See
RequestConfiguration.Builder.setMaxAdContentRating(String)
Set a maximum ad content rating. AdMob ads returned for these requests have a
content rating at or below that level. Valid values are AdRequest.MAX_AD_CONTENT_RATING_G
,
AdRequest.MAX_AD_CONTENT_RATING_PG
, AdRequest.MAX_AD_CONTENT_RATING_T
,
and
AdRequest.MAX_AD_CONTENT_RATING_MA
.
public AdRequest.Builder setNeighboringContentUrls (List<String> neighboringContentUrls)
Sets URLs representing web content near an ad. Promotes brand safety and allows displayed ads to have an app level rating (MA, T, PG, etc) that is more appropriate to neighboring content.
Parameters
neighboringContentUrls | The list of neighboring content URLs to be attached to the existing neighboring content URLs. |
---|
public AdRequest.Builder setRequestAgent (String requestAgent)
Sets the request agent string to identify the ad request's origin. Third party libraries that reference the Mobile Ads SDK should call this method to denote the platform from which the ad request originated. For example, if a third party ad network called "CoolAds network" mediates requests to the Mobile Ads SDK, it should call this method with "CoolAds".
public AdRequest.Builder setTagForUnderAgeOfConsent (int tagForUnderAgeOfConsent)
This method is deprecated.
See
RequestConfiguration.Builder.setTagForUnderAgeOfConsent(int)
This method allows you to mark your ad requests to receive treatment for users in the European Economic Area (EEA) under the age of consent. This feature is designed to help facilitate compliance with the General Data Protection Regulation (GDPR). Note that you may have other legal obligations under GDPR. Please review the European Union's guidance and consult with your own legal counsel. Please remember that Google's tools are designed to facilitate compliance and do not relieve any particular publisher of its obligations under the law.
When using this feature, a Tag For Users under the Age of Consent in Europe (TFUA) parameter will be included in the ad request. This parameter disables personalized advertising, including remarketing, for that specific ad request. It also disables requests to third-party ad vendors, such as ad measurement pixels and third-party ad servers.
If you set this method to
AdRequest.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
, you will indicate that you want
the ad request to be handled in a manner suitable for users under the age of
consent.
If you set this method to
AdRequest.TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
, you will indicate that you
don't want the ad request to be handled in a manner suitable for users under the age of
consent.
If you do not set this method, or set this method to
AdRequest.TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
, ad requests will include
no indication of how you would like your app to be handled in a manner suitable for
users under the age of consent.
public AdRequest.Builder tagForChildDirectedTreatment (boolean tagForChildDirectedTreatment)
This method is deprecated.
See
RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
This method allows you to specify whether you would like ad requests to be treated as child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA) - //business.ftc.gov/privacy-and-security/childrens-privacy.
If you set this method to true
, you will indicate that ad requests
should be treated as child-directed for purposes of the Children’s Online Privacy
Protection Act (COPPA).
If you set this method to false
, you will indicate that ad requests
should not be treated as child-directed for purposes of the Children’s Online Privacy
Protection Act (COPPA).
If you do not set this method, ad requests will include no indication of how you would like your app treated with respect to COPPA.
By setting this method, 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.
Note: it may take some time for this designation to be fully implemented in applicable Google services.
This designation will only apply to ad requests for which you have set this method.
Parameters
tagForChildDirectedTreatment | Set to true to indicate that your app should be treated as
child-directed. Set to false to indicate that your app should not be
treated as child-directed. |
---|