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-beta12androidx.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-beta11androidx.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-beta10androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 がリリースされました。バージョン 1.1.0-beta10 に含まれる commit はこちらをご覧ください。

API の変更

  • GetAdSelectionDataOutcomePersistAdSelectionResultRequestReportEventRequestFetchAndJoinCustomAudienceRequest 試験運用版 API に不足している Java コンストラクタのオーバーロードを追加しました。(I19e7f

バージョン 1.1.0-beta09

2024 年 7 月 10 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09androidx.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-beta08androidx.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-beta07androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 がリリースされました。バージョン 1.1.0-beta07 に含まれる commit はこちらをご覧ください。

新機能

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

API の変更

  • EncryptedTopicGetTopicResponse クラスに追加しました。(Iab362

バージョン 1.1.0-beta06

2024 年 4 月 17 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06androidx.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-beta05androidx.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-beta04androidx.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::getAdSelectionDataAdSelectionManager::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-beta03androidx.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-beta02androidx.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-beta01androidx.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-alpha01androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

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

バグの修正

  • 試験運用版 API ファイルと公開 API ファイルを統合しました。(I15da3b/278769092

バージョン 1.0

バージョン 1.0.0-beta05

2023 年 6 月 7 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05androidx.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-beta04androidx.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-beta03androidx.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-beta02androidx.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-beta01androidx.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-alpha01androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 は内部ブランチからリリースされました。

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