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을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 맞춤 잠재고객 우선순위: 맞춤 잠재고객에 우선순위 입력란이 추가되었습니다. 이를 통해 구매자는 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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 이 업데이트에서는 지원 중단된 Android R의 개인 정보 보호 샌드박스 측정 및 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에는 이러한 커밋이 포함되어 있습니다.

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에는 이러한 커밋이 포함되어 있습니다.

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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Protected App Signals 지원이 추가되었습니다.
  • 입찰 서버 입찰을 위해 여러 클라우드 제공업체를 지원합니다.

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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 GetTopics는 GetTopicsResponse의 일부로 암호화된 응답을 지원합니다.

API 변경사항

  • GetTopicResponse 클래스에 EncryptedTopic를 추가했습니다. (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에는 이러한 커밋이 포함되어 있습니다.

참고

  • 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에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 매니페스트에 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에 포함된 커밋을 확인하세요.

새로운 기능

  • 입찰 후 사용자 이벤트 보고를 지원하는 새로운 API
  • 리마케팅 광고의 최대 게재빈도 필터링 지원 추가
  • 맞춤 잠재고객 참여 위임 지원
  • 폭포식 구조 미디에이션 체인 자르기 지원
  • 입찰 서버에서 보호된 입찰 지원

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를 도입하고 일련의 AdFilters를 나타내도록 AdData를 변경했습니다. (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에 포함된 커밋을 확인하세요.

새로운 기능

  • 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에 포함된 커밋을 확인하세요.

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에 포함된 커밋을 확인하세요.

버전 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에 포함된 커밋을 확인하세요.

API 변경사항

  • registerSource 목록 도입 (Iae92f)
  • 실험용 isAtLeastU() API의 사용을 삭제했습니다. (Ie9117, b/289269026)

버그 수정

버전 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에 포함된 커밋을 확인하세요.

버그 수정

  • TopicsManager에 sdk 확장 프로그램 5 검사를 추가합니다.
  • gradle에서 클래스 빌드 오류가 중복되지 않도록 Kotlin 코루틴 종속 항목을 1.7.1로 상향

버전 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에 포함된 커밋을 확인하세요.

버그 수정

  • 호출자가 기본 스레드에서 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에 포함된 커밋을 확인하세요.

새로운 기능

  • 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에 포함된 커밋을 확인하세요.

버그 수정

  • SDK 확장 프로그램 버전 5 이상에 MeasurementManager API를 사용 설정했습니다.
  • SDK 확장 프로그램 버전 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은 내부 브랜치에서 출시되었습니다.

  • 이 새로운 Jetpack 라이브러리는 개인 정보 보호 샌드박스의 개인 정보 보호 API(Topics, FLEDGE, Attribution Reporting)와의 통합을 지원합니다.
  • Jetpack 개인 정보 보호 샌드박스 API는 Extension SDK 4에 제공된 개인 정보 보호 샌드박스 API의 드롭인 대체로 사용할 수 있습니다.