Android 版プライバシー サンドボックス リリースノート

Android 版プライバシー サンドボックスには、デベロッパー プレビューとベータ版プログラムがあります。今後、デベロッパー プレビューに新しい API と機能を順次導入し、安定版の API をベータ版プログラムに昇格させる予定です。フィードバックをお寄せください

Android 版プライバシー サンドボックスを初めて使用する場合は、まずプログラムの概要をご確認ください。プロジェクトにプライバシー サンドボックスを組み込むには、開発環境をセットアップし、テストデバイスまたはエミュレータで Android 版プライバシー サンドボックスを入手します。

現行のリリース

Android VanillaIceCream プレビュー

Protected Audience API

  • 認証済みのコンテキスト広告を Protected Auction に渡す機能 が追加されました。また、すでにインストールされている デバイスのほか、クリック数、インプレッション数、視聴回数、 どちらにするかです実装が以前のイテレーションと異なるのは、コンテキスト 広告テクノロジーによる署名が必要です。実装方法を確認する デベロッパー ガイドをご覧ください。
  • ContextualAds の名前を SignedContextualAds に変更し、関連するゲッターと AdSelectionConfig の settergetPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • 未認証のコンテキスト アプリが渡された場合は、 オークション

Attribution Reporting API

2023 年 11 月の Android 版プライバシー サンドボックスのベータ版アップデート

Android 版プライバシー サンドボックス ベータ版のこのリリースには、 一般公開の Android 14 デバイス上のプライバシー サンドボックス APISDK とデバイス イメージは、 Android Studio の SDK Manager を使用して Android API 34 としてダウンロードできます。 拡張レベル 10。機能的にデベロッパー プレビューと類似しています。 9 に変更されていますが、いくつかの重要な変更があります。

Protected Audience API

  • 広告テクノロジーは、カスタム オーディエンス委任を使用してカスタム オーディエンスに参加できるようになりました。 オーディエンスを、デバイス上に存在していない購入者に代わって配信できる可能性があります。
  • Android では、入札サービスとオークション サービスでのオークションの実行がサポートされるようになりました。
  • Protected Audience のオークションは CPC 課金に対応しています。
  • Protected Audience のオークションとレポートでデータ バージョン ヘッダーがサポートされるようになりました 信頼できる入札シグナルを確認できます
  • Protected Audience のオークションでは、WIN イベントのフリークエンシー キャップ フィルタリングがサポートされています。
  • Protected Audience で Attribution Reporting API との統合

Attribution Reporting API

SDK ランタイム

  • SDK ランタイム内の他の SDK を SDK から読み込んでサポートする機能 メディエーションのユースケース

過去のリリース

デベロッパー プレビュー 10

リリース日: 2023 年 12 月 19 日

既知の制限事項

  • Google Play 開発者サービスが ユーザーに繰り返し通知します。 <ph type="x-smartling-placeholder">
      </ph>
    • デバイスを再起動すると、この問題が緩和される場合があります。
    • テスト中に非同期呼び出しのタイムアウトが発生する場合は、 しきい値を長くするために、次の adb コマンドを追加してみてください タイムアウトまで:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • 実機のみ: Google アカウントを追加することはできません。フォロー デバイスをホーム画面に移動する手順は次のとおりです。 <ph type="x-smartling-placeholder">
      </ph>
    • プレビュー画像をスマートフォンにインストールします。
    • Wi-Fi やモバイルデータに接続せずに、セットアップ ウィザードに沿って操作します。
    • ホーム画面が表示されたら、Wi-Fi またはモバイルデータに接続します。
    • デバイスを再起動します。

Protected Audience API

  • 新機能 [Protected App Signals][dp98] を導入します。 関連性の高いアプリ インストール広告の配信をサポートします。この DP では 広告テクノロジーで以下のことを可能にする API <ph type="x-smartling-placeholder">
      </ph>
    • 保護されたデバイス上のストレージにアプリイベントを保存することでシグナルをキュレートする。 関連性の高いアプリ インストール広告を配信できる。
    • 入札およびオークション サービスで Protected Auction を実行する それぞれのシグナルにアクセスできる高信頼実行環境 広告選択と入札に役立ちます

