การติดตั้งในบรรทัด Google Play (แอป)

หน้านี้จะอธิบายวิธีที่นักพัฒนาแอปผสานรวมการติดตั้งจากในหน้าเว็บ ซึ่งเป็นฟีเจอร์ทดสอบใหม่สำหรับ Google Play ที่แสดงรายละเอียดผลิตภัณฑ์แอป Google Play ในอินเทอร์เฟซแบบครึ่งหน้า การติดตั้งในบรรทัดช่วยให้ผู้ใช้ได้รับประสบการณ์การติดตั้งแอปที่ราบรื่นโดยไม่ต้องออกจากบริบทของแอป นักพัฒนาแอปสามารถผสานรวมและทดสอบฟีเจอร์การติดตั้งในบรรทัดสำหรับแอปที่เผยแพร่หรืออัปเดตใน Play

ข้อกำหนด

วิธีทำให้อินเทอร์เฟซแบบครึ่งหน้าจอปรากฏในแอป

  • เวอร์ชัน Google Play ขั้นต่ำต้องเป็น 40.4
  • ระดับ API ของ Android ต้องเท่ากับ 23 ขึ้นไป

เรียกใช้การติดตั้งในหน้าเว็บจากแอป

หากต้องการเรียกใช้ครึ่งหน้าการติดตั้งในบรรทัดจากแอป ให้สร้างอินสแตนซ์ของคลาส Intent ซึ่งจะเปิด URL ของ Deep Link ใช้โค้ดตัวอย่างต่อไปนี้ (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 สตริงการติดตาม referrer ที่ไม่บังคับ ไม่
id ชื่อแพ็กเกจของแอปที่จะติดตั้ง ใช่
overlay ตั้งค่าเป็น true หากมีการขอครึ่งหน้าในบรรทัด หากเป็น false แสดงว่า Intent จะลิงก์ไปยัง Google Play ใช่
callerId ชื่อแพ็กเกจของแอปที่โทรเข้ามา ใช่
listing พารามิเตอร์ที่ไม่บังคับเพื่อระบุเป้าหมายสำหรับข้อมูลผลิตภัณฑ์ใน Store ที่กําหนดเอง ไม่

หากขั้นตอนการติดตั้งแอปไม่แสดงอินเทอร์เฟซชีตครึ่งหน้าสำหรับการติดตั้งในบรรทัดของ Google Play ระบบจะแสดง Deep Link ไปยังข้อมูลผลิตภัณฑ์ใน Google Play โดยตรงแทน