Attribution Reporting API: 통합 가이드

Attribution Reporting API는 당사자 간 사용자 식별자에 관한 의존성을 제거하여 사용자 개인 정보 보호를 개선하고 앱에서 기여 분석 및 전환 측정을 위한 주요 사용 사례를 지원하도록 설계되었습니다. 이 문서에는 Attribution Reporting API 통합을 준비하는 데 도움이 되는 가이드라인이 포함되어 있습니다.

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

통합 목표

개인 정보 보호 샌드박스 개발자 프리뷰의 이 단계에서 통합 계획의 목표는 다음과 같습니다.

현재 및 향후 지원

최신 개발자 프리뷰 버전에서 현재 지원되는 사용 사례 및 기능에는 다음이 포함됩니다.

  • 소스 우선순위의 마지막 터치 기여 분석 및 설치 후 기여 분석
  • 앱 기여 분석 소스 및 앱 트리거를 등록합니다.
  • 이벤트 수준 보고서를 수신합니다.
  • 암호화되지 않은 집계 가능한 보고서를 수신합니다.

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

  • 광고 기술 플랫폼 등록.
  • 개발자가 집계 보고서와 기존 메커니즘 보고서를 비교할 수 있는 디버깅 지원.
  • 앱과 웹 간 기여 분석을 지원할 수 있는 웹 기여 분석 소스 및 웹 트리거 등록.
  • API에서 암호화된 집계 가능 보고서 수신 및 집계 서비스에 배치 전송.
  • 집계 서비스에서 요약 보고서 수신.
  • API를 사용하려면 새로운 일반 권한이 필요함.

의도한 광고 기술 잠재고객

Attribution Reporting API에서 보고서를 수신하려면 광고 기술 플랫폼에 기여 분석 소스와 트리거를 모두 등록해야 합니다. 최소한 전체 엔드 투 엔드 테스트를 사용 설정하려면 광고 기술 게재 파트너와 모바일 측정 파트너가 합심하여 동일한 광고주의 API를 호출해야 하며 등록 호출에서 리디렉션을 활용해야 할 수 있습니다. 게시자 앱 또는 광고주 앱으로 작업해야 할 수도 있습니다.

기여 분석 소스 등록의 경우 일반적으로 API 호출은 게시자 앱에 광고를 게재하는 데 사용되는 광고 기술 SDK에 의해 시작되지만, API를 앱에서 직접 호출할 수도 있습니다.

트리거 등록의 경우 API 호출은 일반적으로 광고주 앱의 모바일 측정 파트너 SDK에서 또는 광고주 앱 자체에서 시작됩니다.

기본 요건

통합 단계

Attribution Reporting API를 솔루션에 통합할 준비를 하려면 다음 섹션에 설명된 단계를 완료합니다.

테스트 환경에서 기술 정확성 확인

  • 테스트 애플리케이션을 만들어 Android Attribution Reporting API의 개인 정보 보호 샌드박스를 숙지합니다. 이 단계에서 GitHub의 샘플 앱으로 시작할 수도 있습니다.
  • 모의 서버 엔드포인트를 설정하거나 샘플 서버를 사용하여 Attribution Reporting 클라이언트 API에 사용되는 REST API 서명에 익숙해집니다.
  • 조회, 클릭, 전환(트리거) 이벤트를 비롯한 이벤트를 등록합니다.
  • 이벤트 수준 보고서와 집계 보고서의 보고서 데이터를 수신하는 시간을 단축하기 위해, 테스트 목적으로 적절한 ADB 명령어를 사용하여 보고 작업을 강제 실행합니다.
  • 현재 기술 스택의 API 서명 적용 여부를 평가합니다. 여기에는 입력 매개변수와 반환 값이 포함됩니다. 데이터 흐름 간의 차이와 개선 사항을 파악하세요.

기존 기술 인프라와의 호환성 확인

  • 클라이언트 측 개발 환경 및 코드베이스:
    • 개발자 프리뷰 후 Android의 개인 정보 보호 샌드박스에는 최소 대상 API 수준 33이 필요합니다. 기존 코드베이스의 이전 경로를 식별합니다. 앱 또는 SDK가 Android 13에 도입된 다른 변경사항과 호환되는지 평가합니다.
  • 서버 측:
    • API 스텁 엔드포인트를 기존 기술 인프라에 추가하여 기술적 제한사항을 찾고 확인합니다.
    • 콜백을 추가하여 기존 기술 인프라에 보고서를 허용합니다.

통합 요구사항 정의 및 확인

  • 로그 또는 서버 데이터에서 보고서에 조회와 클릭 및 전환의 데이터가 포함되어 있는지 확인합니다.
  • 이벤트 수준 보고서와 집계 수준 보고서를 모두 확인합니다.