Google Play 內嵌安裝 (應用程式)

本頁面說明應用程式開發人員如何整合內嵌安裝功能，這是 Google Play 的新測試功能，可在半頁面介面中顯示 Google Play 應用程式產品詳細資料。內嵌安裝功能可讓使用者不必離開應用程式情境，就能體驗流暢的應用程式安裝流程。應用程式開發人員可以為透過 Play 發行或更新的應用程式，整合及測試內嵌安裝功能。

需求條件

如要在應用程式中顯示半頁面介面：

• 最低 Google Play 版本必須為 40.4。
• Android API 級別必須為 23 以上。

從應用程式叫用內嵌安裝

如要從應用程式叫用內嵌安裝半頁，請建立 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.
}

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

內嵌安裝 API 參數

欄位	說明	必填
referrer	選用的參照網址追蹤字串	否
id	要安裝的應用程式 套件名稱	是
overlay	如果要求內嵌半頁，請設為 true；如果是 false，意圖會連結至 Google Play	是
callerId	呼叫端應用程式的 套件名稱	是
listing	指定自訂商店資訊目標的選用參數	否

如果應用程式安裝流程未顯示 Google Play 內嵌安裝半頁面介面，系統會改為顯示 Google Play 資訊清單的直接連結 (深層連結)。