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 を使用するには、登録プロセスを完了する必要があります。
  • 登録: ベータ版プログラムに参加するには、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 統合に関する既知の問題を回避するため、これらのデバイスで広告サービス 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 を使用して問題を報告し、フィードバックをお送りください。

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

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