このページでは、アプリ デベロッパーが インライン インストールを統合する方法について説明します。インライン インストールは、Google Play アプリの商品の詳細をハーフシート インターフェースに表示する Google Play の新しいテスト機能です。インライン インストールを使用すると、ユーザーはアプリのコンテキストを離れることなく、シームレスなアプリ インストール フローを体験できます。アプリ デベロッパーは、Google Play で配信または更新されるアプリにインライン インストール機能を統合してテストできます。
要件
アプリにハーフシート インターフェースを表示するには:
- Google Play の最小バージョンは 40.4 です。
- Android API レベルは 23 以上であることが必要です。
アプリからインライン インストールを呼び出す
アプリからインライン インストール ハーフシートを呼び出すには、Intent
クラスのインスタンスを作成します。これにより、ディープリンクの URL が開きます。次のサンプルコード(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 の掲載情報への直接リンク(ディープリンク)が表示されます。