SDK 런타임 API: 통합 가이드

이 문서에는 일반적인 사용 사례를 기반으로 SDK 런타임 통합을 준비하는 데 도움이 되는 가이드라인이 포함되어 있습니다.

통합 계획에 도움을 드리고자 이 문서에는 통합 프로세스에 관한 포괄인 뷰가 제공됩니다. 여기에는 Android 개발자 프리뷰에서 개인 정보 보호 샌드박스의 현재 단계에 아직 구현되지 않은 기능을 포함되어 있을 수 있습니다. 이러한 경우 관련 세부정보가 아직 구현되지 않은 것으로 표시됩니다.

통합 목표

Android 개발자 프리뷰의 개인 정보 보호 샌드박스에 관한 이 단계에서는 통합 계획의 목표에는 다음 기능이 포함됩니다.

  • 테스트 환경에서 기술 정확성 확인
  • 기존 기술 인프라와의 호환성 확인
  • 통합 요구사항 정의 및 확인

최신 개발자 프리뷰 버전에서 현재 지원되는 사용 사례 및 기능은 다음과 같습니다.

  • 배너 광고 원격 로드 및 표시
  • 저장소에서 쓰기/읽기
  • 양방향 커뮤니케이션
  • 독립형 동영상 광고

예정된 개발자 프리뷰 출시에서는 사용 사례 및 기술 기능에 관한 지원을 추가할 예정입니다. 이러한 기능이 출시되면 이 가이드는 관련 세부정보를 반영하도록 업데이트됩니다.

  • 네이티브 광고
  • 전체 화면 광고

기본 요건

통합 단계

1. 테스트 환경에서 기술 정확성을 확인합니다.

  • 테스트 애플리케이션과 테스트 SDK를 만들어 Android SDK 런타임의 개인 정보 보호 샌드박스에 익숙해집니다. 이 단계에서 GitHub의 샘플 앱으로 시작할 수도 있습니다.
  • 기기 또는 에뮬레이터에 SDK 및 앱을 설치하고 실행한 다음 제공된 URL가 WebView에 의해 로드되는지 확인합니다.
  • SDK 런타임에서 원격으로 앱에 광고를 렌더링합니다.
  • 프로세스를 디버그할 수 있도록 SDK 코드에 중단점을 추가하고 프로세스에 연결합니다.

2. 기존 기술 인프라와의 호환성을 확인합니다.

  • 개발자 프리뷰 후 Android의 개인 정보 보호 샌드박스에는 최소 대상 API 수준 33이 필요합니다. 기존 코드베이스의 마이그레이션 경로를 식별합니다. 앱 또는 SDK가 Android 13에 도입된 다른 변경사항과 호환되는지 평가합니다.
  • 가능한 경우 개발 도구 모음과 앱의 호환성을 확인합니다.
  • 필요에 따라 코드베이스를 리팩터링하여 공통 로직을 재사용합니다. 일부 개발자는 단일 코드베이스를 선호할 수도 있습니다. 이 경우 이 방법이 타당한지 확인하세요.

3. 통합 요구사항을 정의하고 확인합니다.

  • 현재 SDK 솔루션의 데이터 액세스 요구사항을 비롯하여, 클라이언트 앱과의 상호작용 모델, SDK 런타임의 설계와 비교한 시스템 구성요소를 검토합니다.
  • SDK 런타임에서 지원되는 광고 유형 중 하나를 표시하여 SDK가 로드되었는지 확인하고 광고가 상호작용 가능한지 확인합니다.
  • 비즈니스 사용 사례에 해당하는 경우 Topics, FLEDGE 또는 Attribution Reporting API가 SDK 런타임 프로세스에서 실행되는지 확인합니다.
  • ADB 또는 Android 스튜디오를 통해 연결한 다음 코드를 단계별로 실행하여 SDK 런타임 프로세스를 디버그할 수 있는지 확인합니다.