এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

গুগল প্লে ইনলাইন ইনস্টল (তৃতীয় পক্ষের অ্যাপ স্টোর)

এই পৃষ্ঠায় বর্ণনা করা হয়েছে যে, ক্যাটালগ অ্যাক্সেস প্রোগ্রামে নথিভুক্ত থার্ড-পার্টি অ্যাপ স্টোরগুলো কীভাবে গুগল প্লে ইনলাইন ইনস্টল সুবিধাটি সংহত করতে পারে। এই সুবিধাটি থার্ড-পার্টি ইউএস অ্যান্ড্রয়েড অ্যাপ স্টোরগুলোকে ব্যবহারকারীদেরকে গুগল প্লে স্টোর থেকে সরাসরি করা অন্য যেকোনো ডাউনলোডের মতোই একই শর্তে গুগল প্লে-এর মাধ্যমে প্লে-এর অ্যাপ ডাউনলোড করার জন্য নির্দেশ দিতে সক্ষম করে।

পূর্বশর্ত

আপনার থার্ড-পার্টি অ্যাপ স্টোরে ইনলাইন ইনস্টল এপিআই ইন্টিগ্রেট করার আগে, আপনাকে অবশ্যই গুগল প্লে কনসোলে নিম্নলিখিত সেটআপটি সম্পন্ন করতে হবে:

প্লে ক্যাটালগ অ্যাক্সেস প্রোগ্রামে নথিভুক্ত হন: নথিভুক্তির নির্দেশাবলী অনুসরণ করুন।
ক্যাটালগ অ্যাক্সেসে অংশগ্রহণ করুন: আপনার প্লে কনসোল সেটিংসের মাধ্যমে ক্যাটালগ অ্যাক্সেস প্রোগ্রামে নথিভুক্ত হন।
ডেলিভারি টোকেন সংগ্রহ করুন: আপনাকে দেওয়া প্লে অ্যাপ ক্যাটালগ এক্সপোর্টটি প্রসেস করুন। এই এক্সপোর্টে আপনার বিতরণের যোগ্য প্রতিটি অ্যাপের জন্য প্রয়োজনীয় catalog_token (ডেলিভারি টোকেন) রয়েছে।

প্রয়োজনীয়তা

ব্যবহারকারীদের কাছে হাফ-শিট ইন্টারফেসটি সফলভাবে প্রদর্শিত হওয়ার জন্য নিম্নলিখিত শর্তগুলো অবশ্যই পূরণ করতে হবে:

ব্যবহারকারীকে অবশ্যই মার্কিন যুক্তরাষ্ট্রে অবস্থান করতে হবে।
ডিভাইসটিতে গুগল প্লে-এর সর্বনিম্ন সংস্করণ অবশ্যই ৫২.৩ হতে হবে।
অ্যান্ড্রয়েড এপিআই লেভেল অবশ্যই ২৪ বা তার বেশি হতে হবে।
প্লে স্টোরে প্রবেশের জন্য আপনাকে অবশ্যই একটি বৈধ ও মেয়াদোত্তীর্ণ নয় এমন catalog_token প্রদান করতে হবে।

আপনার অ্যাপ স্টোর থেকে ইনলাইন ইনস্টল চালু করুন

ইনলাইন ইনস্টল হাফ-শীটটি চালু করতে, Intent ক্লাসের এমন একটি ইনস্ট্যান্স তৈরি করুন যা Google Play ডিপ লিঙ্ক URL-কে টার্গেট করে এবং এতে আপনার অনন্য catalog_token অন্তর্ভুক্ত থাকে।

নির্দেশিকা হিসেবে নিম্নলিখিত নমুনা কোডটি (কোটলিন বা জাভা) ব্যবহার করুন:

কোটলিন

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
}

ইনলাইন ইনস্টল এপিআই প্যারামিটার

