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

UID2 Mobile Integration Overview for Android and iOS

このガイドは、SDK for Android または SDK for iOS を使用して UID2 とインテグレーションしたいモバイルアプリのパブリッシャー向けのインテグレーションオプションの概要です。

注記

このガイドの、UID2 mobile SDKs は、SDK for Android と SDK for iOS の両方を含むグループ用語です。

Introduction​

UID2 は、Android/iOS 向けの SDK を提供しており、次の機能をサポートしています:

  • UID2 Token の生成
  • UID2 Token のリフレッシュ
  • UID2 Token の保存

さらに、UID2 は、一部の機能に対して代替手段を提供し、UID2 Google GMA/IMA プラグインなどの補完製品も提供しています。利用可能なオプションは、個々のガイドで説明されています: Integration Overview: High-Level Steps を参照してください。

Integrating with Single Sign-On (SSO)​

シングルサインオン(SSO)プロバイダーとのインテグレーションに関する情報は、Publisher Integration with SSO Providers を参照してください。

Integration Overview: High-Level Steps​

UID2 mobile SDK を使用してモバイルアプリを UID2 とインテグレーションするには、次の手順を完了する必要があります:

  1. UID2 アカウントのセットアップを完了します。

  2. Client-Server インテグレーションのみ: Server-Side でのトークン生成をインテグレーションします。

  3. SDK for Android または iOS をモバイルアプリにインテグレーションします。

  4. SDK を構成します。

  5. トークンが正常に生成されたことを確認し、ビッドストリームで使用するためにトークンを渡します。

  6. オプションで、Google GMA SDK および Google IMA SDK とのインテグレーションに UID2 GMA/IMA プラグインを構成します。

詳細は、次のガイドを参照してください:

Mobile Integration Paths​

モバイルシナリオに最適なインテグレーションパスを決定するには、次の点を考慮してください:

  1. UID2 Token を Client-Side または Server-Side で取得しますか？ Client-Side, Client-Server, or Server-Side Integration? を参照してください。

  2. UID2 Token の取得とリフレッシュ何を使いますか？ Generating, Storing, and Refreshing the UID2 Token を参照してください。

  3. UID2 Token をどのように使いたいですか？ Sending the Token to the Bidstream を参照してください。

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? を参照してください。

Client-Side, Client-Server, or Server-Side Integration?​

UID2 mobile SDK を使用して UID2 とインテグレーションするためのオプションは、次の表にまとめられています。最適な Integration approach を選択してください。

詳細は、Integration Approaches を参照してください。

ScenarioOptionIntegration Guide
Client Side/モバイルアプリ内で DII（メールアドレスまたは電話番号）にアクセス可能であり、変更内容をアプリ内のみで保持したい。Client-Side integrationUID2 Client-Side Integration Guide for Mobile
You have access to DII on the server side only and can do the necessary development to generate UID2 tokens server-side, but you want to refresh tokens on the client side—or you are using a Private Operator.Client-Server IntegrationUID2 Client-Server Integration Guide for Mobile
You have access to DII on the server side only and can do the necessary development to generate UID2 tokens server-side, or you are using a Private Operator.Server-Side IntegrationUID2 Server-Side Integration Guide for Mobile

Generating, Storing, and Refreshing the UID2 Token​

以下の表は、UID2 Token の生成、保存、リフレッシュを管理するためのモバイルインテグレーションオプションをまとめたものです。各オプションのドキュメントへのリンクが含まれています。

UID2 Mobile Implementation OptionSDK DocImplementation Guide
UID2 Android SDKSDK for Android Reference Guide以下のいずれか:
UID2 iOS SDKSDK for iOS Reference Guide以下のいずれか:

Sending the Token to the Bidstream​

UID2 Token をビッドストリームに送信する方法はいくつかあります。

以下の表は、UID2 がサポートするオプションをまとめたものです。

ScenarioIntegration Guide
Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を Android アプリにインテグレーションしたい以下の順番で:
  1. UID2 GMA Plugin for Android Integration Guide
  2. 以下のいずれか:
Google GMAを使用して、動画、バナー、インタースティシャル、ネイティブ広告を iOS アプリにインテグレーションしたい以下の順番で:
  1. UID2 GMA Plugin for iOS Integration Guide
  2. 以下のいずれか:
Google IMA を使用して、Android アプリにマルチメディア広告をインテグレーションしたい以下の順番で:
  1. UID2 IMA Plugin for Android Integration Guide
  2. 以下のいずれか:
