Play Install Referrer API

이 문서에서는 Play Install Referrer API를 사용하기 위한 기술 참조 정보를 제공합니다. Play Install Referrer API는 주로 자바 프로그래머가 아닌 프로그래머가 사용하는 AIDL 서비스 인터페이스입니다.

참고: Play 설치 리퍼러 라이브러리는 Play Install Referrer API의 래퍼를 제공하며 자바 프로그래머가 API를 사용하는 데 도움이 되도록 설계되었습니다.

getInstallReferrer() 메서드

이 메서드는 Bundle을 통해 전송된 패키지 이름에 상응하는 앱 설치 리퍼러 정보를 반환합니다(표 1에 키 매핑됨). Google Play에서 전송하는 응답 Bundle에서 리퍼러 정보는 표 2에 설명된 키에 매핑된 필드에 저장됩니다.

표 1. getInstallReferrer() 번들 데이터 요청

매개변수 유형 설명
package_name String 명확성을 위해 사용되는 호출자의 패키지 이름

표 2. getInstallReferrer() 요청의 응답 데이터

유형 설명
install_referrer String 설치된 패키지의 리퍼러 URL
referrer_click_timestamp_seconds long 리퍼러 클릭이 발생한 시점의 클라이언트 측 타임스탬프(초)
install_begin_timestamp_seconds long 앱 설치가 시작된 시점의 클라이언트 측 타임스탬프(초)입니다.
referrer_click_timestamp_server_seconds long 리퍼러 클릭이 발생한 시점의 서버 측 타임스탬프(초)
install_begin_timestamp_server_seconds long 앱 설치가 시작된 시점의 서버 측 타임스탬프(초)입니다.
install_version string 앱이 처음 설치된 시점의 앱 버전
google_play_instant boolean 앱의 인스턴트 환경이 지난 7일 이내에 출시되었는지를 나타냅니다.

주의: 설치 리퍼러 정보는 90일 동안 확인할 수 있으며 애플리케이션을 재설치하지 않는 한 변경되지 않습니다. 앱에서 불필요한 API 호출을 피하려면 설치 후 첫 실행 시 한 번만 API를 호출해야 합니다.