Google Play 인라인 설치 (앱)

이 페이지에서는 앱 개발자가 Google Play 앱 제품 세부정보를 하프 시트 인터페이스에 표시하는 Google Play의 새로운 테스트 기능인 인라인 설치를 통합하는 방법을 설명합니다. 인라인 설치를 사용하면 사용자가 앱의 컨텍스트를 벗어나지 않고도 원활한 앱 설치 흐름을 경험할 수 있습니다. 앱 개발자는 Play 배포 또는 업데이트된 앱의 인라인 설치 기능을 통합하고 테스트할 수 있습니다.

요구사항

앱에 하프 시트 인터페이스가 표시되려면 다음 요구사항을 충족해야 합니다.

  • 최소 Google Play 버전은 40.4 여야 합니다.
  • Android API 수준은 24 이상 이어야 합니다.

앱에서 인라인 설치 호출

앱에서 인라인 설치 하프 시트를 호출하려면 딥 링크 URL을 여는 Intent 클래스의 인스턴스를 만듭니다. 다음 샘플 코드 (Kotlin 또는 자바)를 가이드라인으로 사용하세요.

Kotlin

val intent = Intent(Intent.ACTION_VIEW)
val referrer = "<Your referrer string>"
val id = "<Package name of the app that is to be installed>"
val callerId = "<Package name of your app>"
intent.setPackage("com.android.vending")
val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id"
intent.data = Uri.parse(deepLinkUrl)
intent.putExtra("overlay", true)
intent.putExtra("callerId", "$callerId")
val packageManager = context.getPackageManager()
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0)
} else {
  // Fallback to deep linking to full Play Store.
}

자바

Intent intent = new Intent(Intent.ACTION_VIEW);
String referrer = "<Your referrer string>";
String id = "<Package name of the app that is to be installed>";
String callerId = "<package name of your app>";
String csl_id = "<Custom store listing id>";
intent.setPackage("com.android.vending");
String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id;
intent.setData(Uri.parse(deepLinkUrl));
intent.putExtra("overlay", true);
intent.putExtra("callerId", callerId);
PackageManager packageManager = context.getPackageManager();
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0);
} else {
  // Fallback to deep linking to full Play Store.
}

인라인 설치 API 매개변수

필드 설명 필수
referrer 선택사항인 리퍼러 추적 문자열 아니요
id 설치할 앱의 패키지 이름 예
overlay 인라인 하프 시트가 요청된 경우 true로 설정합니다. false인 경우 인텐트가 Google Play로 딥 링크됩니다. 예
callerId 호출자 앱의 패키지 이름 예
listing 맞춤 스토어 등록정보의 대상을 지정하는 선택사항인 매개변수 아니요

앱 설치 흐름에 Google Play 인라인 설치 하프 시트 인터페이스가 표시되지 않으면 대신 Google Play 등록정보로 직접 (딥 링크) 연결됩니다.