রেফারার লাইব্রেরি ইনস্টল করুন

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

এই নির্দেশিকাটি Play Install Referrer Library ব্যবহার করে Google Play থেকে রেফারেল তথ্য পুনরুদ্ধারের মূল বিষয়গুলি কভার করে৷

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

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

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

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 Install Referrer Library ক্লায়েন্ট সংযোগ হারাতে পারে। লাইব্রেরি ক্লায়েন্টকে আরও অনুরোধ করার আগে সংযোগ পুনরায় চালু করতে startConnection() পদ্ধতিতে কল করতে হবে।

নিম্নলিখিত কোডটি দেখায় কিভাবে প্লে স্টোর অ্যাপে একটি সংযোগ শুরু এবং পরীক্ষা করতে হয়:

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.
    }
});

ইন্সটল রেফার করা হচ্ছে

আপনি প্লে স্টোর অ্যাপে একটি সংযোগ স্থাপন করার পরে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করে ইনস্টল রেফারারের কাছ থেকে বিশদটি পান:

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

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

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

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();

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

পরিষেবা সংযোগ বন্ধ করা হচ্ছে

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

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