Skip to content

Families program

If the target audience of your app includes children (exclusively or not), it must comply with Google Play’s Families Policy. Among other requirements, these apps can only use ads SDKs that are part of the Families Self-Certified Ads SDK Program.

For these apps, Wortise provides a dedicated artifact, android-sdk-families, that must be used instead of the standard android-sdk.

App target audienceArtifact
Children onlycom.wortise:android-sdk-families
Children and adults (mixed)com.wortise:android-sdk-families
Adults onlycom.wortise:android-sdk

The android-sdk-families artifact includes the SDK core and only the mediation adapters of ad networks that are part of the Families Self-Certified Ads SDK Program. Its minimum version is 1.8.1.

  1. Add the Wortise Maven repository inside the repositories block of the settings.gradle file. Unlike android-sdk, no other third-party repositories are needed:

    repositories {
    maven { url 'https://maven.wortise.com/artifactory/public' }
    }
  2. Add the android-sdk-families artifact inside the dependencies block of the app-level build.gradle file. If your app already uses android-sdk, replace it:

    implementation 'com.wortise:android-sdk-families:1.8.1'
  3. Mark the users who are minors, or whose age is unknown, and set the maximum ad content rating, before initializing the SDK:

    // true -> The user is a minor or the age is unknown
    // false -> The user is an adult
    AdSettings.setChildDirected(context, true)
    AdSettings.setMaxAdContentRating(context, AdContentRating.G)

    See the Privacy section for the available content ratings and the behavior of the SDK for child-directed users.

  4. If your app is directed only to children, remove the advertising ID permission added by the SDK, as Google Play does not allow these apps to declare it:

    <manifest xmlns:tools="http://schemas.android.com/tools">
    ...
    <uses-permission
    android:name="com.google.android.gms.permission.AD_ID"
    tools:node="remove" />
    </manifest>
  5. Complete the rest of the steps of the SDK integration guide (Manifest setup, initialization and ad formats), which are the same for both artifacts.

Do not add any other mediation adapter to your app unless its ad network SDK, and the version you use, appear in the Families Self-Certified Ads SDKs list.

  • The app depends on com.wortise:android-sdk-families (1.8.1 or higher), and not on com.wortise:android-sdk.
  • AdSettings.setChildDirected(context, true) is called before initializing the SDK for every user that is a minor or whose age is unknown.
  • The maximum ad content rating is G (apps directed primarily to children) or G / PG (mixed audience).
  • Apps directed only to children remove the AD_ID permission.
  • No mediation adapters of ad networks that are not self-certified by Google Play are included.