उपयोगकर्ता आईडी - Android SDK

इस डेवलपर गाइड में Android v3.x के लिए Google Analytics SDK का इस्तेमाल करके User ID को लागू करने का तरीका बताया गया है.

खास जानकारी

User ID सुविधा की मदद से, Google Analytics में अलग-अलग डिवाइसों पर होने वाली उपयोगकर्ता गतिविधियों को मेज़र किया जा सकता है. जैसे, किसी मोबाइल डिवाइस पर मार्केटिंग कैंपेन के साथ हुए इंटरैक्शन को, दूसरे मोबाइल डिवाइस या ब्राउज़र में होने वाले कन्वर्ज़न को एट्रिब्यूट करना.

जब User ID को userId फ़ील्ड का उपयोग करके Google Analytics हिट के साथ भेजा जाता है, तो आपकी रिपोर्ट अद्वितीय उपयोगकर्ताओं की ज़्यादा सटीक संख्या दिखाएंगी और नए क्रॉस-डिवाइस रिपोर्टिंग विकल्प देंगी. यूज़र आईडी का इस्तेमाल करने के फ़ायदों के बारे में ज़्यादा जानें.

इस गाइड में, Google Analytics को User-ID भेजने के लिए, userId फ़ील्ड और Android के लिए Google Analytics SDK टूल को इस्तेमाल करने का तरीका बताया गया है.

ज़रूरी शर्तें

Google Analytics को User ID भेजने से पहले:

यूज़र आईडी सेट अप करें.
User ID नीति पढ़ें.
यूज़र आईडी की सुविधा के रेफ़रंस की समीक्षा करके जानें कि यूज़र आईडी कैसे काम करता है.

लागू करने का तरीका

जब कोई उपयोगकर्ता आपके Android ऐप्लिकेशन से पहले से मिल जाता है, तो आपको userId फ़ील्ड का इस्तेमाल करके पेज व्यू, इवेंट, ई-कॉमर्स लेन-देन वगैरह जैसे सभी Google Analytics हिट के साथ उस उपयोगकर्ता को दिखाने वाला एक आईडी भेजना चाहिए.

यूज़र आईडी भेजने के लिए, मेज़रमेंट प्रोटोकॉल एंपरसैंड सिंटैक्स और Fields.USER_ID पैरामीटर का नाम इस्तेमाल करके, userId फ़ील्ड सेट करें, जैसा कि इस उदाहरण में दिखाया गया है:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param User user represents a generic User object returned by an authentication system on sign in.
 */
public void onUserSignIn(User user) {

  Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  t.set(Fields.USER_ID, user.getId());

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  t.send(MapBuilder
      .createEvent("UX",       // Event category (required)
                   "Sign In",  // Event action (required)
                   null,       // Event label
                   null)       // Event value
      .build()
  );
}