Google Play 인라인 설치 (앱)

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

요구사항

앱에 하프 시트 인터페이스가 표시되려면 다음을 실행합니다.

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

앱에서 인라인 설치 호출

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

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 등록정보로 연결되는 직접 링크 (딥 링크)가 대신 표시됩니다.