SDK for Android Reference Guide

Android SDK を使用すると、UID2 を使用したクライアント ID の生成または確立、bidstream 用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。

以下の Android 関連プラグインと関連ドキュメントも利用可能です。

Purpose	Product/Documentation
Google Mobile Ads (GMA) SDK を使用して、Android アプリからの広告リクエストで UID2 token を Secure Signals として送信するには、次の手順に従います。	UID2 GMA Plugin for Android Integration Guide
Google Interactive Media Ads (IMA) SDK for Android を使用して、Android アプリからの広告リクエストで UID2 token を Secure Signals として送信するには、次の手順に従います。	UID2 IMA Plugin for Android Integration Guide

モバイルパブリッシャーインテグレーションに関する FAQs については、FAQs for Mobile Integrations を参照してください。

Non-Mobile Android Device Support

この SDK for Android は、Android プラットフォームの非モバイルデバイスにも使用できます。

Functionality

この SDK は、Android デバイス上で動作するアプリで UID2 をサポートしたいパブリッシャー向けに、UID2 とのインテグレーションを簡素化します。次の表に、この SDK がサポートする機能を示します。

Encrypt Raw UID2 to UID2 Token for Sharing	Decrypt UID2 Token to Raw UID2	Generate UID2 Token from DII	Refresh UID2 Token	Map DII to Raw UID2s	Monitor Rotated Salt Buckets
—	—	✅	✅	—	—

SDK for Android は、Android アプリに代わって UID2 ID を生成または管理するように設計されています。プラットフォームネイティブの暗号化ツールを使って ID をデバイス上に安全に保存することで、アプリのライフサイクル全体にわたって UID2 ID を持続させることができます。

デフォルトでは、SDK は有効期限に基づいて UID2 ID を自動的にリフレッシュします。ただし、これを無効にして、実装アプリが UID2 ID のライフサイクルを手動で管理できるようにすることもできます。

UID2 Account Setup

UID2 とのインテグレーションを行うには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、まず Account Setup ページの手順に従ってください。

API Permissions

初期アカウント設定が完了すると、UID2 Portal にアクセスするための手順とリンクが送信されます。以下の操作を行うことができます:

• アカウント用の credentials を生成します。
• オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。
• オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。

UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、Server-Side のいずれであるかによって異なります。モバイルインテグレーションオプションの概要については、Client-Side, Client-Server, or Server-Side Integration? を参照してください。

SDK Version

このドキュメントは、SDK for Android バージョン 1.6.0 以降用です。

リリースノートの情報については、https://github.com/IABTechLab/uid2-android-sdk/releases を参照してください。

GitHub Repository/Binary

この SDK は以下のオープンソースの GitHub リポジトリにあります:

• https://github.com/IABTechLab/uid2-android-sdk

バイナリは Sonatype で公開されています:

• https://central.sonatype.com/artifact/com.uid2/uid2-android-sdk

Minimum Requirements

To consume the binary package of this SDK in your app:

• 最低限のターゲット Android バージョン: 4.4+ / API 19+ (SDK) 5.0+

開発アプリ (Client-Side Integration Guide for Mobile を参照) を実行するか、ソースコードからバイナリをビルドするには、次の最小要件が必要です:

• code repository (記載されている agp バージョンを参照) で指定されている UID2 SDK に必要な Android Gradle Plugin (AGP) バージョンを確認し、対応する Android Studio バージョンが必要かどうかを確認してください。
• 最低限のターゲット Android バージョン: 4.4+ / API 19+ (SDK) 5.0+ / API 21+ (Dev-App)

Installation

Android UID2 SDK をインストールするには、2 つの方法があります:

• Gradle

• Maven

Installing with Gradle

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

implementation 'com.uid2:uid2-android-sdk:1.6.0'

Installing with Maven

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

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

Usage Guidelines

UID2Manager シングルトンは、SDK for Android の主要な開発者 API です。UID2 Token を含む UID2 Identity の保存、リフレッシュ、取得を行います。

UDI2Manager シングルトンは使用前に初期化する必要があります。なぜなら:

• 後でのアクセスが容易になるからです。
• 消費アプリケーションがリクエストを行うためのネットワークインスタンスを提供できる可能性があるからです。

初期化は、アプリケーションインスタンスの作成時に行うことができます。次の例を参照してください:

class MyApplication : Application() {
  override fun onCreate() {
    super.onCreate()
   // Initialize the UID2Manager class. Use DefaultNetworkSession rather than providing our own
   // custom implementation. This can be done to allow wrapping something like OkHttp.
   UID2Manager.init(this.applicationContext)

最初の UID2 Identity を確立する方法は 2 つあります:

1. DII を使用して UID2 ID を生成します—メール (ハッシュ化または非ハッシュ化) または電話番号 (ハッシュ化または非ハッシュ化) を使用します。インテグレーション手順については、Client-Side Integration Guide for Mobile を参照してください。

2. Server-Side で UID2 ID を生成し、それを UID2 SDK に渡します。インテグレーション手順については、Client-Server Integration Guide for Mobile を参照してください。

UID2 Mobile SDK は、UID2 identifier が確立された後に UID2 identities をリフレッシュできます。これは、リフレッシュ機能が UID2 Identity の一部である Refresh Token に依存しているためです。

Code Samples

以下のコードサンプルは、SDK for Android を使用して具体的なアクティビティを実行する例を示しています。

初期の UID2 Identity を生成します (Client-Side Integration Guide for Mobile を参照):

UID2Manager.getInstance().generateIdentity(
    identityRequest: IdentityRequest,
    subscriptionId: String,
    publicKey: String,
    onResult: (GenerateIdentityResult) -> Unit
)

UID2 Identity を設定します (Client-Server Integration Guide for Mobile を参照):

UID2Manager.getInstance().setIdentity(identity: UID2Identity)

Advertising SDK に渡す UID2 Token (Advertising Token) を取得します:

UID2Manager.getInstance().getAdvertisingToken()

UID2Manager API

このセクションには、UID2Manager APIの一部である関数と変数が含まれています。

Functions

UID2Manager API の一部として利用可能な関数は次のとおりです:

• generateIdentity()
• setIdentity()
• resetIdentity()
• refreshIdentity()
• getAdvertisingToken()
• setAutomaticRefreshEnabled()

generateIdentity()

D直接識別情報 (DII) を使用して UID2 Identity を生成します。手順については、Client-Side Integration Guide for Mobile の Client-Side Integration Guide for Mobile を参照してください。

setIdentity()

SDK が管理する、Server-Side で作成された UID2 Identity を設定します。詳細は、Client-Server Integration Guide for Mobile の Configure the UID2 Mobile SDK を参照してください。

resetIdentity()

SDK が管理している UID2 Identity をリセットまたは削除します。

refreshIdentity()

SDK が管理している UID2 Identity を手動でリフレッシュします。

getAdvertisingToken()

現在の UID2 Identity が有効である場合、この関数は UID2 Token (Advertising Token) を返します。

setAutomaticRefreshEnabled()

自動リフレッシュ機能の有効/無効を切り替えます。

Variables

UID2Manager API の一部として利用可能な変数は次のとおりです:

• identity
• identityStatus

identity

Identity 変数は、SDK が管理している現在の UID2 Identity を格納し、返します。

identityStatus

identityStatus 変数は、SDK が管理している現在の UID2 Identity のステータスを格納し、返します。