Play इंस्टॉल की रेफ़रर लाइब्रेरी

सुरक्षित तरीके से डेटा वापस पाने के लिए, Google Play Store के इंस्टॉल रेफ़रर एपीआई का इस्तेमाल करें रेफ़रल कॉन्टेंट को ऑप्टिमाइज़ करता है. Play इंस्टॉल रेफ़रर एपीआई क्लाइंट लाइब्रेरी जावा प्रोग्रामिंग भाषा में लिखी गई है और Android के लिए रैपर है इंटरफ़ेस डेफ़िनिशन लैंग्वेज (एआईडीएल) की फ़ाइल, जो रेफ़रर सेवा इंस्टॉल करें. आपके पास Play इंस्टॉल रेफ़रर एपीआई क्लाइंट का इस्तेमाल करने का विकल्प है लाइब्रेरी से अपने डेवलपमेंट की प्रोसेस को आसान बनाएं.

इस गाइड में Google से रेफ़रल की जानकारी वापस पाने का बुनियादी तरीका बताया गया है Play इंस्टॉल की रेफ़रल देने वाली लाइब्रेरी का इस्तेमाल करके चलाएं.

ऐप्लिकेशन की डिपेंडेंसी अपडेट करना

build.gradle फ़ाइल के डिपेंडेंसी सेक्शन में इस लाइन को जोड़ें आपके ऐप्लिकेशन के लिए:

ग्रूवी

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

Kotlin

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

Google Play से कनेक्ट किया जा रहा है

Playइंस्टॉल रेफ़रर एपीआई लाइब्रेरी का इस्तेमाल करने से पहले, आपको ये काम करने होंगे इनका इस्तेमाल करके Play Store ऐप्लिकेशन से कनेक्शन बनाएं चरण:

  1. कॉल करें newBuilder() का इंस्टेंस बनाने का तरीका InstallReferrerClient क्लास.

  2. कॉल करें startConnection() Google Play से कनेक्ट करने के लिए.

  3. startConnection() विधि एसिंक्रोनस है, इसलिए आपको InstallReferrerStateListener इसके बाद कॉलबैक पाने के लिए startConnection() पूरा करता है.

  4. onInstallReferrerSetupFinished() को बदलें कॉलबैक पूरा होने पर सूचना पाने का तरीका. इस तरीके को कहते हैं का इस्तेमाल करें. OK दिखाता है कि कनेक्शन पूरा हुआ. सभी अन्य InstallReferrerResponse कॉन्सटेंट अलग-अलग तरह की गड़बड़ियों के लिए होते हैं.

  5. onInstallReferrerServiceDisconnected() को बदलें का तरीका चुनें. इसके लिए उदाहरण के लिए, Play इंस्टॉल रेफ़रर लाइब्रेरी क्लाइंट का कनेक्शन टूट सकता है, अगर Play Store सेवा बैकग्राउंड में अपडेट हो रही है. लाइब्रेरी क्लाइंट को कॉल करना होगा यह 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.
    }
})

Java

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. सिंक किए गए वर्शन का इस्तेमाल करें getInstallReferrer() का इंस्टेंस लौटाने का तरीका ReferrerDetails.

  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

Java

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

चेतावनी: इंस्टॉल रेफ़रर जानकारी यह ऑफ़र 90 दिनों के लिए उपलब्ध रहेगा. साथ ही, इसमें यह बदलाव नहीं होगा जब तक कि आवेदन फिर से इंस्टॉल किया गया. अपने ऐप्लिकेशन में ग़ैर-ज़रूरी एपीआई कॉल से बचने के लिए, इंस्टॉल करने के बाद पहली बार एक्ज़ीक्यूट करने के दौरान, एपीआई सिर्फ़ एक बार.

सेवा कनेक्शन बंद किया जा रहा है

रेफ़रलकर्ता की जानकारी मिलने के बाद, endConnection() तरीका अपनाया जा सकता है InstallReferrerClient इंस्टेंस बंद करने के लिए कहा जाता है. कनेक्शन बंद करने से आपको समस्या दूर करने में मदद मिलेगी और परफ़ॉर्मेंस से जुड़ी समस्याएं होती हैं.

ज़्यादा जानकारी के लिए, Play इंस्टॉल की रेफ़रल देने वाली लाइब्रेरी देखें रेफ़रंस.