Attribution Reporting API

  • このバージョンの Attribution Reporting API: <ph type="x-smartling-placeholder">
      </ph>
    • Protected Audience の統合が追加され、カスタム オーディエンスが可能になります ディメンションを使用できます。
    • 集約サービスの TEE として Google Cloud プロバイダをサポートします。
    • クロスネットワークのデバッグをサポートするために shared_debug_key フィールドを追加 リダイレクトなしのアトリビューションです
    • 詳細デバッグ レポート リクエストにバージョン ヘッダーが追加されました。

On-Device Personalization(デバイス上のパーソナライズ)

  • 研究者向けの初回リリースと早期開発。
  • On-Device Personalization で、プロダクトをカスタマイズする革新的な方法が導入されます エンドユーザーのプライバシー保護を強化します。オンデバイス パーソナライズでは、一連のサービスとアルゴリズムが、 これには以下が含まれますが、これらに限定されません。 <ph type="x-smartling-placeholder">
      </ph>
    • トレーニング、評価、パーソナライズを可能にする連携コンピューティング(FC) 学習しました。On-Device Personalization による連携の使用 コンピューティングはモデルのトレーニングと(必要に応じて)推論に基づいて行われます。
    • データ間でのデータの照合やクロスマッチは 分散しているからです
    • 新しい手法を使用したスパースモデルの差分プライベート(DP)トレーニング たとえば、DP 交互最小化(さまざまな ビルボード DP の下でのモデルのパーソナライズ。

デベロッパー プレビュー 9

リリース日: 2023 年 8 月 15 日

既知の制限事項

  • Bidding and Auction API を呼び出して生成されたオークション データは削除されません 自動的に適用されます。
  • 同意が得られた場合に getAdSelectionDatapersistAdSelectionResult を呼び出す プロセスがクラッシュします。
  • 除外フィルタ機能が getAdSelectionData で動作しない および persistAdSelectionResult

Protected Audience API

Attribution Reporting API

  • このリリースでは、Attribution Reporting API のデバッグ レポートが次のように改善されています。 <ph type="x-smartling-placeholder">
      </ph>
    • 詳細デバッグ レポートのサポート web をご覧ください。
    • ウェブとアプリ間のアトリビューションのデバッグ レポートを有効にする(両方の広告 ID が必要) ウェブやアプリの登録など)が含まれます。
  • 広告テクノロジーは、さまざまなレポート シナリオに合わせてノイズ パラメータを構成できます。
  • このリリースはオリジンベースのアトリビューションに移行します。 <ph type="x-smartling-placeholder">
      </ph>
    • オリジンは登録に使用されます。
    • 1 つのサイトの複数のオリジンを使用できます。
    • 新しいレート制限(ソースアプリまたは登録ごとに 1 つのオリジン)
  • 広告テクノロジーが Attribution Reporting の使用をテストできるよう登録を無効にできるようになりました ローカルでケースに対応します

SDK ランタイム

  • SDK はサービスの許可リストの開始またはバインドのみできます。
  • SDK がアクセスできるのは、システムの ContentProvidercom.android.providers.settings.SettingsProvider)、 識別子がなく、ユーザーのフィンガープリントの作成には使用できません。これらの このチェックは、ContentResolver を使用した ContentProvider へのアクセスにも適用されます。
  • SDK がアクセスできるのは、保護されたブロードキャスト レシーバのサブセット( android.intent.action.AIRPLANE_MODE など)。
  • SDK は別のアプリに属するアクティビティを起動できますが、 渡す必要があります。

Android 版プライバシー サンドボックスの 2023 年 3 月ベータ版アップデート

2023 年 3 月リリースの Android 版プライバシー サンドボックス ベータ版には、公開されている Android 13 デバイスのプライバシー サンドボックス API の更新が含まれています。このリリースには Ad Services Extensions 5 API が含まれており、機能的にはデベロッパー プレビュー 6 と似ていますが、いくつかの主な違いがあります。

既知の制限事項

  • FLEDGE のカスタム オーディエンスを更新するため定期的に実行されるバックグラウンドの取得ジョブにより、プロセスがクラッシュします。この問題により、FLEDGE はデフォルトで無効になっています。