Google IMA を使用して、iOS アプリにマルチメディア広告をインテグレーションしたい以下の順番で:
  1. UID2 IMA Plugin for iOS Integration Guide
  2. 以下のいずれか:
Prebid Mobile SDK と Prebid Server を使用して、Android または iOS アプリから広告リクエストを送信したい以下のいずれか:

Functionality Summary​

以下の表は、さまざまなインテグレーションオプションで利用可能な機能をまとめたものです。

すべてのオプションは、Client-Side または Server-Side インテグレーションをサポートしています。

Implementation OptionGenerate Token from DIIRefresh TokenAndroid/iOS?Send Token to Bidstream
UID2 SDK for Android✅✅Android*
UID2 SDK for iOS✅✅iOS*
GMA Plugin for Android
(Requires UID2 SDK for Android)		——Android✅**
GMA Plugin for iOS
(Requires UID2 SDK for iOS)		——iOS✅**
IMA Plugin for Android
(Requires UID2 SDK for Android)		——Android✅**
IMA Plugin for iOS
(Requires UID2 SDK for iOS)		——iOS✅**
UID2 Integration with Prebid Mobile SDK——Either✅***

*SDK を IMA/GMA プラグインまたは Prebid Mobile SDK と組み合わせて、Google または Prebid Server を介してトークンをビッドストリームに送信するか、SDK からトークンを手動で取得して別の方法でビッドストリームに渡すことができます。

**セットアップ後、Google GMA/IMA はトークンを自動的に収集し、ビッドストリームに送信します。

***セットアップ後、Prebid Mobile SDK はトークンを広告リクエストに追加して Prebid Server に送信します。

FAQs for Mobile Integrations​

UID2 モバイルインテグレーションに関する FAQ 情報は次のとおりです:

iOS: Can I use Swift Package Manager and CocoaPods/Podspec together?​

iOS: Swift Package Manager と CocoaPods/Podspec を併用できますか？

UID2 Mobile インテグレーションには、UID2 Mobile SDK、UID2 GMA プラグイン、UID2 IMA プラグインを Swift Package Manager または CocoaPods でインストールできます。

推奨事項:

  • すでに CocoaPods を使用している場合、特に Google Ad Frameworks を自分でインテグレーションしている場合は、UID2 SDK を CocoaPods を使用してインテグレーションすることが最適です。
  • 依存関係のインテグレーションが初めての場合、または Swift Package Manager ですでに依存関係がある場合は、UID2 モバイルインテグレーションには Swift Package Manager を使用することを推奨します。
注意

すでに CocoaPods を使用している場合、UID2 SDK とプラグインを Swift Package Manager (SPM) を使用してインテグレーションしても、アプリが UID2 SDK とプラグインを使用することを妨げるものではありません。ただし、潜在的な競合があります。すでに CocoaPods で GMA をインストールしている場合、その後 UID2 Mobile SDK を Swift Package Manager でインストールすると、実装に GMA の 2 つのコピーが含まれるため、動作しません。

したがって、すでに GMA をインストールしていて UID2 をインストールする場合は、まず CocoaPods から GMA を削除してください。

ヒント

Podspec は、CocoaPods 内のファイル名で、アプリにインテグレーションするライブラリを定義するものです。

Troubleshooting Tips for Mobile Integrations​

UID2 モバイルインテグレーションのトラブルシューティングに役立つ追加情報です:

Android SDK Cannot Connect in Production Environment​

Android SDK が本番環境に接続できない

トラブルシューティングの最初のステップは、ヘルスチェックエンドポイントを確認することです。

モバイルデバイスまたは Android エミュレータから、このエンドポイントに到達できるかどうかを確認してください:

https://prod.uidapi.com/ops/healthcheck

レスポンスは OK である必要があります。

エラーレスポンスは、アプリが UID2 エンドポイントに到達できないネットワークの問題を示す場合があります。たとえば:

  • Caused by java.net.UnknownHostException: Unable to resolve host "prod.uidapi.com": No address associated with hostname

    SDK はバックグラウンドで UID2 Token をリフレッシュしようとします。IOException などのエラーが発生した場合、SDK は複数回リトライします。リトライが成功しない場合、この例外が表示されます。

ログを有効にすると、別のトラブルシューティングステップが可能になります。詳細は、Enable Logging を参照してください。