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

Android 版プライバシー サンドボックスのベータ版プログラムでは、安定版の API が提供されます。ベータ版プログラムのリリースを使用して、すべての API については Android 13 以降のモバイル デバイス、Attribution Reporting API（ARA）については Android 12 以降のモバイル デバイスで限定的な製品版テストを行うためのソリューションを作成でき、テストできます。まずはごく一部のデバイスをサポートし、その後増やしていく予定です。組織で参加するには、限られた数のデバイスについてアクセスをリクエストし、プライバシー サンドボックスの 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 をご覧ください。

使ってみる

Android 向けプライバシー サンドボックスを使用するには、次の手順を行います。

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

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

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

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

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

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

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

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

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

設定を構成して、Android 版プライバシー サンドボックスをデバイスで実行（または無効）します。

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

Android 12 以前を搭載したデバイスで PP API 統合に関する既知の問題を回避するには、これらのデバイスの広告サービス 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 を使用して問題を報告し、フィードバックをお送りください。

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

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