Inline-Installationen über Google Play (Apps)

Auf dieser Seite wird beschrieben, wie App-Entwickler Inline-Installationen einbinden können. Das ist eine neue Testfunktion für Google Play, mit der Produktdetails von Google Play-Apps in einer Half-Sheet-Oberfläche präsentiert werden. Mit Inline-Installationen können Nutzer Apps nahtlos installieren, ohne die App verlassen zu müssen. App-Entwickler können die Funktion für Apps einbinden und testen, die über Google Play vertrieben oder aktualisiert werden.

Voraussetzungen

Damit die Half-Sheet-Oberfläche in einer App angezeigt werden kann, müssen folgende Voraussetzungen erfüllt sein:

  • Die Google Play-Version muss mindestens 40.4 sein.
  • Das Android API-Level muss 24 oder höher sein.

Inline-Installationen über eine App aufrufen

Wenn du die Half-Sheet-Oberfläche für Inline-Installationen über eine App aufrufen möchtest, erstelle eine Instanz der Intent Klasse, die eine Deeplink URL öffnet. Verwende den folgenden Beispielcode (Kotlin oder Java) als Richtlinie.

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

Inline Install API-Parameter

Feld Beschreibung Erforderlich
referrer Optionaler Referrer-Tracking -String Nein
id Paketname der App, die installiert werden soll Ja
overlay Auf true setzen, wenn eine Inline-Half-Sheet-Oberfläche angefordert wird. Bei false wird über den Intent ein Deeplink zu Google Play erstellt. Ja
callerId Paketname der aufrufenden App Ja
listing Optionaler Parameter, um das Ziel für einen benutzerdefinierten Store Eintrag anzugeben Nein

Wenn die Half-Sheet-Oberfläche für Inline-Installationen von Google Play nicht angezeigt wird, wird stattdessen ein direkter Deeplink zum Google Play-Eintrag erstellt.