Targeting

Page Summary

The RequestConfiguration object is used to collect global configuration for ad requests and is applied using MobileAds.instance.updateRequestConfiguration().
The "tag for child-directed treatment" setting helps indicate if content should be treated as child-directed for COPPA compliance, disabling IBA and remarketing ads.
Ad requests can be marked for users under the age of consent in the EEA to facilitate GDPR compliance, disabling personalized advertising and requests to third-party vendors for that request.
Ad content ratings can be filtered using RequestConfiguration.maxAdContentRating() to control the content rating of ads returned.

Select platform: Android iOS Unity Flutter Android (Legacy)

The RequestConfiguration object collects the global configuration for every ad request and is applied by MobileAds.instance.updateRequestConfiguration().

To ensure that all ad requests apply the request configuration changes, update the request configuration before you Initialize Google Mobile Ads Flutter Plugin.

Set the age treatment

To help you manage your compliance with applicable privacy regulations related to children and teens, Google Mobile Ads Flutter Plugin provides an age treatment setting. The age treatment setting lets you indicate whether Google Mobile Ads Flutter Plugin should apply specific ad serving protections for children, teens, or an unspecified age.

You can set age treatment with the ageRestrictedTreatment property on the RequestConfiguration object.

The following example indicates that ad requests should receive child age treatment:

RequestConfiguration requestConfiguration = RequestConfiguration(
  // Indicates that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.child,
);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);request_configuration_snippets.dart

To indicate teen or an unspecified age treatment, replace the AgeRestrictedTreatment.child setting with the following:

AgeRestrictedTreatment.teen
AgeRestrictedTreatment.unspecified

When using the setting, Google Mobile Ads Flutter Plugin includes a tfat parameter in ad requests. Consult your legal counsel to determine the applicable age treatment for your users based on your legal and regulatory obligations. For more information, see Tag an ad request from an app for age restricted treatment.

Migrate to age treatment from TFCD and TFUA

The age treatment setting replaces the deprecated RequestConfiguration.tagForChildDirectedTreatment (TFCD) and RequestConfiguration.tagForUnderAgeOfConsent (TFUA) settings.

The following table shows the TFCD and TFUA settings and their age treatment equivalents:

TFCD

`TFCD`	Age treatment
`TagForChildDirectedTreatment.yes`	`AgeRestrictedTreatment.child`
`TagForChildDirectedTreatment.no`	`AgeRestrictedTreatment.unspecified`
`TagForChildDirectedTreatment.unspecified`	`AgeRestrictedTreatment.unspecified`
No value assigned	`AgeRestrictedTreatment.unspecified`
No equivalent	`AgeRestrictedTreatment.teen`

TFUA

`TFUA`	Age treatment
`TagForUnderAgeOfConsent.yes`	`AgeRestrictedTreatment.child`
`TagForUnderAgeOfConsent.no`	`AgeRestrictedTreatment.unspecified`
`TagForUnderAgeOfConsent.unspecified`	`AgeRestrictedTreatment.unspecified`
No value assigned	`AgeRestrictedTreatment.unspecified`
No equivalent	`AgeRestrictedTreatment.teen`

Understand age treatment interactions with TFCD and TFUA

If you set the age treatment setting and TFCD or TFUA settings, Google applies the most conservative treatment.

Child-directed setting

For purposes of the Children's Online Privacy Protection Act (COPPA), there is a setting called "tag for child-directed treatment."

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 through RequestConfiguration.tagForChildDirectedTreatment():

Use the argument TagForChildDirectedTreatment.yes to indicate that you want your content treated as child-directed for the purposes of COPPA.
Use the argument TagForChildDirectedTreatment.no to indicate that you don't want your content treated as child-directed for the purposes of COPPA.
Use the argument TagForChildDirectedTreatment.unspecified or do not set this tag 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:

final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

Users under the age of consent

You can 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. Learn more about how the GDPR affects publishers.

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.

The tag is set using RequestConfiguration.tagForUnderAgeOfConsent():

Use the argument TagForUnderAgeOfConsent.yes to indicate that you want the request configuration to be handled in a manner suitable for users under the age of consent.
Use the argument TagForUnderAgeOfConsent.no to indicates that you don't want the request configuration to be handled in a manner suitable for users under the age of consent.
Use the argument TagForUnderAgeOfConsent.unspecified or do not set this tag to indicate that you have not specified whether the ad request should receive treatment for users in the European Economic Area (EEA) under the age of consent. The following example indicates that you want TFUA included in your ad request:
```
final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForUnderAgeOfConsent: TagForUnderAgeOfConsent.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);
```

The tags to enable the Child-directed setting and setTagForUnderAgeOfConsent should not both simultaneously be set to true. If they are, the child-directed setting takes precedence.

Ad content filtering

Ad content ratings can be set using RequestConfiguration.maxAdContentRating():

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 can be one of the following MaxAdContentRating objects:

MaxAdContentRating.g
MaxAdContentRating.pg
MaxAdContentRating.t
MaxAdContentRating.ma

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

final RequestConfiguration requestConfiguration = RequestConfiguration(
  maxAdContentRating: MaxAdContentRating.g);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);