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

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

Android의 개인 정보 보호 샌드박스 베타 프로그램은 안정적인 API를 제공합니다. 베타 프로그램 버전을 사용하여 모든 API의 경우 Android 13 이상 휴대기기에서, Attribution Reporting API (ARA)의 경우 Android 12 이상에서 제한적인 프로덕션 테스트를 위한 솔루션을 빌드하고 테스트할 수 있습니다. 먼저 제한된 수의 기기를 지원한 후 지원 기기 수를 늘려갈 예정입니다. 참여하려는 조직은 제한된 수의 기기에 대한 액세스를 요청하고 개인 정보 보호 샌드박스 API를 사용하는 모든 앱을 등록하면 됩니다.

SDK 런타임의 경우 개발자가 런타임 지원 SDK 배포를 테스트하여 앱을 선택할 수 있는 비공개 베타가 있습니다.

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

Android SDK 확장 프로그램

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

시작하기

Android용 개인 정보 보호 샌드박스를 시작하려면 다음 단계를 따르세요.

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 통합과 관련된 알려진 문제를 방지하려면 이러한 기기의 광고 서비스 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를 사용하여 문제를 신고하고 의견을 보내주세요.

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

개발 환경을 최신 출시 버전으로 최신 상태로 유지하는 것이 좋습니다. 이렇게 하면 최신 기능과 보안 패치가 설치되고 환경이 종속 항목의 최신 버전과 호환됩니다. 신규 출시에 대한 알림을 받으려면 이메일 업데이트를 신청하세요.