UID2 GMA Plugin for Android Integration Guide
UID2 Google Mobile Ads (GMA) Plugin for Android は、Google Mobile Ads (GMA) SDK を使用するパブリッシャーが、Android アプリからの広告リクエストで UID2 token を secure signals として送信できるようにします。これは自動的に行われるため、アプリ開発者が直接コーディングする必要はありません。
Functionality
このプラグインは、Android 端末で動作するアプリで UID2 をサポートしたいパブリッシャー向けに、Google Mobile Ads (GMA) とのインテグレーションを簡素化します。
Version
このドキュメントは、UID2 GMA Plugin for Android バージョン 1.6.0 以降用です。
GitHub Repository
このプラグインは以下のオープンソースの GitHub リポジトリにあります:
Complete UID2 Account Setup and Configure Account
UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず Account Setup ページの手順に従ってください。
アカウントの初期設定が完了すると、UID2 Portal にアクセスするための手順とリンクが送信されます。ここで、本番環境用の credentials を作成し、必要に応じて追加の値を設定できます。詳細については、Getting Started with the UID2 Portal を参照してください。
UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。各実装ガイドに具体的な手順が記載されています。概要については、Client-Side or Client-Server Integration? を参照してください。
Requirements
このプラグインを実行するには、以下 をインストールします:
- Google Mobile Ads SDK v22.0.0 or later:
- SDK for Android v1.6.0 or later:
- UID2 Android GMA Plugin v1.6.0
- R8 または Proguard を使用している場合は、Notes for Using R8 or ProGuard に指定された適用オプションを追加します。
Installation
前提条件: Google Mobile Ads SDK と SDK for Android をインストールしてください。
SDK for Android と Google IMA SDK がインストールされている既存のアプリに、UID2 Android GMA Plugin v1.6.0 をインストールします。インストール方法は 2 つあります:
Gradle
Gradle でインストールするには、build.gradle
ファイルに依存関係として SDK を追加します:
implementation 'com.uid2:uid2-android-sdk-gma:1.6.0'
Maven
Maven でインストールするには、pom.xml
ファイルに依存関係として SDK を追加します:
<dependency>
<groupId>com.uid2</groupId>
<artifactId>uid2-android-sdk-gma</artifactId>
<version>1.6.0</version>
</dependency>
Notes for Using R8 or ProGuard
R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。
ProGuard を使用している場合は、uid2-gma.pro で指定されたオプションを手動で追加する必要があります。