privacysandbox ads

  
このライブラリにより、Android 版プライバシー サンドボックスの一部であるプライバシー保護 API との統合が可能になります。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 3 月 12 日 - - 1.1.0-beta12 -

依存関係の宣言

privacysandbox-ads への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

Kotlin

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.1

バージョン 1.1.0-beta12

2025 年 3 月 12 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 がリリースされました。バージョン 1.1.0-beta12 に含まれる commit はこちらをご覧ください。

新機能

  • カスタム オーディエンスの優先度: カスタム オーディエンスに優先度フィールドが追加されました。これにより、購入者は CustomAudience に優先度の値を指定できます。この値は、購入者のカスタム オーディエンスのセットが購入者ごとのサイズの上限を超える場合に、オークションに参加するカスタム オーディエンスを識別するために使用されます。
  • 販売者の構成: この機能を使用すると、販売者はオークション パラメータを定義してペイロードのサイズとオークション参加者を制御できます。販売者オークションの構成では、販売者は次の項目を指定できます。
    • 許可された購入者リスト
    • 特定の販売者が開始したオークションの場合は、許可リスト内の購入者のみがオークションの CustomAudiences に貢献できます。
    • 購入者ごとのサイズ上限
    • 販売者は、購入者ごとの上限を指定して、SellerFrontendService に送信されるペイロードに各購入者によってアップロードされるデータサイズを規制できます。購入者が購入者ごとのサイズ上限を超えると、購入者のペイロード構成に設定された CustomAudience 優先度を使用して、想定される上限でデータを取得します。
    • ペイロードの最大サイズの上限
    • 販売者ごとにリソースの割り当てが異なり、リクエストごとのオークション ペイロードにサイズの上限を設定することが必要な場合があります。サイズの上限には、ProtectedAudience API により設定された固定サイズバケットが適用されます。
  • カスタム オーディエンスの遅延更新: この機能を使用すると、カスタム オーディエンスの更新を遅らせることができます。各更新リクエストで、呼び出し元は新しい scheduleCustomAudienceUpdate() API を使用して遅延更新をスケジュールできます。更新ごとに、ユーザーはカスタム オーディエンスのセットを指定して、そのセットをターゲットに含めるか除外するかを指定できます。

API の変更

  • GetAdSelectionRequest API に販売者構成を追加しました（Ibb5c7）
  • ScheduleCustomAudienceUpdate API を試験運用版として導入しました。（I6b905）

バージョン 1.1.0-beta11

2024 年 10 月 30 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 がリリースされました。バージョン 1.1.0-beta11 に含まれる commit はこちらをご覧ください。

新機能

  • このアップデートにより、非推奨となった Android R の privacysandbox 測定 API と adid API のサポートが削除されます。Android R でマネージャー クラスを取得する呼び出しが null を返すようになりました。

バージョン 1.1.0-beta10

2024 年 8 月 21 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 がリリースされました。バージョン 1.1.0-beta10 に含まれる commit はこちらをご覧ください。

API の変更

  • GetAdSelectionDataOutcome、PersistAdSelectionResultRequest、ReportEventRequest、FetchAndJoinCustomAudienceRequest 試験運用版 API に不足している Java コンストラクタのオーバーロードを追加しました。（I19e7f）

バージョン 1.1.0-beta09

2024 年 7 月 10 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 がリリースされました。バージョン 1.1.0-beta09 に含まれる commit はこちらをご覧ください。

API の変更

  • GetAdSelectionDataRequest 試験運用版 API に欠落していた Java コンストラクタのオーバーロードを追加しました。（Ifbf88）。

バージョン 1.1.0-beta08

2024 年 6 月 26 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 がリリースされました。バージョン 1.1.0-beta08 に含まれる commit はこちらをご覧ください。

新機能

  • Protected App Signals のサポートを追加しました。
  • B&A サーバー オークションで複数のクラウド プロバイダをサポート。

API の変更

  • 試験運用版の API GetAdSelectionDataRequest::seller は null を許可しません。（I68044）
  • GetAdSelectionDataRequest::coordinatorOriginUri 試験運用版 API を追加しました。（I18c0b）
  • updateSignals API を追加しました。（Ia8512）

バージョン 1.1.0-beta07

2024 年 5 月 14 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 がリリースされました。バージョン 1.1.0-beta07 に含まれる commit はこちらをご覧ください。

新機能

  • GetTopics が GetTopicsResponse の一部として暗号化されたレスポンスをサポートするようになりました。

API の変更

  • EncryptedTopic を GetTopicResponse クラスに追加しました。（Iab362）

バージョン 1.1.0-beta06

2024 年 4 月 17 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 がリリースされました。バージョン 1.1.0-beta06 に含まれる commit はこちらをご覧ください。

注

  • privacysandbox-ads jetpack リリース 1.1.0-beta06 以降、フラグが有効になっているすべての Android R デバイスが PPAPI にアクセスできるようになります。Android R をサポートしないユースケースの場合は、privacysandbox-ads jetpack コードを使用するコード内に追加のガードが必要になります。

新機能

  • Android R の下位互換性サポート。

バージョン 1.1.0-beta05

