# firebase::gma::RequestConfiguration


`#include <types.h>`

Global configuration that will be used for every [AdRequest](https://developers.google.com/admob/cpp/reference/class/firebase/gma/ad-request#classfirebase_1_1gma_1_1_ad_request).

## Summary

Set the configuration via [SetRequestConfiguration](https://developers.google.com/admob/cpp/reference/namespace/firebase/gma#namespacefirebase_1_1gma_1add5fc03e6d996ce57faeeabd16d86d6f).

| ### Public types ||
|---|---|
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61{ https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61a54e05f425e43bd6ddf884b6e9fa919f4 = -1, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61a0c2944bca865f41d233496ea5c3d0105, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61aee7541d3afc7b03ead0fc5ec5d1bd4dc, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61a5e24c9ab4d5cd9b8a57e914fe9b1e1d0, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61a9057701879dcaa6d0752421b7e95cc23 }` | enumA maximum ad content rating, which may be configured via [max_ad_content_rating](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a3eaf00f4f8ba0aa1208e40276a1bd4a2). |
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50{ https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50a882437101730928b6dd950c696776e36 = -1, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50ad0202ab89ad55f6b300bd12ca81f0030, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50a0426a315b1c06acdb6d492ae46e8a101 }` | enumSpecify whether you would like your app to be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA). |
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200{ https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200aaca4f94a4790e0250786cf25d334db17 = -1, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200adda683ae51844dd880f3b0cf42e5ef70, https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200a52b7925117145843b580d29739c654a4 }` | enumConfiguration values to mark your app to receive treatment for users in the European Economic Area (EEA) under the age of consent. |

| ### Public attributes ||
|---|---|
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a3eaf00f4f8ba0aa1208e40276a1bd4a2` | `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a983586afe4b8e9180858f147e9e8fc61` Sets a maximum ad content rating. |
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a886267aa5db747c816f8441c53179195` | `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50` Allows you to specify whether you would like your app to be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA) - <http://business.ftc.gov/privacy-and-security/childrens-privacy>. |
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1ae900aeac5dbacbbba0247870ed42a795` | `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200` This value allows you to mark your app to receive treatment for users in the European Economic Area (EEA) under the age of consent. |
| `https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1ab6b956eed5680d685df7267ccefe89bd` | `std::vector< std::string >` Sets a list of test device IDs corresponding to test devices which will always request test ads. |

## Public types

### MaxAdContentRating

```c++
 firebase::gma::RequestConfiguration::MaxAdContentRating
```
A maximum ad content rating, which may be configured via [max_ad_content_rating](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a3eaf00f4f8ba0aa1208e40276a1bd4a2).

| Properties ||
|---|---|
| `kMaxAdContentRatingG` | Content suitable for general audiences, including families. |
| `kMaxAdContentRatingMA` | Content suitable only for mature audiences. |
| `kMaxAdContentRatingPG` | Content suitable for most audiences with parental guidance. |
| `kMaxAdContentRatingT` | Content suitable for teen and older audiences. |
| `kMaxAdContentRatingUnspecified` | No content rating has been specified. |

### TagForChildDirectedTreatment

```c++
 firebase::gma::RequestConfiguration::TagForChildDirectedTreatment
```
Specify whether you would like your app to be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA).

Values defined here may be configured via [tag_for_child_directed_treatment](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a886267aa5db747c816f8441c53179195).

| Properties ||
|---|---|
| `kChildDirectedTreatmentFalse` | Indicates that your app should not be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA). |
| `kChildDirectedTreatmentTrue` | Indicates that your app should be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA). |
| `kChildDirectedTreatmentUnspecified` | Indicates that ad requests will include no indication of how you would like your app treated with respect to COPPA. |

### TagForUnderAgeOfConsent

```c++
 firebase::gma::RequestConfiguration::TagForUnderAgeOfConsent
```
Configuration values to mark your app to receive treatment for users in the European Economic Area (EEA) under the age of consent.

Values defined here should be configured via [tag_for_under_age_of_consent](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1ae900aeac5dbacbbba0247870ed42a795).

| Properties ||
|---|---|
| `kUnderAgeOfConsentFalse` | Indicates the publisher specified that the ad request should not receive treatment for users in the European Economic Area (EEA) under the age of consent. |
| `kUnderAgeOfConsentTrue` | Indicates the publisher specified that the ad request should receive treatment for users in the European Economic Area (EEA) under the age of consent. |
| `kUnderAgeOfConsentUnspecified` | Indicates that the publisher has not specified whether the ad request should receive treatment for users in the European Economic Area (EEA) under the age of consent. |

## Public attributes

### max_ad_content_rating

```c++
MaxAdContentRating firebase::gma::RequestConfiguration::max_ad_content_rating
```
Sets a maximum ad content rating.

GMA ads returned for your app will have a content rating at or below that level.

### tag_for_child_directed_treatment

```c++
TagForChildDirectedTreatment firebase::gma::RequestConfiguration::tag_for_child_directed_treatment
```
Allows you to specify whether you would like your app to be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA) - <http://business.ftc.gov/privacy-and-security/childrens-privacy>.

If you set this value to [RequestConfiguration.kChildDirectedTreatmentTrue](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50a0426a315b1c06acdb6d492ae46e8a101), you will indicate that your app should be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA).

If you set this value to [RequestConfiguration.kChildDirectedTreatmentFalse](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50ad0202ab89ad55f6b300bd12ca81f0030), you will indicate that your app should not be treated as child-directed for purposes of the Children's Online Privacy Protection Act (COPPA).

If you do not set this value, or set this value to [RequestConfiguration.kChildDirectedTreatmentUnspecified](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1af443e316d761b48b3a011fc1b0969c50a882437101730928b6dd950c696776e36), ad requests will include no indication of how you would like your app treated with respect to COPPA.

By setting this value, 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]
> **Note:** : it may take some time for this designation to be fully implemented in applicable Google services.

<br />

### tag_for_under_age_of_consent

```c++
TagForUnderAgeOfConsent firebase::gma::RequestConfiguration::tag_for_under_age_of_consent
```
This value allows you to mark your app 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 all ad requests. 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 value to [RequestConfiguration.kUnderAgeOfConsentTrue](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200a52b7925117145843b580d29739c654a4), you will indicate that you want your app to be handled in a manner suitable for users under the age of consent.

If you set this value to [RequestConfiguration.kUnderAgeOfConsentFalse](https://developers.google.com/admob/cpp/reference/struct/firebase/gma/request-configuration#structfirebase_1_1gma_1_1_request_configuration_1a0da2ae73e7c75d8008b3de8a6d05b200adda683ae51844dd880f3b0cf42e5ef70), you will indicate that you don't want your app to be handled in a manner suitable for users under the age of consent.

If you do not set this value, or set this value to kUnderAgeOfConsentUnspecified, your app 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.

### test_device_ids

```c++
std::vector< std::string > firebase::gma::RequestConfiguration::test_device_ids
```
Sets a list of test device IDs corresponding to test devices which will always request test ads.