이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Android용 개인 정보 보호 샌드박스 시작하기

Android의 개인 정보 보호 샌드박스 베타 프로그램은 안정적인 API를 제공합니다. Google은 2023년 한 해 동안 여러 베타 버전을 출시할 계획입니다. 베타 프로그램 버전을 사용하여 모든 API의 경우 Android 13 이상 휴대기기, Attribution Reporting API(ARA)의 경우 Android 12 이상에서 제한된 프로덕션 테스트를 위한 솔루션을 빌드하고 테스트할 수 있습니다. Google은 일부 기기를 지원하기 시작하여 점차 지원 대상을 확대할 예정입니다. 참여를 원하는 조직은 제한된 수의 기기에 대한 액세스 권한을 요청하여 개인 정보 보호 샌드박스 API를 사용하는 앱 등록

SDK 런타임의 경우 개발자가 테스트할 수 있는 비공개 베타가 제공됩니다. 일부 앱에 대한 런타임 지원 SDK 배포

베타 출시 버전을 사용하려면 개발자는 API를 사용하여 솔루션을 컴파일해야 합니다. 수준 33 SDK 확장 프로그램 업데이트

Android SDK 확장 프로그램

베타 버전의 안정적인 API는 새로운 Android SDK 확장 프로그램을 사용하여 제공됩니다. release 메서드로 전달하세요. 이 출시 메서드를 통해 메이저 버전 간에 안정적인 Android 기능을 출시할 수 있습니다. 여기에는 Google Play 시스템 업데이트를 사용하여 여러 API 수준의 앱에 새 API를 제공하는 새로운 버전 관리 메커니즘이 있습니다. Android의 개인 정보 보호 샌드박스 SDK 확장 프로그램을 광고 서비스 확장 프로그램이라고 합니다. Android SDK 확장 프로그램에 대해 자세히 알아보세요.

시작하기

시작하려면 다음 단계를 따르세요.

1단계: 베타 프로그램 등록

등록: 등록 절차를 완료하여 다음 안내를 따릅니다. 광고 관련 API를 사용합니다.
등록: 베타 프로그램에 참여하려면 등록해야 합니다. 등록하면 다음과 같은 이점이 있습니다.
- 내부 테스트 목적으로 자체 기기를 사용 설정합니다.
- 개인 정보 보호 API를 직접 통합하거나 이 API를 사용하는 SDK 솔루션을 통합할 수 있는 Google Play 스토어에 게시된 제한된 수의 앱을 지정합니다.
- Google Play 스토어를 사용하여 런타임 지원 SDK 배포를 테스트합니다. 이 단계는 SDK 런타임을 기기 내에서만 테스트해야 하는 경우 필요하지 않습니다.

2단계: 개발 환경 설정

Android 스튜디오에서 Android의 개인 정보 보호 샌드박스 SDK 설정

3단계: AdServices 권한 구성

타겟팅된 API에서 관리하는 리소스에 대한 API별 권한을 선언하고 SDK 액세스를 구성합니다.

4단계: 기기 또는 에뮬레이터 이미지 설정

엔드 투 엔드 테스트를 실행하려면 지원되는 Android 13과 상호작용해야 합니다. 기기를 다운로드하거나 적절한 SDK 확장 프로그램에 에뮬레이터 이미지를 사용하세요.

5단계: Android의 개인 정보 보호 샌드박스를 사용하도록 기기 구성

기기에서 실행되도록 Android의 개인 정보 보호 샌드박스를 사용 설정(또는 사용 중지)하려면 설정을 구성합니다.

알려진 문제 해결

Android 12 이하 기기에서 PP API 통합과 관련된 알려진 문제를 방지하려면 Android 12 이하 기기용 광고 서비스 API와 통합하는 개발자가 다음을 실행해야 합니다.

클라이언트 앱의 매니페스트 파일에 <uses-library> extservices 태그가 포함되어 있는지 확인합니다. 관련 태그는 다음과 같습니다.

<uses-library
  android:name="android.ext.adservices"
  android:required="false" />

androidx.privacysandbox.ads Jetpack 라이브러리를 사용하는 경우 버전 1.1.0-beta05 이상을 사용 중인지 확인합니다.

어떤 개발자 리소스를 사용할 수 있나요?

Android의 개인 정보 보호 샌드박스 베타 프로그램에는 다음 도구와 리소스가 포함되어 있습니다.

SDK 및 에뮬레이터 시스템 이미지

Android 스튜디오를 사용하면 SDK Manager를 통해 최신 광고 서비스 확장 프로그램과 에뮬레이터 시스템 이미지를 다운로드할 수 있습니다. 개발 환경 설정 및 API 액세스 설정 방법에 관해 자세히 알아보세요.

API 참조

전체 API 참조가 제공됩니다.

지원 및 의견

Android의 개인 정보 보호 샌드박스로 테스트하고 개발할 때 버전을 검토하세요. 메모를 참고하고 Issue Tracker를 사용하여 문제를 신고하고 의견을 제공하세요.

개발 환경을 최신 상태로 유지

개발 환경을 최신 출시 버전으로 최신 상태로 유지하는 것이 좋습니다. 이렇게 하면 최신 기능을 사용할 수 있고 사용 중인 환경이 최신 버전의 소프트웨어와 종속 항목 버전을 배포합니다 신규 출시에 대한 알림을 받으려면 이메일 업데이트를 신청하세요.