全般

  • このリリースでは Attribution Reporting API をご利用いただけます。この API は、以前は無効になっていました。以前のベータ版リリースで Attribution Reporting API を使用していた場合は、次のいずれかの手順でこのベータ版リリースを使用する前にアプリまたはデバイスのデータを消去します。
    • デバイスまたはエミュレータで設定に移動し、テストに使用するアプリの、キャッシュだけではなくアプリ固有のストレージを消去します。
    • 実機またはエミュレートしたデバイスで出荷時の設定にリセットします。
    • エミュレートしたデバイスでは、Wipe Data 関数を実行します。
  • アトリビューション レポートでデバッグキーがサポートされるようになりました。これにより、デベロッパーは Attribution API から未変更のレポートとプライバシーが強化されたレポートを受け取れます。デバッグキーを使用すると、プライバシー サンドボックスに移行する間、レポートの構造を明確に把握できます。
  • アトリビューション レポートで最近、registerSourceregisterTrigger が例外で失敗する広告サービスのバグが発生しました。開発中にこの問題が発生したとしても、修正がリリース済みであり、時間の経過とともに解決するはずです。
  • Topics API のプレビュー機能は、Android 版プライバシー サンドボックスのデベロッパー プレビューと同等になりました。Topics API の呼び出し元は、週ごとのエポック計算にトピックの取得呼び出しを含めることなくトピックをプレビューできます。呼び出し元の参照されたトピックのリストに影響することもありません。詳細については、shouldRecordObservation フィールドをご覧ください。
  • Android 版 FLEDGE でテストを有効にするには、ベータ版プログラムに登録し、その同じ Google アカウントを使用してテストデバイスにログインします。そうしないと、API を呼び出そうとしても「サービスは利用できません」というメッセージとともに IllegalStateException が発生します。FLEDGE は次のベータ版リリースで復旧するはずです。

    それまでの間はデベロッパー プレビューを使用してテストを続行することをおすすめします。また、デバイスで FLEDGE を手動で有効にすることもできますが、以下の点に注意してください。

    FLEDGE は、次の adb コマンドを使用して有効にできます。ただし、バックグラウンドの取得プロセスがクラッシュすると、システムの健全性の指標に悪影響を及ぼします。これらの値はプラットフォームによってリセットされる可能性があるため、永続的な解決策ではありません。

    adb shell device_config set_sync_disabled_for_tests persistent
    adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
    adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
    adb shell device_config put adservices fledge_background_fetch_enabled true

過去のリリース

デベロッパー プレビュー 8

リリース日: 2023 年 5 月 23 日

既知の制限事項

  • 一方、WIN タイプのフリークエンシー キャップ フィルタは Protected Audience に追加できます WIN タイプはまだサポートされていません。このタイプのフィルタは 無視されます。
  • Protected Audience を落札した購入者に落札インプレッションを報告する 購入者をプライバシー サンドボックスに登録する必要がある。この要件 オーバーライドできません。
  • プライバシー サンドボックスに対応したデバイスでプライバシー サンドボックスの設定にアクセスするには [設定] >Google >広告 >プライバシー サンドボックス
  • Android Studio Giraffe では、エミュレータを使用してプロジェクトをデプロイできません。他のバージョン 正常に動作するはずです修正が Android Studio にロールアウトされます キリン(2023 年 5 月 26 日)。

Protected Audience API

Attribution Reporting API

SDK ランタイム

デベロッパー プレビュー 7

リリース日: 2023 年 1 月 26 日

FLEDGE on Android API

  • 次の JavaScript メソッドで、パラメータ custom_audience_signals の名前が変更されました。
    • generateBid() の名前が custom_audience_bidding_signals に変更されました。
    • scoreAd() の名前が custom_audience_scoring_signals に変更されました。
    • reportWin() の名前が custom_audience_reporting_signals に変更されました。
  • このリリースでは、AdSelectionFromOutcomeConfig を取得して selectAds の結果を比較する新しい selectAds オーバーライドが追加されました。これにより、この API を使用する広告テクノロジー SDK がウォーターフォール メディエーションを実行できるようになります。詳しくは、デベロッパー ガイドをご覧ください。
  • selectAds() API で、広告選択プロセスで取得される入札とスコアリングのロジック JavaScript のキャッシュ保存がサポートされるようになりました。
    • キャッシュは、JavaScript での取得呼び出し時にサーバーから返される Cache-Control ヘッダーで制御できます。JavaScript レスポンスがキャッシュに保存されないようにするには、no-cache または no-store を使用して、キャッシュ期間を制御する max-age を使用します。
    • 現在のキャッシュ エントリ max-age はデフォルトで 2 日間に設定されます。

Android API のアトリビューション レポート

  • このリリースでは、registerSource()registerTrigger() のデイジー チェーン リダイレクトのサポートが追加されました。API コンシューマは、サーバー レスポンスとして HTTP リダイレクトを使用できるようになりました。

