Enhance AdRequestOptions Extension Functions

[teogor]

This PR introduces enhancements to the extension functions for configuring AdRequestOptions related to ad content ratings and compliance with various app categories.

Changes Made

Refinement of Existing Extension Functions

The existing extension functions for configuring AdRequestOptions have been refined and extended to include additional scenarios. The following extension functions are now available:

• setForChildrenApp(): Configures options for apps designed specifically for children.
• setForFamilies(): Configures options for apps targeting families, with support for primarily child-directed and mixed-audience apps.
• setForEveryoneApp(): Configures options for apps targeting everyone, including children and families.
• setForTeens(): Configures options for apps targeting teens.
• setForAdults(): Configures options for apps targeting adults.

These extension functions provide a streamlined way to set the appropriate content rating and treatment options for ads, ensuring compliance with policies and regulations across different app categories.

How to Use

You can utilize the extension functions to configure AdRequestOptions for various app categories as needed. The method for configuring AdRequestOptions depends on your context:

• If you are within a Composable context, you can access the AdRequestOptions via LocalAdsControl.current:

  val adsControl = LocalAdsControl.current
  adsControl.adRequestOptions.apply {
    maxAdContentRating = AdContentRating.UNSPECIFIED
    tagForChildDirectedTreatment = TagForChildDirectedTreatment.UNSPECIFIED
    tagForUnderAgeOfConsent = TagForUnderAgeOfConsent.UNSPECIFIED
  }

• If you are outside of a Composable context, you can use AdMob.configureAdRequest:

  AdMob.configureAdRequest {
    maxAdContentRating = AdContentRating.UNSPECIFIED
    tagForChildDirectedTreatment = TagForChildDirectedTreatment.UNSPECIFIED
    tagForUnderAgeOfConsent = TagForUnderAgeOfConsent.UNSPECIFIED
  
    setForFamilies()         // Configure for apps targeting families
    setForChildrenApp()      // Configure for apps designed for children
    setForEveryoneApp()      // Configure for apps targeting everyone, including children and families
  }

Choose the appropriate method based on your context to configure AdRequestOptions for your application's specific requirements.

This allows you to easily set the appropriate ad content rating and treatment options for ads within your application.

[teogor]

New Features Added:

• Extension functions for AdRequestOptions to configure settings for different audience age groups.
• Updated documentation for the new functions.

Compliance with Google Play Service and AdMob Policies:

These extension functions have been designed to ensure compliance with Google Play Service and AdMob policies, especially with regard to the ad content rating and child-directed treatment settings. When using these functions, developers can be confident that their apps meet the required criteria for the specified audience age groups and adhere to both platform's policies.