Android 向けプライバシー サンドボックスのスタートガイド

Android 版プライバシー サンドボックス ベータ版プログラムでは、安定した API を提供しています。2023 年を通してベータ版のリリースをいくつか予定しています。ベータ版プログラム リリースでは、Android 13 モバイル デバイスで限定的な製品版テストを行うためのソリューションを作成およびテストできます。まずはごく一部のデバイスをサポートし、徐々に増やしていく予定です。組織は参加するために、限られた数のデバイスについてアクセスをリクエストし、プライバシー サンドボックス API を使用するアプリを登録できます。

SDK ランタイムについては、デベロッパーがアプリを選択するためにランタイム対応の SDK ディストリビューションをテストできるクローズド ベータ版を用意しています。

ベータ版リリースを使用するには、API レベル 33 の SDK 拡張機能のアップデートでソリューションをコンパイルする必要があります。

Android SDK Extensions

ベータ版リリースの安定版 API は、新しい Android SDK Extensions のリリース方式を使用して提供されます。このリリース方式では、メジャー リリースとメジャー リリースの間に安定版の Android 機能をリリースできます。Google Play システム アップデートを使用して複数の API レベルでアプリが新しい API を利用できるようになる、新しいバージョニング メカニズムを備えています。Android 版プライバシー サンドボックスの SDK 拡張機能を Ad Services Extensions といいます詳しくは、Android SDK Extensions をご覧ください。

始める

まず、以下の手順を実施します。

ステップ 1: ベータ版プログラムに登録する

  • 登録: 広告関連の API を使用するには、登録プロセスを完了します。
  • 登録: ベータ版プログラムに参加するには、registerする必要があります。登録すると、次のことが可能になります。
    • 内部テスト用に独自のデバイスを有効にする。
    • プライバシー保護 API を直接統合できる、または API を使用する SDK ソリューションを統合できる、限られた数の Google Play ストア公開アプリを指定する。
    • Google Play ストアを使用してランタイム対応 SDK ディストリビューションをテストする。SDK ランタイムをデバイス上でテストするだけでよい場合、このステップは必要ありません。

ステップ 2: 開発環境をセットアップする

Android Studio で Android 版プライバシー サンドボックス SDK をセットアップします。

ステップ 3: AdServices 権限を構成する

対象の API で管理されているリソースへの API 固有の権限を宣言し、SDK アクセスを構成します。

ステップ 4: デバイスまたはエミュレータのイメージをセットアップする

エンドツーエンド テストを行うには、サポートされている Android 13 デバイスを操作するか、適切な SDK Extension のエミュレータ イメージを使用する必要があります。

ステップ 5: Android 版プライバシー サンドボックスを使用するようにデバイスを構成する

Android 版プライバシー サンドボックスをデバイスで実行できるように設定を構成します。

既知の問題のトラブルシューティング

Android 12 以前のデバイスでの PP API 統合に関する既知の問題を回避するには、Android 12 以前のデバイス向けの広告サービス API を統合するデベロッパーは、次のことを行う必要があります。

  1. クライアント アプリのマニフェスト ファイルに <uses-library> extservices タグが含まれていることを確認します。関連するタグは次のとおりです。
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. androidx.privacysandbox.ads Jetpack ライブラリを使用している場合は、バージョン 1.1.0-beta05 以降を使用していることを確認してください。

利用できるデベロッパー リソース

Android 版プライバシー サンドボックス ベータ版プログラムには、次のツールとリソースが含まれています。

SDK とエミュレータのシステム イメージ

Android Studio を使用すると、最新の Ad Services Extension とエミュレータのシステム イメージを SDK Manager からダウンロードできます。開発環境をセットアップする方法と API アクセスをセットアップする方法をご確認ください。

API リファレンス

API リファレンスの全文をご覧いただけます。

サポートとフィードバック

Android 版プライバシー サンドボックスでテストと開発を行う際は、リリースノートを確認し、Issue Tracker を使用して問題を報告し、フィードバックをお送りください。

開発環境を最新の状態に保つ

最新のリリースで開発環境を最新の状態に保つことを強くおすすめします。これにより、最新の機能とセキュリティ パッチが適用され、環境が依存関係の最新バージョンと互換性を持つことが保証されます。新しいリリースに関する通知を受け取るには、最新情報メールに登録してください。