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를 호출해야 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Play Install Referrer API\n\nThis documentation provides technical reference for using the\nPlay Install Referrer API. The Play Install Referrer API is an\n[AIDL Service Interface](https://developer.android.com/guide/components/aidl.html)\nprimarily used by non-Java programmers.\n\n\n**Note:** The\n[Play Install Referrer Library](/google/play/installreferrer/library)\nprovides a wrapper around the Play Install Referrer API and is designed to help Java\nprogrammers use the API.\n\nThe getInstallReferrer() method\n-------------------------------\n\nThis method returns the app install referrer information corresponding to the\ngiven package name sent through a `Bundle` (key mapped in table 1). In the\nresponse `Bundle` sent by Google Play, the referral information is stored in\nfields mapped to the keys detailed in table 2.\n\n\n**Table 1.** `getInstallReferrer()` bundle data\nrequest.\n\n| Parameter | Type | Description |\n|----------------|----------|----------------------------------------------------------|\n| `package_name` | `String` | The package name of the caller, used for disambiguation. |\n\n\n**Table 2.** Response data from a `getInstallReferrer()`\nrequest.\n\n| Key | Type | Description |\n|-------------------------------------------|-----------|--------------------------------------------------------------------------------------|\n| `install_referrer` | `String` | The referrer URL of the installed package. |\n| `referrer_click_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when app installation began. |\n| `referrer_click_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when app installation began. |\n| `install_version` | `string` | The app's version at the time when the app was first installed. |\n| `google_play_instant` | `boolean` | Indicates whether your app's instant experience was launched within the past 7 days. |\n\n**Caution:** The install referrer information will be\navailable for 90 days and **won't change** unless the application is\nreinstalled. To avoid unnecessary API calls in your app, you should invoke the\nAPI **only once** during the first execution after install."]]
