メインコンテンツまでスキップ

UID2 IMA Plugin for Android integration guide

UID2 Interactive Media Ads (IMA) Plugin for Android は、Google IMA SDK for Android を使用するパブリッシャーが、Android アプリからの広告リクエストで UID2 Token を Secure Signals として送信できるようにします。これは自動的に行われるため、アプリ開発者が直接コーディングする必要はありません。

Functionality​

このプラグインは、Android 端末で動作するアプリの UID2 をサポートしたいパブリッシャー向けに、Google Interactive Media Ads(IMA) とのインテグレーションを簡素化します。

Version​

このドキュメントは、UID2 IMA Plugin for Android version 2.0.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, client-server, or server-side integration? を参照してください。

Requirements​

このプラグインを実行するには、以下をインストールします:

  1. Google IMA SDK v3.30.3 or later:
  2. SDK for Android v2.0.0 or later:
  3. UID2 IMA Plugin for Android v2.0.0
  4. R8 または Proguard を使用している場合は、Notes for using R8 or ProGuard に指定された適用オプションを追加します。

Installation​

前提条件: Google Interactive Media Ads SDK と SDK for Android をインストールします。

SDK for Android と Google IMA SDK がインストールされている既存のアプリに、UID2 Android IMA Plugin をインストールします。インストールオプションは2つあります:

Gradle​

Gradle でインストールするには、build.gradle ファイルに依存関係として SDK を追加します:

implementation 'com.uid2:uid2-android-sdk-ima:2.0.0'

Maven​

Maven でインストールするには、pom.xml ファイルに依存関係として SDK を追加します:

<dependency>
  <groupId>com.uid2</groupId>
  <artifactId>uid2-android-sdk-ima</artifactId>
  <version>2.0.0</version>
</dependency>

Notes for using R8 or ProGuard​

R8 を使用している場合、縮小と難読化のルールは自動的に含まれます。

ProGuard を使用している場合は、uid2-gma.pro で指定されたオプションを手動で追加する必要があります。