عمليات التثبيت المضمَّنة في Google Play (التطبيقات)

توضّح هذه الصفحة كيفية دمج مطوّري التطبيقات ميزة التثبيت المضمّن، وهي ميزة اختبارية جديدة في Google Play تعرض تفاصيل منتجات تطبيقات Google Play في واجهة نصف ورقة. تتيح ميزة "التثبيت المضمّن" للمستخدمين تجربة عملية تثبيت سلسة للتطبيقات بدون مغادرة سياق التطبيق. ويمكن لمطوّري التطبيقات دمج ميزة "التثبيت المضمّن" واختبارها للتطبيقات التي يتم توزيعها أو تحديثها على Play.

المتطلبات

لكي تظهر واجهة "نصف الشاشة" في أحد التطبيقات، يجب استيفاء الشروط التالية:

  • يجب أن يكون الحد الأدنى لإصدار Google Play هو 40.4.
  • يجب أن يكون المستوى لواجهة برمجة التطبيقات في 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.
}

مَعلمات واجهة برمجة التطبيقات للتثبيت المضمّن

الحقل الوصف مطلوب
referrer سلسلة تتبُّع المُحيل اختيارية لا
id اسم الحزمة للتطبيق المطلوب تثبيته نعم
overlay اضبط القيمة على true إذا تم طلب نصف لوحة مضمّنة. إذا كانت القيمة هي false، سيؤدي الإجراء إلى إنشاء روابط لصفحات في التطبيق تؤدي إلى Google Play. نعم
callerId اسم حزمة تطبيق المتصل نعم
listing مَعلمة اختيارية لتحديد الاستهداف لبطاقة بيانات متجر مخصّصة لا

إذا لم تعرض عملية تثبيت التطبيق واجهة النصف صف تثبيت التطبيق المضمّن في Google Play، يتم بدلاً من ذلك عرض رابط مباشر (رابط لصفحة معيّنة) يؤدي إلى بطاقة بيانات التطبيق على Google Play.