このページは Cloud Translation API によって翻訳されました。

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

Android 版プライバシーサンドボックスベータ版プログラムでは、安定版の API が提供されます。私たちは 2023 年中にいくつかのベータ版リリースを計画しています。ベータ版プログラムをご利用いただけますリリースを使用して、Android で限定的な本番環境テストを実施するためのソリューションを構築およびテストするすべての API は 13 台以上のモバイルデバイス、Attribution Reporting API（ARA）は Android 12 以降。まずはごく一部のデバイスのサポートを開始し、その数を徐々に増やしていきます。組織で参加するには、限られた数のデバイスについてアクセスをリクエストし、プライバシーサンドボックスの API を利用するアプリをすべて登録します。

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

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

Android SDK Extensions

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

始める

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

ステップ 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 Extension のエミュレータイメージを使用する必要があります。

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

プライバシーを有効化（または無効化）するための設定を行う Android 版サンドボックスをデバイスで実行する。

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

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

クライアントアプリのマニフェストファイルに <uses-library> extservices タグが含まれていることを確認します。関連するタグは次のとおりです。

<uses-library
  android:name="android.ext.adservices"
  android:required="false" />

androidx.privacysandbox.ads jetpack ライブラリを使用している場合は、バージョン 1.1.0-beta05 以降を使用していることを確認してください。

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

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

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

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

API リファレンス

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

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

Android 版プライバシーサンドボックスでテストや開発を行う際には、リリースメモをご覧ください。また、Issue Tracker を使用して問題を報告し、フィードバックを送信してください。

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

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

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