privacysandbox ads
androidx.privacysandbox.ads.adservices.adid
androidx.privacysandbox.ads.adservices.adselection
androidx.privacysandbox.ads.adservices.appsetid
androidx.privacysandbox.ads.adservices.common
androidx.privacysandbox.ads.adservices.customaudience
androidx.privacysandbox.ads.adservices.measurement
androidx.privacysandbox.ads.adservices.topics
最新の更新 | 安定版リリース | リリース候補版 | ベータ版リリース | アルファ版リリース |
---|---|---|---|---|
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 の代わりに使用できます。