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

Android 版プライバシー サンドボックス ベータ版プログラムでは、安定版の API が提供されます。私たちは 2023 年中にいくつかのベータ版リリースを計画しています。ベータ版プログラムをご利用いただけます リリースを使用して、Android での限定的な本番環境テストのためのソリューションを構築およびテストする 13 台のモバイル デバイス。まずはごく一部のデバイスと 徐々に数を増やしていきます。組織が参加するには、アクセスをリクエストして 登録できます。また、 プライバシー サンドボックス 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 を使用する。
  • 登録: ベータ版プログラムに参加するには、登録する必要があります。 登録すると、次のことが可能になります。 <ph type="x-smartling-placeholder">
      </ph>
    • 内部テスト用に独自のデバイスを有効にする。
    • プライバシー保護 API を直接統合できる、または API を使用する SDK ソリューションを統合できる、限られた数の Google Play ストア公開アプリを指定する。
    • Google Play ストアを使用してランタイム対応 SDK ディストリビューションをテストする。SDK ランタイムをデバイス上でテストするだけでよい場合、このステップは必要ありません。

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

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

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

API 固有の権限を宣言して SDK アクセスを構成する ターゲット API によって管理されるリソースです。

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

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

ステップ 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 を使用して問題を報告し、フィードバックを送信してください。

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

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