ইনলাইন ইনস্টল অনুমোদন করার জন্য নিম্নলিখিত প্যারামিটারগুলো আপনার Intent URL-এ অথবা Intent Extras হিসেবে অবশ্যই পাস করতে হবে:

মাঠ	অবস্থান	বর্ণনা	প্রয়োজনীয়
`id`	ইউআরএল কোয়েরি	যে অ্যাপটি ইনস্টল করা হবে, তার প্যাকেজ নাম।	হ্যাঁ
`referrer`	ইউআরএল কোয়েরি	একটি ঐচ্ছিক রেফারার ট্র্যাকিং স্ট্রিং।	না
`overlay`	উদ্দেশ্য অতিরিক্ত	ইনলাইন হাফ-শিট ইন্টারফেসের অনুরোধ করতে এটিকে ' `true` তে সেট করুন।	হ্যাঁ
`callerId`	উদ্দেশ্য অতিরিক্ত	আপনার অনুমোদিত তৃতীয় পক্ষের অ্যাপ স্টোরের প্যাকেজ নাম।	হ্যাঁ
`catalog_token`	উদ্দেশ্য অতিরিক্ত	আপনার ক্যাটালগ অ্যাক্সেস এক্সপোর্টে প্রদত্ত অনন্য ডেলিভারি টোকেন। দ্রষ্টব্য: টোকেনগুলো সতেজতা, টার্গেট প্যাকেজের সাথে মিল এবং কলার প্যাকেজের সাথে মিলের জন্য যাচাই করা হয়।	হ্যাঁ

(ঐচ্ছিক) ইনস্টলেশন স্ট্যাটাস ওভারলে সহ গুগল প্লে ইনলাইন ইনস্টল

ইনলাইন ইনস্টল ফ্লো-এর সাথে ইনস্টলেশন স্ট্যাটাস ওভারলে দেখানোর জন্য, আপনাকে গুগল প্লে এইচএসডিপি এসডিকে (Google Play HSDP SDK) ব্যবহার করে পার্সিস্টেন্ট অ্যাফোর্ডেন্স (Persistent Affordance) ফিচারের সাথে গুগল প্লে ইনলাইন ইনস্টল (Google Play Inline Install) ইন্টিগ্রেট করতে হবে।

স্থায়ী অ্যাফোর্ডেন্স সহ ইনলাইন ইনস্টল ফ্লো প্রদর্শিত হওয়ার জন্য:

টার্গেট ডিভাইসটির গুগল প্লে স্টোর ভার্সন সর্বনিম্ন ৫২.৫ বা তার বেশি হতে হবে।
অ্যান্ড্রয়েড এপিআই লেভেল অবশ্যই ২৪ (অ্যান্ড্রয়েড এম) বা তার বেশি হতে হবে।
HSDP SDK-এর ২.০.২ (শীঘ্রই আসছে) বা উচ্চতর সংস্করণের সাথে একীভূত করুন।

একীকরণের উদাহরণ

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

অ্যাফোর্ডেন্স স্টেট এবং ইউএক্স

পার্সিস্টেন্ট অ্যাফোর্ডেন্স ফিচারসহ গুগল প্লে ইনলাইন ইনস্টলের দুটি ভিজ্যুয়াল অবস্থা রয়েছে:

ইনস্টলেশন অবস্থা : লক্ষ্য অ্যাপটির একটি থাম্বনেইল এবং একটি ইনস্টলেশন অগ্রগতি স্পিনার প্রদর্শন করে। থাম্বনেইলে ক্লিক করলে HSDP ইনস্টল শীটটি পুনরায় চালু হয়।
ইনস্টলেশন-পরবর্তী অবস্থা : নির্দিষ্ট অ্যাপের আইকনটি একটি 'ওপেন' অ্যাকশন সহ প্রদর্শন করে। থাম্বনেইলে ক্লিক করলে নতুন ইনস্টল করা অ্যাপটি খুলে যায়।

ইনস্টল করা	ইনস্টলেশন পরবর্তী