การติดตั้งในบรรทัดของ Google Play (App Store ของบุคคลที่สาม)

หน้านี้อธิบายวิธีที่ App Store ของบุคคลที่สามที่ลงทะเบียนเข้าร่วมโปรแกรมการเข้าถึงแคตตาล็อก สามารถผสานรวมการติดตั้งในบรรทัดของ Google Play ซึ่งเป็นฟีเจอร์ที่อนุญาตให้ Android App Store ของบุคคลที่สามในสหรัฐอเมริกา นำผู้ใช้ไปยังการดาวน์โหลดแอป Android ของ Google Play ผ่าน Google Play โดยมีข้อกำหนดเดียวกันกับการดาวน์โหลดอื่นๆ ที่ดำเนินการผ่าน Google Play Store โดยตรง

สิ่งที่ต้องมีก่อน

ก่อนผสานรวม API การติดตั้งจากในหน้าเว็บใน App Store ของบุคคลที่สาม คุณต้องตั้งค่าต่อไปนี้ใน Google Play Console ให้เสร็จสมบูรณ์

1. ลงทะเบียนเข้าร่วมโปรแกรมการเข้าถึงแคตตาล็อกของ Google Play: ทำตามวิธีการลงทะเบียน
2. เลือกใช้การเข้าถึงแคตตาล็อก: ลงทะเบียนเข้าร่วมโปรแกรมการเข้าถึงแคตตาล็อกผ่านการตั้งค่า Play Console
3. ดึงโทเค็นการนำส่ง: ประมวลผลการส่งออกแคตตาล็อกแอป Play ที่เรามอบให้คุณ การส่งออกนี้มี catalog_token (โทเค็นการนำส่ง) ที่จำเป็นสำหรับ แต่ละแอปที่คุณมีสิทธิ์เผยแพร่

ข้อกำหนด

อินเทอร์เฟซชีตครึ่งหน้าจะแสดงต่อผู้ใช้ได้สำเร็จก็ต่อเมื่อเป็นไปตามข้อกำหนดต่อไปนี้

• ผู้ใช้ต้องอยู่ในสหรัฐอเมริกา
• อุปกรณ์ต้องใช้ Google Play เวอร์ชัน 52.3 ขึ้นไป
• API ระดับของ Android ต้องเป็น24 ขึ้นไป
• คุณต้องระบุ catalog_token ที่ถูกต้องและยังไม่หมดอายุเพื่อเข้าถึง Play Store

เรียกใช้การติดตั้งแบบอินไลน์จาก App Store

หากต้องการเรียกใช้ชีตครึ่งหน้าสำหรับการติดตั้งในบรรทัด ให้สร้างอินสแตนซ์ของคลาส Intent ที่กำหนดเป้าหมายเป็น URL ของ Deep Link ของ Google Play และมี catalog_token ที่ไม่ซ้ำกัน

ใช้โค้ดตัวอย่างต่อไปนี้ (Kotlin หรือ Java) เป็นแนวทาง

val intent = Intent(Intent.ACTION_VIEW)
val referrer = "<Your referrer string>"
val id = "<Package name of the app to be installed>"
val callerId = "<Package name of your third-party app store>"

// Retrieve the app-specific token from your processed catalog export
val catalogToken = getVerificationTokenByDocId(id)

intent.setPackage("com.android.vending")
val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer"
intent.data = Uri.parse(deepLinkUrl)

// Set the required intent extras
intent.putExtra("overlay", true)
intent.putExtra("callerId", callerId)
intent.putExtra("catalog_token", catalogToken)

val packageManager = context.getPackageManager()
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0) // Call with a request code to receive ActivityResults
}

Intent intent = new Intent(Intent.ACTION_VIEW);
String referrer = "<Your referrer string>";
String id = "<Package name of the app to be installed>";
String callerId = "<Package name of your third-party app store>";

// Retrieve the app-specific token from your processed catalog export
byte[] catalogToken = getVerificationTokenByDocId(id);

intent.setPackage("com.android.vending");
String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer;
intent.setData(Uri.parse(deepLinkUrl));