ベータ版の初期リリース: 2023 年 1 月

リリース日: 2023 年 1 月 9 日

Android 版プライバシー サンドボックス ベータ版 1 でプライバシーが初めて利用可能に 公共デバイスでのサンドボックス API と、次にリストする領域の改善

全般

  • Android 版プライバシー サンドボックス ベータ版 1 はデベロッパー プレビュー 5 と機能的に同等ですが、次の機能と制限事項が追加されています。
  • 広告関連の API(Topics、FLEDGE、Attribution Reporting など)を利用するには、デベロッパーは登録プロセスを完了する必要があります。登録プロセスでは、デベロッパー ID を検証し、API に必要なデベロッパー固有のデータを収集します。
  • Android 版プライバシー サンドボックス ベータ版 1 リリースでは、 詳細を登録し、許可リストに送信すると、オポチュニティを獲得できる 独自の物理デバイスでテストできますこのリリースに含まれる安定版の API を対象とした開発を行うには、新しい SDK Ad Services Extensions 4 をダウンロードしてください。

Topics API

Attribution Reporting API

  • Attribution Reporting は無効になっており、このリリースでは使用できません。この API へのアクセスは、次回のベータ版リリースで再び有効になります。引き続きデベロッパー プレビューを使ってテストすることをおすすめします。

SDK ランタイム

以下の制限事項は、Android プラットフォームの次回のメジャー リリースで修正される予定です。

  • 現在、RecyclerView などのスクロール可能なビュー内での広告レンダリングは正しく機能しません。要素のサイズが変更されたとき、ジャンクが発生することがあります。ユーザーのタッチ スクロール イベントがランタイムに正しく渡されません。
  • WebView レンダリングは SDK ランタイム プロセスで利用できません。
  • SDK ごとのストレージは利用できません。
  • getAdId API と getAppSetId API のサポートはまだ有効になっていません。

デベロッパー プレビュー 6

リリース日: 2022 年 10 月 31 日

Android 版プライバシー サンドボックス デベロッパー プレビュー 6 では、以下の点が改善されました。

全般

  • 製品版の公開に備えて、デベロッパー プレビュー 6 では、プライバシー保護 API アクセスをデフォルトで無効にするフラグが導入されました。テスト目的で、デベロッパー プレビューで次のコマンドを実行して、プライバシー保護 API アクセスを有効にします。

    adb shell device_config put adservices global_kill_switch false
    
  • AdIdManager API と AppSetIdManager API には、Google Play 開発者サービス バージョン 22.36.16 以降が必要です。

    • Android 搭載デバイスで、[設定] > [アプリ] > [Google Play 開発者サービス] に適切なバージョンが表示されていることを確認します。
    • Google Play 開発者サービスを適切なバージョンに更新する必要がある場合は、ログインしてください Google アカウントを使用して Android テストデバイスまたはエミュレータでテストする必要があります。次に、Google Play ストア > プロフィール アイコン > [設定] > [概要] に移動します。「Play ストアのバージョン」という見出しの下にある [Play ストアを更新] をタップします。
    • このステップは開発とテストの場合にのみ適用されます。プライバシー サンドボックスが一般ユーザー向けにロールアウトされた後は必要ありません。

Topics API

  • getTopics をオブザーバーとして登録するかどうかを切り替えるための Preview API を追加しました。
  • GetTopicsRequest クラスの初期化コードの軽微な変更。
  • Topics 統合ガイドをリリースしました。

FLEDGE on Android API

  • 実際のサーバーに対してテストを行う場合、API の有効化が必須になりました。こちらの手順に沿ってデバイスを構成してください。サンプルアプリにあるリモート オーバーライドを使用している場合、この手順は必要ありません。
  • 互換性を破る変更:
    • パラメータの UrlUri に置き換えました。これは、入札とスコアリングのロジックに関して、すべての FLEDGE API とカスタム JavaScript に適用されます。
    • Custom Audience API の入力から owner フィールドを削除しました。
  • 不完全なカスタム オーディエンスは直ちにバックグラウンド更新の対象となるようになりました。
  • JavaScript のメモリ上限を 10 MB に設定しました。これは、入札とスコアリングのロジックに適用されます。

