Google Play की इनलाइन इंस्टॉल सुविधा (तीसरे पक्ष के ऐप्लिकेशन स्टोर)

इस पेज पर, Catalog Access program में रजिस्टर किए गए तीसरे पक्ष के ऐप्लिकेशन स्टोर के लिए, Google Play inline installs को इंटिग्रेट करने का तरीका बताया गया है. इस सुविधा की मदद से, अमेरिका में मौजूद तीसरे पक्ष के Android ऐप्लिकेशन स्टोर, उपयोगकर्ताओं को Google Play के ऐप्लिकेशन डाउनलोड करने के लिए डायरेक्ट कर सकते हैं. इसके लिए, वही शर्तें लागू होंगी जो Google Play Store से सीधे तौर पर किए जाने वाले किसी भी अन्य डाउनलोड के लिए होती हैं.

ज़रूरी शर्तें

अपने तीसरे पक्ष के ऐप्लिकेशन स्टोर में inline install API को इंटिग्रेट करने से पहले, आपको Google Play Console में यह सेटअप पूरा करना होगा:

1. Play Catalog Access Program में रजिस्टर करें: रजिस्टर करने के निर्देशों का पालन करें.
2. Catalog Access प्रोग्राम में शामिल हों: Play Console की सेटिंग में जाकर, Catalog Access Program में रजिस्टर करें.
3. डिलीवरी टोकन वापस पाएं: आपको दिए गए, Play ऐप्लिकेशन कैटलॉग के एक्सपोर्ट को प्रोसेस करें. इस एक्सपोर्ट में, डिस्ट्रिब्यूट किए जा सकने वाले हर ऐप्लिकेशन के लिए ज़रूरी catalog_token (डिलीवरी टोकन) शामिल होता है.

ज़रूरी शर्तें

हाफ़-शीट इंटरफ़ेस को उपयोगकर्ताओं के लिए दिखाने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

• उपयोगकर्ता अमेरिका में होना चाहिए.
• डिवाइस पर Google Play का कम से कम वर्शन 52.3 होना चाहिए.
• Android API का लेवल 24 या इससे ज़्यादा होना चाहिए.
• Play Store को ऐक्सेस करने के लिए, आपको मान्य और एक्सपायर न हुआ catalog_token देना होगा.

अपने ऐप्लिकेशन स्टोर से inline installs को लागू करना

inline install की हाफ़-शीट को लागू करने के लिए, Intent क्लास का कोई इंस्टेंस बनाएं. यह इंस्टेंस, 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
}

Inline install API के पैरामीटर

inline install को अनुमति देने के लिए, आपको अपने Intent यूआरएल में या Intent एक्स्ट्रा के तौर पर ये पैरामीटर पास करने होंगे:

(ज़रूरी नहीं) Google Play Inline Install के साथ, इंस्टॉल की स्थिति का ओवरले दिखाना

inline install के फ़्लो के साथ, इंस्टॉल की स्थिति का ओवरले दिखाने के लिए, आपको Google Play HSDP SDK का इस्तेमाल करके, Google Play Inline Install को Persistent Affordance सुविधा के साथ इंटिग्रेट करना होगा.

परसिस्टेंट अफ़ॉर्डेंस के साथ inline install का फ़्लो दिखाने के लिए:

• टारगेट किए गए डिवाइस पर Google Play Store का कम से कम वर्शन 52.6 या इससे ज़्यादा होना चाहिए.
• Android API का लेवल 24 (Android M) या इससे ज़्यादा होना चाहिए.
• HSDP SDK को 2.1.0 या इससे ज़्यादा वर्शन के साथ इंटिग्रेट करें.

इंटिग्रेशन का उदाहरण

// 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
        }
    }
)

अफ़ॉर्डेंस के स्टेटस और यूएक्स

Google Play Inline Install की सुविधा, परसिस्टेंट अफ़ॉर्डेंस के साथ दो विज़ुअल स्टेटस में दिखती है:

1. इंस्टॉल हो रहा है: इसमें टारगेट किए गए ऐप्लिकेशन का थंबनेल और इंस्टॉल की प्रोसेस दिखाने वाला स्पिनर दिखता है. थंबनेल पर क्लिक करने से, HSDP की इंस्टॉल शीट फिर से लॉन्च हो जाती है.
2. इंस्टॉल हो गया: इसमें टारगेट किए गए ऐप्लिकेशन का आइकॉन और "खोलें" बटन दिखता है. थंबनेल पर क्लिक करने से, नया इंस्टॉल किया गया ऐप्लिकेशन खुल जाता है.

इंस्टॉल हो रहा है	इंस्टॉल हो गया