התקנות מוטמעות ב-Google Play (אפליקציות)

בדף הזה נסביר למפתחי אפליקציות איך לשלב התקנה מהאתר, תכונה חדשה לבדיקה ב-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.