Attribution Reporting API

  • デベロッパー プレビュー 6 で Attribution Reporting API を使用するには、広告テクノロジーの事前登録が必要です。詳しくは、プライバシー サンドボックス アカウントの登録をご覧ください。
  • このリリースでデバッグキーが導入されるため、デベロッパーは、プライバシーが強化されたレポートとともに、未変更のレポートを Attribution Reporting API から受け取れます。デバッグキーを使用すると、プライバシー サンドボックスに移行する間、レポートの構造を明確に把握できます。

デベロッパー プレビュー 5

全般

  • デベロッパー プレビュー 5 でプライバシー サンドボックス API にアクセスするには、まず API を有効にして API 固有の権限を構成する必要があります。
    • Android 版プライバシー サンドボックスは、デバイス上でプライバシー保護 API と SDK ランタイムをアクティブにするかどうかをユーザーが制御できるように設計されています。これらの設定は、デベロッパー プレビュー 5 ではデフォルトで無効に設定されています。API へのアクセスは、adb コマンドを使用して有効にできます。
    • 呼び出し元アプリは、埋め込み SDK のアクセスを制御するマニフェストおよび関連する AdServices 構成で API 固有の権限を指定する必要があります。
  • フォアグラウンドで実行されている場合、アプリはプライバシー保護 API を呼び出す必要があります。
  • AdIdManagerAppSetIdManager は現在運用されていません。今後のリリースで有効になる予定です。

SDK ランタイム

  • sendData() は今後のバージョンで非推奨になります。
  • loadSdk() が、ランタイム対応の SDK と AIDL で定義されたアプリの間の双方向通信を容易にする IBinder オブジェクトを返すようになりました。
  • アプリは、追加のランタイム対応 SDK ライフサイクル イベントにアクセスできます。 たとえば SDK プロセスが終了したときなどです

Attribution Reporting API

このリリースで、Attribution Reporting API に次の機能が追加されました。

  • 暗号化された集計レポートのサポート。
  • アプリとウェブにわたる測定のサポート
  • ソースとトリガーの登録レスポンスの統合されたヘッダー。
    • ソース: Attribution-Reporting-Register-Aggregatable-SourceAttribution-Reporting-Register-Source の一部になりました。
    • トリガー: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-DataAttribution-Reporting-Register-Aggregatable-ValuesAttribution-Reporting-Register-Event-Trigger という名前の単一のヘッダーに統合されました。
    • Attribution-Reporting-Redirects は別のヘッダーのままです。

FLEDGE on Android API

このリリースには、いくつかの新機能と改善のほか、互換性を破る変更が含まれています。

  • 互換性を破る変更:
    • runAdSelection() の名前が selectAds() に変更されました。
    • AdSelectionConfig.Builder.setAdSelectionSignals() のパラメータが、JSON オブジェクトを表す AdSelectionSignals に置き換えられました。
    • 広告テクノロジーの購入者 / 販売者を表す String の使用が AdTechIdentifier オブジェクトに置き換えられました。
    • リモートの JavaScript 取得をオーバーライドするための TestCustomAudienceManager クラスと TestAdSelectionManager クラスが追加されました。
    • カスタム オーディエンスのオーナーは、呼び出し元アプリのパッケージ名である必要があります。
  • FLEDGE API は、デベロッパー ガイドに記載されている一連の制限事項に照らして呼び出し元アプリを検証するようになりました。その内容は次のとおりです。 いくつか注目すべき例があります。
    • selectAdsreportImpression の実行時間に制限が設定されました。時間が経過すると呼び出しが終了します。
    • selectAdsreportImpression で、JavaScript の実行時に消費されるメモリが制限されるようになりました。メモリの消費量が構成された上限を超えると、API がエラーをスローします。
    • selectAdsreportImpressionAdSelectionConfig オブジェクトを検証し、フィールドが構文的に有効で、URL が販売者フィールドで使用されている eTLD+1 にあることを確認するようになりました。
    • AdServices がカスタム オーディエンスを作成時に検証するようになりました。この検証の一部には、有効期限が有効であることの確認が含まれ、アプリが作成できるカスタム オーディエンスの数と joinCustomAudience の呼び出しで指定される広告の合計サイズに制限が適用されます。検証では、 により、シグナルおよび入札ロジックの取得および入札ロジックの取得用に提供された URI が、 バックグラウンド取得はすべて購入者のドメインで 行われます
  • カスタム オーディエンス メタデータは、バックグラウンド取得プロセスによって毎日更新されます。
  • カスタム オーディエンスは、「オーナー」がアプリがアンインストールされます。
  • 広告選択時に信頼できるスコアリング シグナルと信頼できる入札データを指定するためのサポートを追加しました。レスポンスの形式については、コードサンプルを参照してください。
  • Android 版 FLEDGE の API は、WebView バージョン 105.0.5195.58 以降に依存します。詳しくは、デベロッパー ガイドの設定情報をご覧ください。
  • 既知の問題:

    • 現在、カスタム オーディエンスに参加すると、プラットフォームで何も行われない メタデータまたは AdData 値のいずれかがあると、すぐにバックグラウンドで更新されます。 空または null です。このカスタム オーディエンスは広告掲載の対象になりません 1 日後に更新されるまで そのまま残ります今後のリリースでは、不完全なカスタム オーディエンスはすぐにバックグラウンド取得更新の対象となります。JavaScript 実行用の現在のデフォルト メモリ上限は低すぎるため、通常のワークロードでデバイスの JavaScriptEngine がクラッシュする可能性があります。JavaScript の実行がエラー メッセージ "Fatal javascript OOM in CALL_AND_RETRY_LAST" で予期せず終了することがあります。

      次のコマンドで適切なメモリしきい値を構成することで、これを手動で解決できます。

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
      
    • 必要な JSON 構造と一致しないカスタム オーディエンス広告は、バックグラウンド取得時に更新されます。

