Play Install Referrer Library

Google Play থেকে রেফারেল কন্টেন্ট নিরাপদে ফিরিয়ে আনতে আপনি Google Play Store-এর ইনস্টল রেফারার API ব্যবহার করতে পারবেন। Play Install Referrer API ক্লায়েন্ট লাইব্রেরি Java প্রোগ্রামিং ল্যাঙ্গুয়েজে লেখা এবং এটি Android ইন্টারফেস ডেফিনিশন ল্যাঙ্গুয়েজ (AIDL) ফাইলের একটি র‍্যাপার যা Install Referrer পরিষেবার ইন্টারফেসকে সংজ্ঞায়িত করে। আপনার ডেভেলপমেন্ট প্রসেস সহজ করতে Play Install Referrer API ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন।

এই গাইডে Play Install Referrer লাইব্রেরি ব্যবহার করে Google Play থেকে রেফারেল তথ্য পাওয়ার প্রাথমিক বিষয়গুলি কভার করা হয়েছে।

আপনার অ্যাপের ডিপেন্ডেন্সি আপডেট করা হচ্ছে

আপনার অ্যাপের জন্য build.gradle ফাইলের ডিপেন্ডেন্সি বিভাগে নিম্নলিখিত লাইন যোগ করুন:

গ্ৰুভি

dependencies {
    ...
    implementation "com.android.installreferrer:installreferrer:2.2"
}

Kotlin

dependencies {
    ...
    implementation("com.android.installreferrer:installreferrer:2.2")
}

Google Play-তে কানেক্ট করা হচ্ছে

Play Install Referrer API লাইব্রেরি ব্যবহার করার আগে, আপনাকে নিম্নলিখিত ধাপগুলি ব্যবহার করে Play Store অ্যাপের সাথে একটি কানেকশন স্থাপন করতে হবে:

  1. InstallReferrerClient ক্লাসের ইনস্ট্যান্স তৈরি করতে newBuilder() মেথড কল করুন।

  2. Google Play-এর সাথে কানেকশন তৈরি করতে startConnection() কল করুন।

  3. startConnection() পদ্ধতিটি অ্যাসিঙ্ক্রোনাস, তাই startConnection() সম্পূর্ণ হওয়ার পরে কলব্যাক পেতে আপনাকে অবশ্যই InstallReferrerStateListener ওভাররাইড করতে হবে।

  4. কলব্যাক সম্পূর্ণ হলে বিজ্ঞপ্তি পেতে onInstallReferrerSetupFinished() পদ্ধতি ওভাররাইড করুন। এই পদ্ধতিটি একটি রেসপন্স কোড সহ কল করা হয় যা আপনাকে বিভিন্ন অবস্থা ম্যানেজ করতে ব্যবহার করতে হবে। OK বোঝায় যে কানেকশন সফল হয়েছে। অন্যান্য InstallReferrerResponse কনস্ট্যান্টের প্রতিটি আলাদা আলাদা ধরনের সমস্যার জন্য।

  5. Google Play-এর সাথে কানেকশন বিচ্ছিন্ন হয়ে গেলে তা ম্যানেজ করতে onInstallReferrerServiceDisconnected() পদ্ধতি ওভাররাইড করুন। যেমন, ব্যাকগ্রাউন্ডে Play Store পরিষেবা আপডেট করা হলে, Play Install Referrer Library ক্লায়েন্ট কানেকশন হারিয়ে ফেলতে পারে। আরও অনুরোধ করার আগে কানেকশন রিস্টার্ট করতে লাইব্রেরি ক্লায়েন্টকে অবশ্যই startConnection() মেথড কল করতে হবে।

Play Store অ্যাপের সাথে কীভাবে কানেকশন শুরু ও পরীক্ষা করতে হয় তা নিম্নলিখিত কোড থেকে জানতে পারবেন:

Kotlin

private lateinit var referrerClient: InstallReferrerClient

referrerClient = InstallReferrerClient.newBuilder(this).build()
referrerClient.startConnection(object : InstallReferrerStateListener {

    override fun onInstallReferrerSetupFinished(responseCode: Int) {
        when (responseCode) {
            InstallReferrerResponse.OK -> {
                // Connection established.
            }
            InstallReferrerResponse.FEATURE_NOT_SUPPORTED -> {
                // API not available on the current Play Store app.
            }
            InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
                // Connection couldn't be established.
            }
        }
    }

    override fun onInstallReferrerServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
})

জাভা

InstallReferrerClient referrerClient;

referrerClient = InstallReferrerClient.newBuilder(this).build();
referrerClient.startConnection(new InstallReferrerStateListener() {
    @Override
    public void onInstallReferrerSetupFinished(int responseCode) {
        switch (responseCode) {
            case InstallReferrerResponse.OK:
                // Connection established.
                break;
            case InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                // API not available on the current Play Store app.
                break;
            case InstallReferrerResponse.SERVICE_UNAVAILABLE:
                // Connection couldn't be established.
                break;
        }
    }

    @Override
    public void onInstallReferrerServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
});

ইনস্টল রেফারার পাওয়া

Play Store অ্যাপের সাথে কানেকশন তৈরি করার পরে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করে ইনস্টল রেফারার থেকে বিবরণ পান:

  1. ReferrerDetails-এর ইনস্ট্যান্স ফিরিয়ে আনতে getInstallReferrer() সিঙ্ক্রোনাইজ করা পদ্ধতি ব্যবহার করুন।

  2. ইনস্টল রেফারার সম্পর্কে বিবরণ পেতে ReferrerDetails ক্লাস যেসব পদ্ধতি প্রদান করে সেগুলি ব্যবহার করুন।

নিম্নলিখিত কোড থেকে আপনি জানতে পারবেন যে কীভাবে ইনস্টল রেফারার সংক্রান্ত তথ্য অ্যাক্সেস করতে পারবেন:

Kotlin

val response: ReferrerDetails = referrerClient.installReferrer
val referrerUrl: String = response.installReferrer
val referrerClickTime: Long = response.referrerClickTimestampSeconds
val appInstallTime: Long = response.installBeginTimestampSeconds
val instantExperienceLaunched: Boolean = response.googlePlayInstantParam

জাভা

ReferrerDetails response = referrerClient.getInstallReferrer();
String referrerUrl = response.getInstallReferrer();
long referrerClickTime = response.getReferrerClickTimestampSeconds();
long appInstallTime = response.getInstallBeginTimestampSeconds();
boolean instantExperienceLaunched = response.getGooglePlayInstantParam();

সতর্কতা: ইনস্টল রেফারার তথ্য ৯০ দিনের জন্য উপলভ্য থাকবে এবং অ্যাপ্লিকেশনটি আবার ইনস্টল না করা পর্যন্ত পরিবর্তন হবে না। আপনার অ্যাপে অপ্রয়োজনীয় API কল এড়াতে, ইনস্টল করার পরে প্রথমবার এক্সিকিউট করার সময় API শুধুমাত্র একবার ইনভোক করা উচিত।

পরিষেবার কানেকশন বন্ধ করা হচ্ছে

রেফারারের তথ্য পাওয়ার পরে, কানেকশন বন্ধ করতে আপনার InstallReferrerClient ইনস্ট্যান্সে endConnection() মেথড কল করুন। কানেকশন বন্ধ করে দিলে, আপনি লিক ও পারফর্ম্যান্স সংক্রান্ত সমস্যা এড়াতে পারবেন।

আরও তথ্যের জন্য, Play Install Referrer লাইব্রেরি রেফারেন্স দেখুন।