בדף הזה נסביר למפתחי אפליקציות איך לשלב התקנה מהאתר, תכונה חדשה לבדיקה ב-Google Play שמציגה את פרטי המוצר של האפליקציה ב-Google Play בממשק של חצי דף. התקנה בתוך הטקסט מאפשרת למשתמשים ליהנות מתהליך התקנה חלק של האפליקציה בלי לצאת מההקשר של האפליקציה. מפתחי אפליקציות יכולים לשלב ולבדוק את התכונה 'התקנה בתוך הטקסט' באפליקציות שפורסמו או עודכנו ב-Play.
הדרישות
כדי שהממשק של חצי גיליון יופיע באפליקציה:
- הגרסה המינימלית של Google Play צריכה להיות 40.4.
- רמת ה-API של Android צריכה להיות 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.