2024 年 4 月 3 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 がリリースされました。バージョン 1.1.0-beta05 に含まれる commit はこちらをご覧ください。

バグの修正

  • マニフェストに uses-library タグがないため、Android S デバイスでクラス定義が見つからない場合にエラーをキャッチする機能を追加しました。

バージョン 1.1.0-beta04

2024 年 1 月 24 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 がリリースされました。バージョン 1.1.0-beta04 に含まれる commit については、こちらをご覧ください。

新機能

  • オークション後のユーザー イベント レポートをサポートする新しい API
  • リマーケティング広告のフリークエンシー キャップ フィルタリングをサポート
  • カスタム オーディエンス委任に参加する機能のサポート
  • ウォーターフォール メディエーション チェーンの切り捨てサポート
  • 入札とオークション サーバーで Protected Auction をサポート

API の変更

  • AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) 試験運用版 API を導入しました。（I86cd2）
  • ReportEventRequest::inputEvent 試験運用版 API を導入しました。（Ib94f3）
  • ReportImpressionRequest::adSelectionConfig をオプションにします（Ief280）
  • AdSelectionManager::getAdSelectionData と AdSelectionManager::persistAdSelectionResultUnified の試験運用版 API を導入しました。（Ie4d0e）
  • CustomAudienceManager::fetchAndJoinCustomAudience 試験運用版 API を導入しました。（I09152）
  • AdSelectionManager::reportEvent 試験運用版 API を導入しました。（I0d7dc）
  • AdSelectionManager::updateAdCounterHistogram 試験運用版 API を導入し、AdData を変更して一連の AdFilters を示すようにしました（I87b83）

バグの修正

  • ホスト名と完全に一致する必要がなくなり、入力 URI が共有サイトやオリジンで照合されるようになりました。
  • HTTPS スキームがないためテストが失敗する問題を修正（d573058）
  • ウェブ URL から欠落している HTTPS スキームを修正（cecdcb8）
  • 測定 API に throws アノテーションを追加しました（2dba359）

バージョン 1.1.0-beta03

2023 年 11 月 15 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 がリリースされました。バージョン 1.1.0-beta03 に含まれる commit については、こちらをご覧ください。

新機能

  • Android S の下位互換性サポート。

バージョン 1.1.0-beta02

2023 年 10 月 4 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 がリリースされました。バージョン 1.1.0-beta02 に含まれる commit については、こちらをご覧ください。

API の変更

  • 測定リクエスト クラスから T+ バージョン チェックを削除しました。クライアントは、privacysandbox MeasurementManager リクエスト クラスにアクセスするために、T+ プラットフォーム バージョン チェックを行う必要はありません。新しい動作では、MeasurementManager は null になります。（Ieb105）

バージョン 1.1.0-beta01

2023 年 8 月 23 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 がリリースされました。変更はありません。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.1.0-alpha01

2023 年 8 月 9 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 と androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください。

API の変更

  • registerSource リストを導入（Iae92f）
  • 試験運用版の isAtLeastU() API の使用を削除しました。（Ie9117、b/289269026）

バグの修正

  • 試験運用版 API ファイルと公開 API ファイルを統合しました。（I15da3、b/278769092）

バージョン 1.0

バージョン 1.0.0-beta05

2023 年 6 月 7 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 がリリースされました。バージョン 1.0.0-beta05 に含まれる commit については、こちらをご覧ください。

バグの修正

  • TopicsManager に sdk extension 5 チェックを追加
  • Kotlin コルーチンの依存関係を 1.7.1 に引き上げて、Gradle でのクラスビルドのエラーの重複を防ぐ

バージョン 1.0.0-beta04

2023 年 5 月 10 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 がリリースされました。バージョン 1.0.0-beta04 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 呼び出し元によってメインスレッドで adservices 測定 API が呼び出された場合にデッドロックの問題を解決。（I65361）

バージョン 1.0.0-beta03

2023 年 4 月 19 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 がリリースされました。バージョン 1.0.0-beta03 に含まれる commit については、こちらをご覧ください。

新機能

  • Topics で Preview API を有効にしました。

バージョン 1.0.0-beta02

2023 年 3 月 22 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 がリリースされました。バージョン 1.0.0-beta02 に含まれる commit については、こちらをご覧ください。

バグの修正

  • SDK 拡張機能のバージョン 5 以降で MeasurementManager API を有効にしました。
  • SDK Extensions バージョン 4 以前の MeasurementManager API を無効にしました。

バージョン 1.0.0-beta01

2023 年 2 月 22 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 がリリースされました。重要な変更はありません。バージョン 1.0.0-beta01 は内部ブランチからリリースされました。

動作の変更

  • Attribution Reporting は無効になっており、このリリースでは使用できません。

バージョン 1.0.0-alpha01

2023 年 1 月 11 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 と androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 は内部ブランチからリリースされました。

  • プライバシー サンドボックスのプライバシー保護 API（Topics、FLEDGE、Attribution Reporting）との統合を可能にする、新しい Jetpack ライブラリです。
  • Jetpack のプライバシー サンドボックス API は、Extension SDK 4 で提供されるプライバシー サンドボックス API の代わりに使用できます。