Review Android version requirements

  • For apps using IMA SDK version 3.25.1 or higher, the Advertising ID permission is automatically declared and accessible when available.

  • Apps using IMA SDK version 3.24.0 or lower and targeting Android 13 must manually add the com.google.android.gms.permission.AD_ID permission to their AndroidManifest.xml file to access the Advertising ID.

  • On Android 12 and later, the advertising ID is zeroed out when users opt out of personalization, and the App Set ID provides a privacy-focused alternative for correlating usage across apps from the same organization.

  • IMA SDK version 3.25.1 and higher includes the App Set ID SDK by default to support analytics and fraud prevention when the advertising ID is unavailable.

Advertising ID

If your app uses the IMA SDK version 3.25.1 or higher, the SDK already automatically declares the com.google.android.gms.permission.AD_ID permission and is able to access the Advertising ID whenever it's available.

For apps that use the IMA SDK version 3.24.0 or lower and are targeting Android 13, you must add the com.google.android.gms.permission.AD_ID permission in the AndroidManifest.xml file for the Google Mobile Ads SDK to access the Advertising ID:

<manifest>
    <application>
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

        ...

    </application>
    <!-- For apps targeting Android 13 or higher & IMA SDK version 3.24.0 or lower -->
    <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
</manifest>

To learn more about the com.google.android.gms.permission.AD_ID permission declaration, including how to disable it, please refer to this Play Console article.

App Set ID

Starting with Android 12 devices, Google Play will zero out the advertising ID when a user opts out of personalization in their Android Settings. Google Play has also introduced the App Set ID, which offers a privacy-friendly way to correlate usage or actions across a set of apps owned by the same organization.

IMA version 3.25.1 or higher includes the App Set ID SDK by default. App Set ID is essential to support non ads use-cases such as analytics and fraud prevention, when the advertising ID is zeroed out. For more information on the App Set ID see this Android developer guide.