Skip to main content

UID2 GMA Plugin for Android Integration Guide

The UID2 Google Mobile Ads (GMA) Plugin for Android enables publishers that use the Google Mobile Ads (GMA) SDK to send UID2 tokens as secure signals in ad requests from Android apps. This is done automatically, with no direct coding needed from the app developer.

Functionality​

This plugin simplifies integration with Google Mobile Ads (GMA) for any publishers who want to support UID2 for apps running on Android devices.

Version​

This documentation is for the UID2 GMA Plugin for Android version 0.5.0 and later.

GitHub Repository​

This plugin is in the following open-source GitHub repository:

Requirements​

To run this plugin, install the following:

  1. Google Mobile Ads SDK v22.0.0 or later:
  2. UID2 SDK for Android v0.5.0 or later:
  3. UID2 Android GMA Plugin v0.5.0
  4. If you are using R8 or Proguard, add the applicable option specified in Notes for Using R8 or ProGuard

Installation​

Prerequisite: Install the Google Mobile Ads SDK and the UID2 SDK for Android.

Install the UID2 Android GMA Plugin v0.5.0 to an existing app with the UID2 SDK for Android and Google GMA SDK installed. There are two installation options:

Gradle​

To install with Gradle, add the SDK as a dependency in the build.gradle file:

implementation 'com.uid2:uid2-android-sdk-gma:0.5.0'

Maven​

To install with Maven, add the SDK as a dependency in the pom.xml file:

<dependency>
  <groupId>com.uid2</groupId>
  <artifactId>uid2-android-sdk-gma</artifactId>
  <version>0.5.0</version>
</dependency>

Notes for Using R8 or ProGuard​

If you are using R8, the shrinking and obfuscation rules are included automatically.

If you are using ProGuard, you must manually add the option specified in uid2-gma.pro.