इस दस्तावेज़ में, Play Install Referrer API का इस्तेमाल करने के लिए तकनीकी रेफ़रंस दिया गया है. Play Install Referrer API, मुख्य रूप से AIDL सेवा इंटरफ़ेस है. इसका इस्तेमाल, Java प्रोग्रामर के अलावा अन्य प्रोग्रामर भी करते हैं.
ध्यान दें: Play Install Referrer Library, Play Install Referrer API के लिए एक रैपर उपलब्ध कराती है. इसे Java प्रोग्रामर को एपीआई का इस्तेमाल करने में मदद करने के लिए डिज़ाइन किया गया है.
getInstallReferrer() तरीका
यह तरीका, Bundle (टेबल 1 में मैप की गई कुंजी) के ज़रिए भेजे गए दिए गए पैकेज के नाम से जुड़ी, ऐप्लिकेशन इंस्टॉल करने वाले रेफ़रर की जानकारी दिखाता है. Google Play से भेजे गए रिस्पॉन्स Bundle में, रेफ़रल की जानकारी उन फ़ील्ड में सेव की जाती है जिन्हें टेबल 2 में दी गई कुंजियों से मैप किया गया है.
टेबल 1. getInstallReferrer() बंडल का डेटा
अनुरोध.
| पैरामीटर | टाइप | ब्यौरा |
|---|---|---|
package_name
|
String
|
कॉल करने वाले व्यक्ति के ऐप्लिकेशन का पैकेज नाम. इसका इस्तेमाल, कॉलर की पहचान करने के लिए किया जाता है. |
टेबल 2. getInstallReferrer() के अनुरोध का जवाब देने वाला डेटा.
| सुरक्षा कुंजी | टाइप | ब्यौरा |
|---|---|---|
install_referrer
|
String
|
इंस्टॉल किए गए पैकेज का रेफ़रल यूआरएल. |
referrer_click_timestamp_seconds
|
long
|
रेफ़रर क्लिक होने का क्लाइंट-साइड टाइमस्टैंप, सेकंड में. |
install_begin_timestamp_seconds
|
long
|
ऐप्लिकेशन इंस्टॉल होने की शुरुआत का क्लाइंट-साइड टाइमस्टैंप, सेकंड में. |
referrer_click_timestamp_server_seconds
|
long
|
सर्वर-साइड टाइमस्टैंप, सेकंड में. यह टाइमस्टैंप, रेफ़रर क्लिक होने के समय का होता है. |
install_begin_timestamp_server_seconds
|
long
|
ऐप्लिकेशन इंस्टॉल होने की शुरुआत के समय का सर्वर-साइड टाइमस्टैंप, सेकंड में. |
install_version
|
string
|
ऐप्लिकेशन को पहली बार इंस्टॉल करने के समय उसका वर्शन. |
google_play_instant
|
boolean
|
इससे पता चलता है कि आपके ऐप्लिकेशन का इंस्टैंट वर्शन, पिछले सात दिनों में लॉन्च किया गया था या नहीं. |
चेतावनी: इंस्टॉल रेफ़रर की जानकारी 90 दिनों तक उपलब्ध रहेगी. ऐप्लिकेशन को फिर से इंस्टॉल किए जाने तक, यह जानकारी बदल नहीं होगी. अपने ऐप्लिकेशन में ग़ैर-ज़रूरी एपीआई कॉल से बचने के लिए, आपको इंस्टॉल करने के बाद पहली बार इस्तेमाल करने के दौरान, एपीआई को सिर्फ़ एक बार कॉल करना चाहिए.