// Set the required intent extras
intent.putExtra("overlay", true);
intent.putExtra("callerId", callerId);
intent.putExtra("catalog_token", catalogToken);

PackageManager packageManager = context.getPackageManager();
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0); // Call with a request code to receive ActivityResults
}

พารามิเตอร์ API การติดตั้งจากในหน้าเว็บ

ต้องส่งพารามิเตอร์ต่อไปนี้ใน URL ของ Intent หรือเป็น Intent Extras เพื่อให้สิทธิ์การติดตั้งในบรรทัด

(ไม่บังคับ) การติดตั้งจากในหน้าเว็บของ Google Play พร้อมภาพซ้อนทับสถานะการติดตั้ง

หากต้องการแสดงภาพซ้อนทับสถานะการติดตั้งด้วยขั้นตอนการติดตั้งจากในหน้าเว็บ คุณจะต้องผสานรวมการติดตั้งจากในหน้าเว็บของ Google Play กับฟีเจอร์ความสามารถในการใช้งานแบบถาวรโดยใช้ Google Play HSDP SDK

ขั้นตอนการติดตั้งจากในหน้าเว็บพร้อมการช่วยให้เข้าถึงได้แบบถาวรมีดังนี้

• อุปกรณ์เป้าหมายต้องมี Google Play Store เวอร์ชัน 52.5 ขึ้นไป
• ระดับ API ของ Android ต้องเป็น 24 (Android M) ขึ้นไป
• ผสานรวมกับ HSDP SDK เวอร์ชัน 2.0.2 (เร็วๆ นี้) ขึ้นไป

ตัวอย่างการผสานรวม

// Step 1: Initialize HSDP Service
// Note: Calling create(activity) automatically configures useServiceBasedHsdp = false
// (Activity Path) under the hood without requiring manual boolean flags.
val hsdpService = HsdpDeepLinkServiceFactory.create(activity)

// Step 2: Construct Extra Query Parameters with Catalog Token
val extraQueryParams = mapOf("catalog_token" to "YOUR_SECURE_CATALOG_TOKEN_VALUE")

// Step 3: Trigger Inline Install Flow
hsdpService.open(
    targetAppPackageName = "com.example.targetapp",
    referrer = "3pas_ad_campaign_123",
    listener = object : HsdpDeepLinkServiceListener {
        override fun onDeepLinkStarted() {
            // Inline details dialog started successfully
        }
        override fun onAffordanceStarted() {
            // HPOA persistent affordance UI attached
        }
        override fun onAffordanceEnded() {
            // Affordance UI detached
        }
        override fun onError(errorMessage: String) {
            // Handle error or fallback
        }
    },
    extraQueryParams = extraQueryParams
)

ตัวอย่างการหยุดติดตามความสามารถในการโต้ตอบ

อนุญาตให้แอปที่เรียกใช้หยุดติดตามสถานะการติดตั้งและปิดการวางซ้อน HPOA ด้วยตนเอง หมายเหตุ: การดำเนินการนี้จะไม่ปิดชีตการติดตั้ง HSDP แต่จะปิดเฉพาะ การแสดงผล

// Stop tracking the installation state and dismiss the affordance overlay
hsdpService.stopAffordance(
    targetAppPackageName = "com.example.targetapp",
    listener = object : HsdpDeepLinkService.AffordanceListener {
        override fun onAffordanceStopped() {
            // Affordance overlay stopped successfully
        }
    }
)

สถานะความสามารถในการรับรู้และ UX

ฟีเจอร์การติดตั้งในหน้าบน Google Play พร้อมการแสดงคำแนะนำแบบถาวรมีสถานะเป็นภาพ 2 แบบ ดังนี้

1. สถานะการติดตั้ง: แสดงภาพขนาดย่อของแอปเป้าหมายและวงกลมแสดงความคืบหน้าในการติดตั้ง การคลิกภาพปกจะเปิดชีตการติดตั้ง HSDP อีกครั้ง
2. สถานะหลังการติดตั้ง: แสดงไอคอนแอปเป้าหมายพร้อมการกระทำ "เปิด" การคลิกภาพขนาดย่อจะเปิดแอปที่เพิ่งติดตั้ง

การติดตั้ง	หลังการติดตั้ง