GoogleMobileAds Framework Reference

GADRequestConfiguration

@interface GADRequestConfiguration : NSObject

Request configuration. The settings in this class will apply to all ad requests.

  • The maximum ad content rating. All Google ads will have this content rating or lower.

    Declaration

    Swift

    var maxAdContentRating: GADMaxAdContentRating? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) GADMaxAdContentRating maxAdContentRating;
  • Identifiers corresponding to test devices which will always request test ads. The test device identifier for the current device is logged to the console when the first ad request is made.

    Declaration

    Swift

    var testDeviceIdentifiers: [String]? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) NSArray<NSString *> *testDeviceIdentifiers;
  • [Optional] This property indicates whether the user is under the age of consent. https://developers.google.com/admob/ios/targeting#users_under_the_age_of_consent.

    If you set this property with @YES, a TFUA parameter will be included in all ad requests, and you are indicating that you want ad requests to be handled in a manner suitable for users under the age of consent. This parameter disables personalized advertising, including remarketing, for all ad requests. It also disables requests to third-party ad vendors, such as ad measurement pixels and third-party ad servers.

    If you set this property with @NO, you are indicating that you don’t want ad requests to be handled in a manner suitable for users under the age of consent.

    If you leave or reset this property as nil or unknown, ad requests will include no indication of how you would like your ad requests to be handled in a manner suitable for users under the age of consent.

    Declaration

    Swift

    @NSCopying var tagForUnderAgeOfConsent: NSNumber? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) NSNumber *tagForUnderAgeOfConsent;
  • [Optional] This property indicates whether you would like your app to be treated as child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA), https://www.ftc.gov/business-guidance/privacy-security/childrens-privacy.

    If you set this property with @YES, you are indicating that your app should be treated as child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA).

    If you set this property with @NO, you are indicating that your app should not be treated as child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA).

    If you leave or reset this property as nil or unknown, ad requests will include no indication of how you would like your app treated with respect to COPPA.

    By setting this property, 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.

    Declaration

    Swift

    @NSCopying var tagForChildDirectedTreatment: NSNumber? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) NSNumber *tagForChildDirectedTreatment;
  • Controls whether the Google Mobile Ads SDK publisher first-party ID, formerly known as the same app key, is enabled. The value set persists across app sessions. The key is enabled by default.

    Declaration

    Swift

    func setPublisherFirstPartyIDEnabled(_ enabled: Bool)

    Objective-C

    - (void)setPublisherFirstPartyIDEnabled:(BOOL)enabled;