Topics API

  • モバイルアプリの分類に関して、分類を更新しました。
  • 割り当て済みのトピックを表示できる設定 UI のリリースに伴い、設計提案サンプルアプリを更新しました。

ツールのアップデート

Android Studio Canary では、新しいモジュール タイプでの SDK APK のビルドがサポートされます。SDK ランタイム デベロッパー ガイドが更新されました。GitHub のプライバシー サンドボックス サンプルアプリにも内容が反映されています。

デベロッパー プレビュー 4

リリース日: 2022 年 7 月 14 日

Android 版プライバシー サンドボックス デベロッパー プレビュー 4 では、以下の点が改善されました。

SDK ランタイム

  • sendData() の追加により、アプリがランタイム対応の SDK(RE-SDK)と通信できるようになりました。
  • SDK ランタイム プロセスでローカル ストレージを利用できるようになりました。
  • SDK は、SDK ランタイムで単体の動画ベースの広告やコンテンツをレンダリングすることもできます。
  • コンテンツが別の RE-SDK にない場合にリフレクションを使用できることなど、リフレクションの使用についての説明を追加しました。

Attribution Reporting API

このリリースでは、Attribution Reporting API の使用に関してわかりやすくするために、以下のような変更を行いました。

  • 集計レポートの形式を読みやすくなるように変更しました。
  • コンバージョン フィルタリングと単価調整機能のヘッダー フィールドを更新しました。
  • WebApp API リファレンスに、ソースとトリガーの登録や、プライバシーと同意の API の提供状況に関する説明を追加しました。

FLEDGE on Android API

このリリースには、テストとデバッグを容易にするための新機能と内部の改善が含まれています。

  • 開発中に JavaScript ロジックを取得するためのリモート URL をオーバーライドできるようにしました。
  • 広告選択の際のエラーレポートを改善しました。
  • 無効なカスタム オーディエンスは、広告の選択時に除外されるようになりました。

Topics API

このリリースには、Topics API に対する重要な変更が複数含まれています。

  • getTopics() API の戻り値の型が、分類のトピックに対応する整数 ID や、分類器と分類バージョンに関する情報をカプセル化する、新しいオブジェクト型 Topic に変更されました。この API を使用する既存のアプリは更新する必要があります。
  • Topics API に、新しい標準の権限が必要になりました。
  • 公開されているアプリ情報に基づいてトピックを動的に割り当てる「オンデバイス分類器」システムを導入しました。

既知の問題

  • これらのデバイス イメージの最初のリリース(リビジョン 6)は、Android Emulator バージョン 31.2.10 では読み込まれません。この問題に対処したデバイス イメージの更新が、2022 年 7 月 27 日より利用可能になりました。

デベロッパー プレビュー 3

リリース日: 2022 年 6 月 9 日

Android 版プライバシー サンドボックス デベロッパー プレビュー 3 では、Attribution Reporting API と Android 版 FLEDGE の機能が追加されました。

Attribution Reporting API

Attribution Reporting API は、クロスパーティ ユーザー ID への依存をなくすことでユーザーのプライバシーを向上させ、アプリ間でのアトリビューションとコンバージョン測定の主なユースケースをサポートしています。

