Instalacje bezpośrednie w Google Play (aplikacje)

Na tej stronie opisujemy, jak deweloperzy aplikacji mogą zintegrować instalację bezpośrednią, czyli nową funkcję testową Google Play, która wyświetla szczegóły aplikacji w Google Play w interfejsie karty połówkowej. Instalacja w ramach aplikacji umożliwia użytkownikom płynne instalowanie aplikacji bez opuszczania jej kontekstu. Deweloperzy aplikacji mogą zintegrować i przetestować funkcję instalacji w ramach aplikacji w przypadku aplikacji rozpowszechnianych w Google Play lub aktualizowanych w tej usłudze.

Wymagania

Aby interfejs karty połowy ekranu był widoczny w aplikacji:

  • Minimalna wersja Google Play musi wynosić 40.4.
  • Poziom interfejsu API Androida musi wynosić 23 lub wyższy.

Wywoływanie instalacji bezpośrednich z aplikacji

Aby wywołać z aplikacji półekranową stronę instalacji, utwórz instancję klasy Intent, która otwiera adres URL precyzyjnego linku. Jako wskazówkę możesz wykorzystać poniższy przykładowy kod (Kotlin lub 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.
}

Java

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.
}

Parametry interfejsu API instalacji bezpośredniej

Pole Opis Wymagane
referrer Opcjonalny ciąg znaków referrer do śledzenia Nie
id Nazwa pakietu aplikacji do zainstalowania Tak
overlay Ustaw na true, jeśli chcesz wyświetlić kartę w ramce, lub na false, jeśli chcesz utworzyć precyzyjny link do Google Play. Tak
callerId Nazwa pakietu aplikacji wywołującej Tak
listing Opcjonalny parametr umożliwiający określenie docelowych informacji o niestandardowej aplikacji. Nie

Jeśli proces instalacji aplikacji nie wyświetla interfejsu wbudowanego w Google Play, zamiast niego wyświetlany jest bezpośredni link do strony aplikacji w Google Play.