このリリースには、以下の Attribution Reporting API の機能のテストに役立つデベロッパー向けリソースが含まれています。

  • アトリビューション ソースを登録して、イベントをトリガーする
  • ソース優先のインストール後アトリビューションを活用する
  • イベント レポートを受信する
  • 集約可能なレポートを受信する(今回のリリースでは暗号化されいてません)

テスト用のサンプルアプリとリファレンス広告テクノロジー サーバーが用意されています。

既知の問題:

Android 版 FLEDGE

Android 版 FLEDGE では、新しい方法を導入して、アプリのデベロッパーが定義する「カスタム オーディエンス」とアプリ内のインタラクションに基づいて広告を表示します。このソリューションでは、この情報と関連する広告をローカルに保存し、広告選択ワークフローを調整するためのフレームワークを提供します。

このリリースには、以下の Android 版 FLEDGE の機能のテストに役立つデベロッパー向けリソースが含まれています。

  • カスタム オーディエンスへの参加、またはそこからの脱退、およびパラメータ値がオークション結果に与える影響の確認
  • リモート エンドポイントからの JavaScript オークション コードの取得
  • オンデバイスの広告オークションの設定と開始
  • インプレッション レポートの処理
  • テストに役立つサンプルアプリとモックサーバー構成の提供

既知の問題:

デベロッパー プレビュー 2

リリース日: 2022 年 5 月 17 日

デベロッパー プレビュー 2 には、MeasurementManager アトリビューション レポート API の早期プレビューが含まれています。

  • registerSource()registerTrigger() を呼び出すと、アプリ広告イベントを登録して、アプリ間のアトリビューションに関するイベントレベルのレポートデータを受け取ることができます。現在の実装ではラストタッチ アトリビューションが使用されています。レポートは、レポート ウィンドウの定義に従って送信されるようにスケジュール設定されています。詳細については、MeasurementManager API リファレンスをご覧ください。
  • 実際のレポートのアップロードは、スケジュール設定の厳密な時刻ではなく、一定の時間間隔の終わりに行われます。レポートのアップロード間隔はデフォルトで 4 時間ですが、次の adb コマンドを使用してオーバーライドできます。

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
    
  • API テスト用のサンプルアプリとリファレンス広告テクノロジー サーバーは、今後のリリースで公開される予定です。

  • 集計レポート、インストール後のアトリビューション、リダイレクトなど、MeasurementManager アトリビューション レポート API の他の機能は、今後のリリースで利用できるようになる予定です。

デベロッパー プレビュー 1

リリース日: 2022 年 4 月 28 日

デベロッパー プレビュー 1 には、Topics API の早期プレビュー版が含まれています。 SDK ランタイムAndroid 版 FLEDGEアトリビューション レポート API の機能は、今後のリリースで利用できるようになります。

  • Topics API
    • 現在のところ、getTopics() API は一部のアプリのオフライン分類に基づいてテスト値を返します。デバイス上の分類はまだ実装されていません。
    • adb コマンドを使用すると、エポック間隔のオーバーライドや、エポック計算の強制トリガーを行うことができます。
    • 詳しくは、Topics のデベロッパー ガイドをご覧ください。
  • SDK ランタイム
    • SDK アプリのマニフェスト ファイルで新しい <sdk-library> 要素を使用すると、ランタイム対応 SDK(RE SDK)をパッケージ化してビルドできます。開発中にアプリを通常どおりインストールする場合と同様に、サポートされているテストデバイスまたはエミュレータに RE SDK をインストールします。
    • アプリを RE SDK と統合し、SDK ランタイムに読み込み、アクセス制限の影響を SDK コードでテストできます(権限、メモリ、アプリと SDK の間の通信)。RE SDK 用のストレージ API はまだ実装されておらず、今後のリリースで利用できるようになります。
    • SDK は、SDK ランタイムで WebView ベースのバナー広告またはコンテンツをレンダリングできます。
    • 詳しくは、SDK ランタイムのデベロッパー ガイドをご覧ください。
  • Android lint チェック
    • API レベル TiramisuPrivacySandbox でコンパイルされたプロジェクトでは、Android lint チェックで警告が誤って表示されることがあります。たとえば、「呼び出しには API レベル 33 が必要です」などといった警告メッセージが表示されることがあります。この問題に一時的に対処するには、@SuppressLint("NewApi") アノテーションを使用します。